Home
MsgRetryExit (MQCHARn)
Channel message retry exit name.
The message retry exit is an exit that is invoked by the MCA when the MCA receives a completion code of MQCC_FAILED from an MQOPEN or MQPUT call. The purpose of the exit is to specify a time interval for which the MCA should wait before retrying the MQOPEN or MQPUT operation. Alternatively, the exit can decide that the operation should not be retried.
The exit is invoked for all reason codes that have a completion code of MQCC_FAILED — it is up to the exit to decide which reason codes it wants the MCA to retry, for how many attempts, and at what time intervals.
When the exit decides that the operation should not be retried any more, the MCA performs its normal failure processing; this includes generating an exception report message (if specified by the sender), and either placing the original message on the dead-letter queue or discarding the message (according to whether the sender specified MQRO_DEAD_LETTER_Q or MQRO_DISCARD_MSG, respectively). Note that failures involving the dead-letter queue (for example, dead-letter queue full) do not cause the message-retry exit to be invoked.
If the exit name is nonblank, the exit is called at the following times:
- Immediately before performing the wait prior to retrying a message
- At initialization and termination of the channel
See Exit name fields for a description of the content of this field in various environments.
This field is relevant only for channels with a ChannelType of MQCHT_REQUESTER, MQCHT_RECEIVER, or MQCHT_CLUSRCVR.
The length of this field is given by MQ_EXIT_NAME_LENGTH.
The value of this constant is environment specific.
This field is not present when Vis less than MQCD_VERSION_3.
Parent topic:
Fields
ic18500_
Home