MsgRetryCount (MQLONG)

This field specifies the number of times MCA tries to put the message, after the first attempt has failed.

This field indicates the number of times that the MCA tries 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 does not affect the MCA; instead it is the message retry exit that 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 Version is less than MQCD_VERSION_3.