Felder von MQMD-Berichten JMS-providerspezifischen Eigenschaften zuordnen

JMS-Anwendungen können Berichtsnachrichten als Form der verwalteten Anforderungs-/Antwortverarbeitung verwenden, um Erzeuger über das Resultat ihrer Sendeoperationen und den Verbleib ihrer Nachrichten zu informieren. Eine JMS-Anwendung kann verschiedene Typen von Berichtsnachrichten anfordern, indem sie die Nachrichteneigenschaften und -optionen JMS_IBM_Report_Xxxx definieren.

JMS-Anwendungen können verschiedene Typen von Berichtsnachrichten anfordern, indem sie die entsprechenden Nachrichteneigenschaften und -optionen JMS_IBM_Report_Xxxx definieren. Die Optionen haben dieselbe allgemeine Syntax und Bedeutung:
MQRO_Berichtstyp
Es wird eine Berichtsnachricht des angegebenen Typs generiert, die den IBM MQ-Nachrichtendeskriptor (MQMD) der ursprünglichen Nachricht enthält. Sie enthält keinen Nachrichteninhalt.
MQRO_Berichtstyp_WITH_DATA
Es wird eine Berichtsnachricht des angegebenen Typs generiert, die den MQMD, alle MQ-Header und 100 Bytes der Daten des Hauptteils enthält.
MQRO_Berichtstyp_WITH_FULL_DATA
Es wird eine Berichtsnachricht des angegebenen Typs generiert, die alle Daten der ursprünglichen Nachricht enthält.

Verwenden Sie das folgende Präfix für jede Option: com.ibm.websphere.sib.api.jms.

Um beispielsweise eine COD-Berichtsnachricht (Confirm on Delivery, Empfangsbestätigung) mit vollständigen Daten anzufordern, muss die JMS-Anwendung JMS_IBM_Report_COD auf den Wert to com.ibm.websphere.sib.api.jms.MQRO_COD_WITH_FULL_DATA setzen.

Für jeden Typ von Berichtsnachricht enthält die folgende Tabelle die Nachrichteneigenschaft JMS_IBM_Report_Xxxx, die eine JMS-Nachricht setzen kann, und die Optionen für die MQMD-Berichtsfelder, die der Eigenschaft entsprechen.

Typ der Berichtsnachricht Beschreibung Nachrichteneigenschaft JMS_IBM_Report_Xxxx und Optionen
Ausnahme Sendet eine Berichtsnachricht, wenn die Anforderungsnachricht nicht in die Zielwarteschlange eingereiht werden kann. Die Ausnahmeberichtsnachrichten werden generiert, wenn eine Nachricht an ein Ausnahmeziel umgeleitet werden. JMS_IBM_Report_Exception
  • MQRO_EXCEPTION
  • MQRO_EXCEPTION_WITH_DATA
  • MQRO_EXCEPTION_WITH_FULL_DATA
Verwerfen Die ursprüngliche Anforderungsnachricht wird verworfen anstatt an ein Ausnahmeziel gesendet. Sie können diese Option verwenden, wenn die Eigenschaft JMS_IBM_Report_Exception auf MQRO_EXCEPTION_WITH_FULL_DATA gesetzt ist, damit eine nicht zustellbare Anforderungsnachricht an ihren Sender zurückgegeben wird. JMS_IBM_Report_Discard_Msg
  • TRUE
  • FALSE
Verfallsdatum Sendet eine Berichtsnachricht, wenn das Verfallsdatum der Anforderungsnachricht abläuft. JMS_IBM_Report_Expiration
  • MQRO_EXPIRATION
  • MQRO_EXPIRATION_WITH_DATA
  • MQRO_EXPIRATION_WITH_FULL_DATA
Bestätigung bei Eingang (COA, Confirm on arrival) Sendet eine Berichtsnachricht, wenn die Anforderungsnachricht in die Zielwarteschlange eingereiht wurde.

Für Publish/Subscribe-Messaging wird die COA-Berichtsnachricht nur in der Messaging-Engine der Erzeuger generiert. Deshalb sind solche Berichte auch nur für lokale Subskriptionen relevant.

