Previous Topic: Source CodeNext Topic: Arguments


Purpose

This exit can be used to override the set of report options defined for the WebSphere MQ Put Message Descriptor prior to the issuance of an MQPUT() operation.

The report options set by the runtime are described in the following table:

Report Option

Description

MQRO_EXCEPTION

This type of report can be generated when an exception occurs. For instance if a message is sent to another queue manager and the message cannot be delivered to the specified destination queue.

MQRO_EXPIRATION

An expiration report. The queue manager generates this type of report if the message is discarded prior to delivery to an application because its expiry time has passed.

MQRO_PASS_MSG_ID

If a report is generated, the MsgId of the current message being processed is to be copied to the MsgId of the report message.

MQRO_COPY_MSG_ID_TO_CORREL_ID

Indicates the correlation ID of the report generated should equal the message ID of the request originally issued.

MQRO_DEAD_LETTER_Q

This option causes the original message to be placed on the dead-letter queue when an exception occurs