Nachricht 'Broker Response'

Die Nachricht Broker Response (Antwort des Brokers) wird von einem Broker an die mit dem Parameter ReplyToQ angegebene Warteschlange für Antworten des Publishers oder des Subskribenten gesendet, um anzuzeigen, ob die vom Broker empfangene Befehlsnachricht erfolgreich ausgeführt wurde oder fehlgeschlagen ist, falls der Befehlsnachrichtendeskriptor angegeben hat, dass eine Nachricht erforderlich ist.

Die Antwortnachricht befindet sich im Feld NameValueData des MQRFH2-Headers in einem <pscr>-Ordner.

Im Falle einer Warnung ist in der Antwortnachricht der Ordner <psc> aus der Befehlsnachricht sowie der Ordner <pscr> enthalten. Falls Nachrichtendaten vorhanden sind, befinden sich diese nicht in der Antwortnachricht des Brokers. Falls ein Fehler auftritt, wurde keine der Nachrichten verarbeitet, durch die ein Fehler verursacht wurde. Bei einer Warnung wurden möglicherweise einige Nachrichten erfolgreich verarbeitet.

Beim Senden einer Antwort tritt ein Fehler auf:
  • Bei Veröffentlichungsnachrichten versucht der Broker, die Antwort an die Warteschlange für nicht zustellbare Nachrichten von WebSphere MQ zu senden, wenn der MQPUT-Aufruf fehlschlägt. Auf diese Weise kann die Veröffentlichung auch dann an Subskribenten gesendet werden, wenn an den Publisher keine Antwort zurückgesendet werden kann.
  • Bei anderen Nachrichten oder wenn die Veröffentlichungsantwort nicht an die Warteschlange für nicht zustellbare Nachrichten gesendet werden kann, wird ein Fehler protokolliert und normalerweise eine ROLLBACK-Operation für die Nachricht durchgeführt. Ob dies geschieht, ist von der Konfiguration des MQEmpfangsknotens abhängig.

Eigenschaften

<Completion> (MQPSCR_COMPLETION)
Der Beendigungscode, für den einer der folgenden drei Werte zulässig ist:
ok
Befehl wurde erfolgreich ausgeführt
warning
Befehl wurde ausgeführt, aber mit einer Warnung
error
Befehl ist fehlgeschlagen
<Response> (MQPSCR_RESPONSE)
Dies ist die Antwort auf eine Befehlsnachricht, wenn der Befehl den Beendigungscode warning oder error lieferte. Sie enthält eine Eigenschaft <Reason> (Ursache) und kann weitere Eigenschaften enthalten, die auf die Ursache für die Warnung oder den Fehler hinweisen.

Wenn mehrere Fehler aufgetreten sind, gibt es einen einzigen Antwortordner, der nur die Ursache für den ersten Fehler angibt. Bei mehreren Warnungen gibt es für jede Warnung einen Antwortordner.

<Reason> (MQPSCR_REASON)
Dies ist der Ursachencode, der den Beendigungscode qualifiziert, wenn als Beendigungscode warning oder error zurückgegeben wird. Der Ursachencode entspricht einem der unten aufgelisteten Fehlercodes. Die Eigenschaft <Reason> ist in einem Ordner <Response> (Antwort) enthalten. Auf den Ursachencode kann jede gültige Eigenschaft aus dem Ordner <psc> folgen (z. B. ein Themenname), die auf die Ursache des Fehlers oder der Warnung hinweist.

Beispiele

Hier finden Sie einige Beispiele für den Parameter NameValueData in der Nachricht Broker Response. Eine erfolgreiche Nachricht kann folgendermaßen aussehen:
 <pscr>
   <Completion>ok</Completion>
 </pscr>
Nachfolgend wird ein Beispiel für eine Fehlerantwort gezeigt; bei dem Fehler handelt es sich um einen Filterfehler. In der ersten Zeichenfolge 'NameValueData' ist die Antwort und in der zweiten Zeichenfolge der ursprüngliche Befehl enthalten.
 <pscr>
   <Completion>error</Completion>
   <Response>
     <Reason>3150</Reason>
   </Reponse>
 </pscr>
 
 <psc>
  ...
  Befehlsnachricht (auf die der
  Broker antwortet)
  ...
 </psc>
Nachfolgend wird ein Beispiel einer Warnungsantwort gezeigt (aufgrund nicht berechtigter Themen). In der ersten Zeichenfolge 'NameValueData' ist die Antwort und in der zweiten Zeichenfolge 'NameValueData' der ursprüngliche Befehl enthalten.
 <pscr>
   <Completion>warning</Completion>
   <Response>
     <Reason>3081</Reason>
     <Topic>topic1</Topic>
   </Reponse>
   <Response>
     <Reason>3081</Reason>
     <Topic>topic2</Topic>
   </Reponse>
 </pscr>
 
 <psc>
  ...
  Befehlsnachricht (auf die der
  Broker antwortet)
  ...
 </psc>
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
aq07010_