z/OS: Reverting a queue manager to a previous release

After migrating to IBM® MQ for z/OS® Version 8.0, from either Version 7.0.1 or Version 7.1.0, you can backward migrate, or fallback, to the version you were using prior to migration. Backward migration Program Temporary Fixes (PTFs) are available for both Version 7.0.1 and Version 7.1 0.

Before you begin

In general, after fallback to IBM WebSphere® MQ 7.0, new attributes of IBM MQ objects introduced at Version 8.0 will be removed. The APAR that supplies these PTFs, documents specific information relating to fallback to IBM WebSphere MQ 7.0.1 or to IBM WebSphere MQ 7.1.0.

Switching back to running a queue manager with the target libraries of a previous version is possible if DISPLAY SYSTEM returns COMPAT=vrm where vrm is the level of the previous version. If it does, you can go back to using your customization and startup procedure for the queue manager from that version

  • The queue manager compatibility level must be 7rm. If the queue manager has never been run with OPMODE set to (NEWFUNC,800), the compatibility level is 7rm.
    • DISPLAY SYSTEM returns OPMODE COMPAT,7rm.
    where
    7
    is the version number v of the product.
    r
    is the release number of the product.
    m
    is the modification number of the product.
  • Before migrating your queue manager to the latest version, with that version of target libraries, you applied all the migration and toleration PTFs to the queue manager on your previous version. The queue manager then started successfully with those PTFs at that previous version. This is a requirement before you can revert your queue manager to the original version.
  • You saved the queue manager customization macros and JCL for running with the Version 7.0 target libraries.
    • You can recreate the customization for version 7.r , if the originals are not available to you.

About this task

To restart the queue manager, so that it runs at the version where it was migrated from, just requires that you switch back to using the libraries for the previous version.

Note that it is not necessary to rollback the early code for this installation when reverting your queue manager to an earlier version.

Procedure

  1. Stop the listener, channel initiator, and queue manager.
  2. Switch back to use the MSTR and CHINIT started procedure JCLs with version 7.r libraries.

    In case data set aliases are used for load libraries, switch the aliases to refer to version 7.r libraries. For example, an alias named MQM.MQP1.SCSLOAD, referring to MQM.MQV800.SCSLOAD, needs to change to refer to MQM.MQV7xx.SCSLOAD.

  3. Restart queue manager, using the system parameter module (CSQZPARM) used with IBM MQ version 7.r prior to migration, and linking to the version 7.r code.
    • Until you have verified the startup, start the queue manager, channel initiator, and listener separately, checking for errors on the console after each component is started. If the startup runs cleanly, combine the startup of all three components in the production environment.
    1. Start the queue manager.
    2. Start the channel initiator.
    3. Start the listener.
  4. Verify correct functioning of existing applications.

Results

If the queue manager cannot be reverted to the previous release by following the preceding procedure, for example, because it has been started with OPMODE set to (NEWFUNC,800), the queue manager can only be reverted to the previous release by recovering the page sets, BSDSs, and active logs from back up copies taken before the migration to IBM MQ for z/OS Version 8.0.

All updates made since the back up was taken will be lost. See How to backup and recover pagesets for more information on backing up IBM MQ resources.