Home

 

V(MQLONG)

 

Structure version number.

The value depends on the environment:

MQCD_VERSION_1

Version-1 channel definition structure.

MQCD_VERSION_2

Version-2 channel definition structure.

This value is not used by any current WebSphere MQ product.

MQCD_VERSION_3

Version-3 channel definition structure.

The field has this value on MQSeries Version 2 in the following environments: HP OpenVMS, Compaq NonStop Kernel, and UNIX systems not listed elsewhere.

MQCD_VERSION_4

Version-4 channel definition structure.

This value is not used by any current WebSphere MQ product.

MQCD_VERSION_5

Version-5 channel definition structure.

The field has this value on MQSeries for OS/390 Version 5 Release 2.

MQCD_VERSION_6

Version-6 channel definition structure.

This is not the current MQCD structure version of any existing WebSphere MQ product. However, a Version-6 MQCD structure can be passed to MQCONNX using the ClientConnOffset or ClientConnPtr fields of the MQCNO structure.

On the distributed platforms MQCD_VERSION_6 is the default Version in the MQCD_DEFAULT and MQCD_CLIENT_CONN_DEFAULT initializers. If you want to reference the MQCD_VERSION_7 or MQCD_VERSION_8 fields of the MQCD, explicitly initialize the MQCD Vfield to MQCD_VERSION_7 or MQCD_VERSION_8 as appropriate.

MQCD_VERSION_7

Version-7 channel definition structure.

The field has this value on WebSphere MQ V5 Release 3 in the following environments: AIX, HP-UX, Solaris, Windows, and on WebSphere MQ for z/OS V5 Release 3 and Version 5 Release 3.1.

MQCD_VERSION_8

Version-8 channel definition structure.

The field has this value on WebSphere MQ V6.0 on all platforms.

Fields that exist only in the more-recent versions of the structure are identified as such in the descriptions of the fields. The following constant specifies the version number of the current version:

MQCD_CURRENT_VERSION

Current version of channel definition structure.

The value of this constant depends on the environment (see above). For WebSphere MQ V6.0, the declarations of MQCD provided in the header, COPY, and INCLUDE files for the supported programming languages contain the additional fields, but the initial value provided for the Vfield is MQCD_VERSION_6. To use the additional fields, the application must set the version number to MQCD_CURRENT_VERSION. Applications which are intended to be portable between several environments should use a more-recent version MQCD only if all of those environments support that version.

When a new version of the MQCD structure is introduced, the layout of the existing part is not changed. The exit should therefore check that the version number is equal to or greater than the lowest version which contains the fields that the exit needs to use.

 

Parent topic:

Fields


ic18150_


 

Home