Overview for MQOD

Availability: All IBM® MQ systems, plus IBM MQ MQI clients connected to those systems.

Purpose: The MQOD structure is used to specify an object by name. The following types of object are valid:
  • Queue or distribution list
  • Namelist
  • Process definition
  • Queue manager
  • Topic
The structure is an input/output parameter on the MQOPEN and MQPUT1 calls.

Version: The current version of MQOD is MQOD_VERSION_4. Applications that you want to port between several environments must ensure that the required version of MQOD is supported in all the environments concerned. Fields that exist only in the more-recent versions of the structure are identified as such in the descriptions that follow.

The header, COPY, and INCLUDE files provided for the supported programming languages contain the most-recent version of MQOD that is supported by the environment, but with the initial value of the Version field set to MQOD_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.

To open a distribution list, Version must be MQOD_VERSION_2 or greater.

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