2249 (08C9) (RC2249): MQRC_MSG_FLAGS_ERROR

Explanation

An MQPUT or MQPUT1 call was issued, but the MsgFlags field in the message descriptor MQMD contains one or more message flags that are not recognized by the local queue manager. The message flags that cause this reason code to be returned depend on the destination of the message; see the description of REPORT in Report options and message flags for more information.

This reason code can also occur in the Feedback field in the MQMD of a report message, or in the Reason field in the MQDLH structure of a message on the dead-letter queue; in both cases it indicates that the destination queue manager does not support one or more of the message flags specified by the sender of the message.

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

Do the following:
  • Ensure that the MsgFlags field in the message descriptor is initialized with a value when the message descriptor is declared, or is assigned a value prior to the MQPUT or MQPUT1 call. Specify MQMF_NONE if no message flags are needed.
  • Ensure that the message flags specified are valid; see the MsgFlags field described in the description of MQMD in MsgFlags (MQLONG) for valid message flags.
  • If multiple message flags are being set by adding the individual message flags together, ensure that the same message flag is not added twice.
  • On z/OS, ensure that the message flags specified are valid for the index type of the queue; see the description of the MsgFlags field in MQMD for further details.