[z/OS]

Migrating from earlier unsupported releases of IBM MQ for z/OS

You must take into consideration whether you are upgrading a production system, or a test system, before you undertake the migration process.

Production systems

For production systems you must, firstly, migrate the unsupported release of IBM® MQ to IBM MQ 8.0 or IBM MQ 9.0, following the instructions given in the documentation for that release. For more information about where to find the documentation for older versions of the product, see Documentation for older versions of IBM MQ

You can then migrate to IBM MQ 9.1 following the instructions in this section.
Important: Ensure that your system is stable at IBM MQ 8.0 or IBM MQ 9.0, before migrating to IBM MQ 9.1, so that you have a system to revert to, if necessary.

Test systems

For a test system, it might be appropriate to migrate directly to IBM MQ 9.1 instead.

Before you begin the migration, take complete backups of your system, to ensure that you can restart from backups if you need to use the old release again.

IBM MQ 9.1 migrates IBM MQ objects and messages during the first startup at IBM MQ 9.1. If new attributes have been added to objects since the earlier release then the attributes are set to their default values.

Important: After you have migrated to IBM MQ 9.1 using this method, you cannot revert to the original version.

You can restart a queue manager, at the original version, using the full set of backups taken before migration. However, note that any changes you make to the system after the backups were taken, or while running at IBM MQ 9.1, will be lost.