JMS-Berichtsnachrichten
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.
- MQRO_Berichtstyp
- Es wird eine Berichtsnachricht des angegebenen Typs generiert, die den 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.
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
|
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
|
Verfallsdatum | Sendet eine Berichtsnachricht, wenn das Verfallsdatum der Anforderungsnachricht abläuft. | JMS_IBM_Report_Expiration
|
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
|
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
|
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
|
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
|
- 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 zu den Berichtsnachrichten im Information Center von IBM MQ4.