XMSC_WMQ_PROVIDER_VERSION

Data type:

String

Property of:

ConnectionFactory

The version, release, modification level and fix pack of the queue manager to which the application intends to connect. Valid values for this property are:

• Unspecified

Or a string in one of the following formats

• V.R.M.F

• V.R.M

• V.R

• V

Where V, R, M and F are integer values greater than or equal to zero.

A value of 7 or greater indicates that this version is intended as a IBM® WebSphere MQ Version 7.0 ConnectionFactory for connections to a IBM WebSphere MQ Version 7.0 queue manager. A value earlier than 7 (for example "6.0.2.0"), indicates that it is intended for use with queue managers earlier than Version 7.0. The default value, unspecified, allows connections to any level of queue manager, determining the applicable properties and functionality available based on the queue manager's capabilities.

By default this property is set to "unspecified".

Note:

• No socket sharing happens if XMSC_WMQ_PROVIDER_VERSION is set to 6. 2.
• Connection fails if XMSC_WMQ_PROVIDER_VERSION is set to 7 and on the server SHARECNV for the channel is set to 0.
• IBM WebSphere MQ Version 7.0 specific features are disabled if XMSC_WMQ_PROVIDER_VERSION is set to UNSPECIFIED and SHARECNV is set to 0.

The version of IBM WebSphere MQ Client also plays major role in whether an XMS client application can use IBM WebSphere MQ Version 7.0 specific features. The following table describes the behavior. Note: A system property XMSC_WMQ_OVERRIDEPROVIDERVERSION overrides the XMSC_WMQ_PROVIDER_VERSION property. This property can be used if you are unable to change connection factory setting.

Table 1. XMS client - Ability to use IBM WebSphere MQ Version 7.0 specific features.

#	XMSC_WMQ_PROVIDER_VERSION	IBM WebSphere MQ Client Version	IBM WebSphere MQ Version 7.0 features
1	unspecified	7	ON
2	unspecified	6	OFF
3	7	7	ON
4	7	6	Exception
5	6	6	OFF
6	6	7	OFF