2333 (091D) (RC2333): MQRC_WIH_ERROR


Explanation

An MQPUT or MQPUT1 call was issued, but the message data contains an MQWIH structure that is not valid. Possible errors include the following:

  • The StrucId field is not MQWIH_STRUC_ID.
  • The Version field is not MQWIH_VERSION_1.
  • The StrucLength field is not MQWIH_LENGTH_1.
  • The CodedCharSetId field is zero, or a negative value that is not valid.
  • The BufferLength parameter of the call has a value that is too small to accommodate the structure (the structure extends beyond the end of the message).

On z/OS, this error also occurs when the IndexType attribute of the queue is MQIT_MSG_TOKEN, but the message data does not begin with an MQWIH structure.


Completion code

MQCC_FAILED


Programmer response

Check that the fields in the structure are set correctly. Ensure that the application sets the CodedCharSetId field to a valid value (note: MQCCSI_DEFAULT, MQCCSI_EMBEDDED, MQCCSI_Q_MGR, and MQCCSI_UNDEFINED are not valid in this field).

On z/OS, if the queue has an IndexType of MQIT_MSG_TOKEN, ensure that the message data begins with an MQWIH structure.

Parent topic: API reason codes