IBM GC34-5557-00 manual Migrating MQSeries What are the Differences, Overview of Migration Process

Migrating MQSeries

What are the Differences

MQSeries for AS/400, V5.1 provides significant new function over previous releases, including support for multiple queue managers, queue manager clusters, and substantially increased message and queue sizes. Enabling this new function has involved some changes to the internal architecture of MQSeries. For example this release makes substantial use of the Integrated File System whereas, previously, all MQSeries data was stored in OS/400 objects in libraries.

Another significant change with this release concerns security. To increase compatibility with the other V5.1 MQSeries platforms and also to provide authorization to individual MQI calls, the OS/400 object-based security model used in previous releases has been replaced by one using the MQSeries OAM (Object Authority Manager).

As a consequence of these, and other changes, migration to MQSeries for AS/400, V5.1 from a previously installed release requires special consideration and careful planning. Areas to which you should apply close attention include:

vExisting RPG, COBOL, and C applications using the MQI (MQSeries Interface) should work successfully without the need for recompilation. There have been some changes in detail in the way some CL commands are implemented. CL programs using these commands might need to be edited and recompiled.

vAll user exits including channel and data conversion exits must be recompiled using ILE compilers, bound to the threaded MQSeries libraries, made thread-safe and enabled for teraspace memory. Details can be found in the MQSeries Application Programming Guide and the MQSeries Intercommunication book.

vMQSeries authorizations continue to be administered through the GRTMQMAUT (Grant MQM Authority) and RVKMQMAUT (Revoke MQM Authority) commands, but there are substantial changes:

±Authorization lists and reference objects are no longer supported.

±Authorizations that may be given to a user for MQSeries objects are now grouped into four categories: MQI, Context, Administration, and Generic.

There are additional security considerations to take into account. For details see the MQSeries for AS/400 V5.1 System Administration book.

Overview of Migration Process

There are two possible migration scenarios:

vEither you are migrating from a previous version of MQSeries on the same machine, or

vYou are transferring MQSeries to a new machine.

Chapter 4. Installing, Migrating to, and Deleting MQSeries for AS/400 25