Home

 

MsgRetryCount (MQLONG)

 

Number of times MCA will try to put the message, after the first attempt has failed.

This indicates the number of times that the MCA will retry the open or put operation, if the first MQOPEN or MQPUT fails with completion code MQCC_FAILED. The effect of this attribute depends on whether MsgRetryExit is blank or nonblank:

• If MsgRetryExit is blank, the MsgRetryCount attribute controls whether the MCA attempts retries. If the attribute value is zero, no retries are attempted. If the attribute value is greater than zero, the retries are attempted at intervals given by the MsgRetryInterval attribute.

  Retries are attempted only for the following reason codes:

  • MQRC_PAGESET_FULL

  • MQRC_PUT_INHIBITED

  • MQRC_Q_FULL

  For other reason codes, the MCA proceeds immediately to its normal failure processing, without retrying the failing message.

• If MsgRetryExit is nonblank, the MsgRetryCount attribute has no effect on the MCA; instead it is the message-retry exit which determines how many times the retry is attempted, and at what intervals; the exit is invoked even if the MsgRetryCount attribute is zero.

  The MsgRetryCount attribute is made available to the exit in the MQCD structure, but the exit it not required to honor it — retries continue indefinitely until the exit returns MQXCC_SUPPRESS_FUNCTION in the ExitResponse field of MQCXP.

This field is relevant only for channels with a ChannelType of MQCHT_REQUESTER, MQCHT_RECEIVER, or MQCHT_CLUSRCVR.

This field is not present when Vis less than MQCD_VERSION_3.

 

Parent topic:

Fields

ic18520_

 

Home