2317 (090D) (RC2317): MQRC_FORMAT_NOT_SUPPORTED


Explanation

The Format field in the message descriptor MQMD contains a value that is not supported:

  • In an administration message, the format value must be one of the following: MQFMT_ADMIN, MQFMT_EVENT, MQFMT_PCF. For the mqPutBag call, the field in error resides in the MsgDesc parameter of the call. For the mqGetBag call, the field in error resides in the message descriptor of the message about to be retrieved.
  • On z/OS®, the message was put to the command input queue with a format value of MQFMT_ADMIN, but the version of IBM MQ being used does not support that format for commands.


Completion code

MQCC_FAILED


Programmer response

If the error occurred when putting a message, correct the format value.

If the error occurred when getting a message, the message cannot be retrieved using the mqGetBag call:

  • If one of the MQGMO_BROWSE_* options was specified, the message remains on the queue and can be retrieved using the MQGET call.
  • In other cases, the message has already been removed from the queue and discarded. If the message was retrieved within a unit of work, the unit of work can be backed out and the message retrieved using the MQGET call.