2331 (091B) (RC2331): MQRC_MSG_TOKEN_ERROR

Explanation

An MQGET call was issued to retrieve a message using the message token as a selection criterion, but the options specified are not valid, because MQMO_MATCH_MSG_TOKEN was specified with either MQGMO_WAIT or MQGMO_SET_SIGNAL.

An Async Consumer was registered to retrieve a message using the message token as a selection criterion, but when the delivery of messages for this consumer was started no message matching the message token was available for delivery to the consumer. As a result the consumer is suspended.

Completion code

MQCC_FAILED

Programmer response

If this reason code is returned from an MQGET call, either remove the MQMO_MATCH_MSG_TOKEN match option, or remove the MQGMO_WAIT, or MQGMO_SET_SIGNAL option which was specified.

If this reason code is returned to an Async Consume Event Handler, then the consumer has been suspended and no further messages will be delivered to the consumer. The consumer should be de-registered or modified to select a different message using the MQCB call.

Parent topic: API reason codes