2247 (08C7) (RC2247): MQRC_MATCH_OPTIONS_ERROR

Explanation

An MQGET call was issued, but the value of the MatchOptions field in the GetMsgOpts parameter is not valid, for one of the following reasons:
  • An undefined option is specified.
  • All of the following are true:
    • MQGMO_LOGICAL_ORDER is specified.
    • There is a current message group or logical message for the queue handle.
    • Neither MQGMO_BROWSE_MSG_UNDER_CURSOR nor MQGMO_MSG_UNDER_CURSOR is specified.
    • One or more of the MQMO_* options is specified.
    • The values of the fields in the MsgDesc parameter corresponding to the MQMO_* options specified, differ from the values of those fields in the MQMD for the message to be returned next.
  • On z/OS®, one or more of the options specified is not valid for the index type of the queue.

This reason code occurs in the following environments: AIX®, HP-UX, z/OS, IBM® i, Solaris, Windows, plus WebSphere® MQ clients connected to these systems.

Completion Code

MQCC_FAILED

Programmer response

Ensure that only valid options are specified for the field.