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
- 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.