MQ 7.x, MQ 8.0, MQ 9.0 and MQ 9.1 compatibility with previous versions - including usage of CCDT files, JMS .bindings, SSL/TLS
Are WebSphere MQ (WMQ) V7.0, V7.1, V7.5, V8.0, V9.0 and V9.1 compatible with previous versions?
Can an MQ 8.0 client use a CCDT created with a previous version?
Can an MQ 7.0 client use a CCDT created with a newer version?
Can a JMS .bindings file created in 7.1 be used with 8.0?
Can a JMS .bindings file created in 8.0 be using with 7.1?
Can an older MQ client using an old SSL protocol still work with MQ 9.0 and MQ 9.1?
WebSphere MQ V7.0, V7.1, V7.5, V8.0, V9.0 and V9.1 queue managers and clients inter operate with queue managers and clients from any previous level of the WebSphere MQ or IBM MQ products.
This means that ...
- A 7.0, 7.1, 7.5, 8.0, 9.0 and 9.1 client can connect to all queue managers, non-version 7, as well as version 7.0, 7.1, 7.5, 8.0, 9.0 and 9.1.
- A 7.0, 7.1, 7.5, 8.0, 9.0 and 9.1 queue manager can interact with all clients, non-version 7, as well as version 7.0, 7.1, 7.5, 8.0, 9.0 and 9.1.
- If your V7.x, V8.0, V9.0 or V9.1 client connects to an MQ 6.0 or earlier queue manager, or use a server-connection channel with the attribute SHARECNV = 0 (which treats the connection as being MQ 6.0), then you cannot use V7 features, and structures in your client application.
- Keep in mind that it is a best practice to use the latest fix pack for each of the versions that you are using.
Why? The latest fix packs could have fixed defects directly or indirectly related to compatibility.
MQ Client V6 and V7/V8/V9.0/V9.1 compatibility
The new features which are available for a version 7.x, 8.0, 9.0 or 9.1 client connected to a version 6.0 queue manager are:
- Weighted selection on CLNTCONN channels.
- Reconnecting via a previously used channel.
- Maximum message length increased on MQSERVER environment variable.
The new feature which is available for a version 6.0 client connected to a version 7.x, 8.0, 9.0 or 9.1 queue manager is:
- Instance limits on SVRCONN channels.
The compatibility statement refers to:
... such as:
An MQ 8.0 client is compatible with an MQ 9.1 queue manager.
This statement does not extend to a more granular specification:
If there are known problems at a given V.R.M.F (such as 126.96.36.199), then an upgrade to a more recent fix pack for the same Version.Release will be necessary (such as 188.8.131.52). Notice that the upgrade is within the same Version.Release (8.0) and a migration to a newer Version.Release is not forced.
+ Compatibility of MQ clients and CCDT files
Newer versions of the MQ clients (such as 9.1) know how to handle CCDT files that were created/edited by older queue managers (such as 6.0)
Older MQ clients (such as 6.0) do NOT know how to handle CCDT files that were created/edited by newer queue managers (such as 9.1). That is, older clients do not know what are the new attributes (if any) introduced in newer MQ versions.
Based on the above, if you have a mix of versions of MQ clients that use a common CCDT file, then this CCDT file should be edited from a queue manager at the LOWEST (OLDEST) version. For example, if you are using MQ 6.0, 7.0, 7.1, 7.5, 8.0, 9.0 and 9.1 clients that use a CCDT file, then the CCDT file must be maintained by the MQ queue manager at version 6.0.
- However, the newer MQ clients (9.1) when using the CCDT created with MQ 6.0 will NOT be able to fully exploit newer features, even when connecting to an 9.1 queue manager because the CCDT will not show the new attributes for those new features.
MQ CCDT created version Compatible MQ client versions 6.0 6.0 7.0 7.1 7.5 8.0 9.0 9.1 7.0 7.0 7.1 7.5 8.0 9.0 9.1 7.1 7.1 7.5 8.0 9.0 9.1 7.5 7.1 7.5 8.0 9.0 9.1 8.0 8.0 9.0 9.1 9.0 8.0 9.0 9.1 9.1 8.0 9.0 9.1
- There was no change in the MQCD length between 7.1 and 7.5. Therefore the CCDT created on 7.5 can be used on 7.1.
- There was no change in the MQCD length between 8.0, 9.0 and 9.1. Therefore the CCDT created on 9.1 can be used on 8.0 and 9.0.
- Unless documented otherwise, CCDTs created on higher level maintenance releases (for example 184.108.40.206) are compatible with lower level (for this example: 220.127.116.11) MQ clients running the same MQ version and release.
Update on July 2016:
There are 2 APARs that allow OLDER MQ clients to use NEWER CCDT files!
These APARs relax the restriction by allowing newer CCDTs to be used on older clients but with the caveat that the older client cannot make use of any of the newer channel attributes. These attributes will assume their default values when the CCDT is negotiated with the queue manager.
For Java/JMS client applications:
IT10863: WEBSPHERE MQ CLASSES FOR JAVA/JMS APPLICATIONS CAN NOT USE CCDT FILES GENERATED ON A NEWER LEVEL QUEUE MANAGER
Version Maintenance Level
For C based (and non-Java/JMS) client applications:
IT11547: WEBSPHERE MQ CLIENT APPLICATIONS CANNOT USE CCDT FILES GENERATED ON A NEWER LEVEL QUEUE MANAGER.
This applies to C based and non-Java/JMS applications.
Version Maintenance Level
+ Compatibility of MQ clients and JMS .bindings files
- A JMS .bindings file that was created at an older version (such as 7.1) than the MQ JMS client (such as 8.0) will be used without version related errors by the client.
- A JMS .bindings file that was created at a newer version (such as 8.0) than the MQ JMS client (such as 7.1), will be used without version related errors by the client. If there are any new attributes in the JMS administered objects that the older client cannot read, they are ignored.
+ Compatibility of SSL/TLS cipher specifications
There have been changes in recent fix packs related to the compatibility of SSL/TLS cipher specifications. For example, if you have a MQ Client at 18.104.22.168 connecting to a MQ 22.214.171.124 queue manager using an older SSL cipher specification, after applying Fix Pack MQ 126.96.36.199 to the queue manager, the connectivity may be broken because the queue manager indicates that the older SSL cipher spec is now deprecated.
For more details on the compatibility of SSL/TLS cipher specifications, see the following blog entry:
SSL and TLS Cipher Specification Deprecations for the MQ Product
Miguel A. Rodriguez
Due to the recent security vulnerabilities (for example, POODLE Attack), the latest MQ product Fix Packs come with stricter, default security requirements that affect the use of the compromised Secure Socket Layer (SSL) and Weak Transport Level Security (TLS) Cipher Specifications. Since these Cipher Specification deprecations are disabled in MQ Fix Packs by default, review the article for the changes separated by MQ versions and Fix Pack levels.
+ Article in the Knowledge Center:
IBM MQ 9.1.x / IBM MQ / Maintaining and migrating / Migrating IBM MQ / Coexistence, compatibility, and interoperability /
Application compatibility and interoperability with earlier versions of IBM MQ
+ begin excerpt
Connecting an application that is built against libraries shipped with a later version of IBM® MQ to an earlier version IBM MQ is not supported. Avoid building applications against a later version, and redeploying them to a queue manager running at an earlier version, although some applications do work in practice.
IBM MQ applications do interoperate with applications running on earlier versions of IBM MQ, as long as they use no new function. IBM MQ clients can connect to queue managers running at an earlier version than the client, as long as the client uses no new functions.
An IBM MQ application that uses only functions provided by an earlier version of a queue manager can continue to send messages to the earlier version. It does not matter what version of IBM MQ an application is built on and connected to. It can exchange messages with an application connected to an earlier version of IBM MQ, as long as it does not use new function.
Consider these four cases; the first two cases are not supported though they might work in practice, the last two cases are supported. The first two cases require compatibility with an earlier version of IBM MQ. The last two cases rely on the interoperability between all versions of IBM MQ
+ end excerpt
+++ end +++
Related informationWebSphere MQ V7.1 Announcement Letter - PDF
WebSphere MQ V7.1 Announcement Letter - Web
WMQ Doc: Coexistence compatibility interoperability
More support for:
Component: Install / Migration
Software version: 7.0, 7.1, 7.5, 8.0, 9.0, 9.1
Operating system(s): AIX, HP-UX, IBM i, Linux, Solaris, Windows, z/OS
Reference #: 1312967
Modified date: 19 December 2018