IBM MQ MQI client migration
IBM MQ MQI client migration is the process of converting IBM MQ MQI client configurations, and client and server channels from one version to another. Client migration can take place after upgrading the IBM MQ MQI client, and is reversible.
It is better to migrate the clients after the queue managers that they communicate with have been migrated.
Client migration on the client workstation is optional and manual. Client migration on the server is required and automatic. We must upgrade an IBM MQ MQI client before migrating a client workstation to make use of new configuration options. We can make configuration changes to client and server connection channels on the server, but they have no effect on a client workstation, until the client is upgraded.
An example of client migration performed at the client workstation is to manually migrate configuration settings to the mqclient.ini configuration file.
An example of combined client and server migration is the deployment of a new client connection definition table (CCDT). To use a new version of the CCDT, generate the table on a queue manager that is at the new code level. Deploy the table to clients that are going to use it. To deploy the table to a client, you first must update the client to at least the same level as the queue manager that created the table.
An IBM MQ MQI client can interoperate with earlier and later versions of IBM MQ. Upgrading the IBM MQ MQI client makes new function available to client applications, and is important to maintain the service level. Migrating an IBM MQ MQI client gives it access to new configuration options.
The IBM MQ MQI client libraries, such as mqic.dll, are dynamic, and the application linkages to the libraries do not normally change. You do not relink a client application to pick up new IBM MQ client libraries. The client picks up the new library next time the library is loaded by the client application. Do not move libraries from their installed directory. Linking to libraries in anything other than their installed directory is an unsupported configuration.
Parent topic: Migration concepts and methods
Related concepts
- Application compatibility and interoperability with earlier versions of IBM MQ
- Application compatibility and interoperability with later versions of IBM MQ
Related tasks
- Migrating an IBM MQ MQI client to the latest version on IBM i
- Migrating an IBM MQ MQI client on UNIX and Linux
- Migrating an IBM MQ MQI client on Windows
Related reference
- MQI client: Client Channel Definition Table (CCDT)
- MQI client: Default behavior of client-connection and server-connection channels
- MQI client: MQPUT1 sync point behavior change