Compatibility between different versions of a IBM WebSphere MQ MQI client and a queue manager

Any version and release of a WebSphere® MQ MQI client can connect to any version and release of a WebSphere MQ queue manager. The MQI channel is automatically configured to the latest version that both the client and server support. If the client and server are different versions, the client application must use only the functions in the earlier version.

The compatibility between clients and queue managers applies only to the version and release (V.R) of the product. The statement of compatibility does not necessarily apply to the modification and fix pack level (M.F) of the product.

If there are known problems at a specific V.R.M.F of the product, an upgrade to a more recent fix pack for the same Version.Release is necessary.

When you upgrade a queue manager to a different version, you automatically upgrade WebSphere MQ libraries. The libraries are used by WebSphere MQ MQI client and server applications running on the same server as the queue manager. To access new functions from remote clients, you must also upgrade the IBM® WebSphere MQ MQI client installation on remote workstations. The WebSphere MQ MQI client includes the WebSphere MQ MQI client libraries.

Remote clients that have not been upgraded continue to work with an upgraded queue manager. The behavior of the client application might, in rare cases change. You must consult Changes that affect migration, to find out whether the changes from one version to another affect your client applications.

Remote clients that are connected to upgraded queue managers can use the new functions in the release. If an upgraded remote client is connected to a queue manager that has not been upgraded, it must not use new functions. In rare cases, the behavior of the client might change; see Changes that affect migration.

You can generally assume that upgrading the WebSphere MQ MQI client does not require you to recompile or relink the client application. You can also continue to use the same connection to the queue manager. If changes are required, they are identified in Migrating IBM WebSphere MQ to a later version on UNIX, Linux, and Windows, for the particular migration path and platform you are concerned with.

The Client Channel Definition Table (CCDT) is an interface to customize the connection between an IBM WebSphere MQ Client and a queue manager. Entries in the tables are client connections, which are defined using a queue manager. The version of a CCDT is the version of the queue manager used to define the client connections. If an IBM WebSphere MQ MQI client uses CCDT to connect to a queue manager, the CCDT can be at a version greater than, less than, or equal to that of the client.

You can connect to a queue manager with an earlier WebSphere MQ Client or an earlier CCDT. If you are using a CCDT, and you plan to use new client channel configuration options, such as shared conversations, you must upgrade the CCDT, and therefore the WebSphere MQ MQI client installation to the new version.