Für Punkt-zu-Punkt-Messaging werden COA-Nachrichten generiert, wenn die Nachricht am endgültigen Ziel ankommt. Für partitionierte Warteschlangen wird die Berichtsnachricht nur generiert, wenn die Put-Operation festgeschrieben und damit ein endgültiges Ziel ausgewählt wurde. Alle angegebenen Berichtsoptionen With_Data oder With_Full_Data werden ignoriert. Die COA-Berichtsnachricht arbeitet nur mit Nachrichtenheadern.

Wenn ein Weiterleitungspfad (Forward-Routing) verwendet wird, wird die COA-Nachricht generiert, wenn die Nachricht am endgültigen Ziel im Pfad ankommt.

JMS_IBM_Report_COA
  • MQRO_COA
  • MQRO_COA_WITH_DATA
  • MQRO_COA_WITH_FULL_DATA
Empfangsbestätigung (COD, Confirm on delivery) Sendet eine Berichtsnachricht, wenn die Anforderungsnachricht vom Nachrichtenkonsumenten aus der Warteschlange oder dem Topicbereich entfernt wurde.

Für Publish/Subscribe-Messaging wird die COD-Nachricht generiert, wenn alle Subskribenten die Anforderungsnachricht empfangen haben. Deshalb wird nur eine einzige COD-Nachricht für jede COA generiert. Wenn eine Nachricht von einem Subskribenten konsumiert wird, wird der Referenzzähler der Nachricht im Topicbereich heruntergesetzt. Wenn der Referenzzähler null erreicht, wird die Nachricht aus dem Topicbereich entfernt und eine COD-Berichtsnachricht generiert.

Für Punkt-zu-Punkt-Messaging wird die COD-Nachricht generiert, nachdem die Nachricht von einer konsumierenden Anwendung erfolgreich empfangen wurde. Alle angegebenen Berichtsoptionen With_Data oder With_Full_Data werden ignoriert. Die COD-Berichtsnachricht arbeitet nur mit Nachrichtenheadern.

JMS_IBM_Report_COD
  • MQRO_COD
  • MQRO_COD_WITH_DATA
  • MQRO_COD_WITH_FULL_DATA
Positive Aktionsbenachrichtigung (PAN, Positive Action Notification) Fordert die Konsumentenanwendung auf, eine Berichtsnachricht zu senden, nachdem sie die Anforderungsnachricht erfolgreich verarbeitet hat. JMS_IBM_Report_PAN
  • TRUE
  • FALSE
Negative Aktionsbenachrichtigung (NAN, Negative Action Notification) Fordert die Konsumentenanwendung auf, eine Berichtsnachricht zu senden, wenn sie die Anforderungsnachricht nicht erfolgreich verarbeiten konnte. JMS_IBM_Report_NAN
  • TRUE
  • FALSE
Die anfordernde Anwendung kann wie folgt weitere Aspekte der Berichtsnachricht steuern:
  • Generierung der Nachrichten-ID für die Berichtsnachricht und alle Antwortnachrichten:
    MQRO_New_Msg_Id
    Dies ist die Standardeinstellung. Für die Berichtsnachricht wird eine neue Nachrichten-ID generiert.
    MQRO_Pass_Msg_Id
    Die Nachrichten-ID der Berichtsnachricht wird auf die Nachrichten-ID der Anforderungsnachricht gesetzt.
  • Definition der Korrelations-ID der Berichts- oder Antwortnachricht
    MQRO_Copy_Msg_Id_To_Correl_Id
    Dies ist die Standardeinstellung. Die Korrelations-ID der Berichtsnachricht wird auf die Nachrichten-ID der Anforderungsnachricht gesetzt.
    MQRO_Pass_Correl_Id
    Die Korrelations-ID der Berichtsnachricht wird auf die Korrelations-ID der Anforderungsnachricht gesetzt.

Weitere Informationen zu Berichtsnachrichten und den zugehörigen Eigenschaften und Optionen finden Sie im Abschnitt Using Java™ im Information Center von WebSphere MQ, das in der WebSphere MQ-Bibliothek verfügbar ist.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjc0009_
Dateiname:rjc0009_.html