2033 (07F1) (RC2033): MQRC_NO_MSG_AVAILABLE

Explanation

An MQGET call was issued, but there is no message on the queue satisfying the selection criteria specified in MQMD (the MsgId and CorrelId fields), and in MQGMO (the Options and MatchOptions fields). Either the MQGMO_WAIT option was not specified, or the time interval specified by the WaitInterval field in MQGMO has expired. This reason is also returned for an MQGET call for browse, when the end of the queue has been reached.

This reason code can also be returned by the mqGetBag and mqExecute calls. mqGetBag is similar to MQGET. For the mqExecute call, the completion code can be either MQCC_WARNING or MQCC_FAILED:
  • If the completion code is MQCC_WARNING, some response messages were received during the specified wait interval, but not all. The response bag contains system-generated nested bags for the messages that were received.
  • If the completion code is MQCC_FAILED, no response messages were received during the specified wait interval.

Completion code

MQCC_WARNING or MQCC_FAILED

Programmer response

If this is an expected condition, no corrective action is required.

If this is an unexpected condition, check that:
  • The message was put on the queue successfully.
  • The unit of work (if any) used for the MQPUT or MQPUT1 call was committed successfully.
  • The options controlling the selection criteria are specified correctly. All of the following can affect the eligibility of a message for return on the MQGET call:
    • MQGMO_LOGICAL_ORDER
    • MQGMO_ALL_MSGS_AVAILABLE
    • MQGMO_ALL_SEGMENTS_AVAILABLE
    • MQGMO_COMPLETE_MSG
    • MQMO_MATCH_MSG_ID
    • MQMO_MATCH_CORREL_ID
    • MQMO_MATCH_GROUP_ID
    • MQMO_MATCH_MSG_SEQ_NUMBER
    • MQMO_MATCH_OFFSET
    • Value of MsgId field in MQMD
    • Value of CorrelId field in MQMD
Consider waiting longer for the message.