JMS applications can use report messages as a form of managed request/response processing, to give remote feedback to producers on the outcome of their send operations and the fate of their messages.
Type of report message | Description | JMS_IBM_Report_Xxxx message property and options |
---|---|---|
Exception | Send a report message if the request message cannot be put to the target queue. The exception report messages are generated when a message has been rerouted to an exception destination. | JMS_IBM_Report_Exception
|
Expiration | Send a report message if the request message passes its expiry time. | JMS_IBM_Report_Expiration
|
Confirm on arrival (COA) | Send a report message when the request message has been put
to the target queue. For publish/subscribe messaging, the COA report message is generated only on the producers messaging engine. Therefore, such reports are relevant only to local subscriptions. For point-to-point messaging, COA messages are generated when the message arrives at the final destination. For partitioned queues, the report message is generated only when the put operation has committed and a final destination has therefore been selected. Any With_Data or With_Full_Data report options specified are ignored; the COA report message deals only with message headers. If a forward-routing path is used, the COA message are generated when the message arrives at the final destination in the path. |
JMS_IBM_Report_COA
|
Confirm on delivery (COD) | Send a report message when the request message has been
removed from the queue or topic space by a message consumer. For publish/subscribe messaging, the COD message is generated when all subscribers have received the request message. Therefore, there is one COD message generated for every COA. When a message is consumed by a subscriber, the reference count of the message on the topic space is reduced. When the reference count reaches zero, the message is removed from the topic space then a COD report message is generated. For point-to-point messaging, the COD message is generated after the message has been successfully received by a consuming application. Any With_Data or With_Full_Data report options specified are ignored; the COD report message deals only with message headers. |
JMS_IBM_Report_COD
|
Positive action notification (PAN) | Ask the consumer application to send a report message when it has successfully processed the request message. | JMS_IBM_Report_PAN
|
Negative action notification (NAN) | Ask the consumer application to send a report message if it has not successfully processed the request message. | JMS_IBM_Report_NAN
|
For more information about report messages and the associated properties and options, see the WebSphere MQ: Using Java book, SC34-6066.