Overview for MQPMO

Availability: All IBM MQ systems, plus IBM MQ clients connected to these systems.

Purpose: The MQPMO structure allows the application to specify options that control how messages are placed on queues, or published to topics. The structure is an input/output parameter on the MQPUT and MQPUT1 calls.

Version: The current version of MQPMO is MQPMO_VERSION_3. Certain fields are available only in certain versions of MQPMO. For to port applications between several environments, we must ensure that the version of MQPMO is consistent across all environments. Fields that exist only in particular versions of the structure are identified as such in MQPMO - Put-message options and in the field descriptions.

The header, COPY, and INCLUDE files provided for the supported programming languages contain the most-recent version of MQPMO that is supported by the environment, but with the initial value of the Version field set to MQPMO_VERSION_1. To use fields that are not present in the version-1 structure, the application must set the Version field to the version number of the version required.

Character set and encoding: Data in MQPMO must be in the character set given by the CodedCharSetId queue manager attribute and encoding of the local queue manager given by MQENC_NATIVE. However, if the application is running as an MQ MQI client, the structure must be in the character set and encoding of the client.