Overview for MQGMO

Availability: All IBM MQ platforms.

Purpose: The MQGMO structure allows the application to control how messages are removed from queues. The structure is an input/output parameter on the MQGET call.

Version: The current version of MQGMO is MQGMO_VERSION_4. Certain fields are available only in certain versions of MQGMO. For to port applications between several environments, we must ensure that the version of MQGMO is consistent across all environments. Fields that exist only in particular versions of the structure are identified as such in MQGMO - Get-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 MQGMO that is supported by the environment, but with the initial value of the Version field set to MQGMO_VERSION_1. To use fields that are not present in the version-1 structure, set the Version field to the version number of the version required.

Character set and encoding: Data in MQGMO 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.