IBM GC34-5557-00 User Manual

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:
v Existing 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.

v All 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.

v MQSeries 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.

There are two possible migration scenarios:
v Either you are migrating from a previous version of MQSeries on the same

machine, or

v You are transferring MQSeries to a new machine.

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