PH11128: MQ 910 CSQ5PQSG MIGRATE QSG FUNCTION DOES NOT CHECK THE NEWFUNC,800 REQUIREMENT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• MQ 910: CSQ5PQSG MIGRATE QSG does not adequately check for the
  requirement that all queue managers in a queue sharing group
  need to have NEWFUNC,800 capability.
  .
  Additional Symptom(s) Search Keyword(s):
  - CSQ5005E CSQ5CONN Queue manager release level is
    incompatible with queue-sharing group
  - CSQV086E QUEUE MANAGER ABNORMAL TERMINATION REASON=00F50029
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: The MIGRATE QSG and MIGRATE DSG         *
  *                      functions of CSQ5PQSG incorrectly issue *
  *                      message                                 *
  *                      CSQU583I QSG xxxx in DSG yyyyyyyy is    *
  *                               ready for migration            *
  *                      or                                      *
  *                      CSQU580I DSG yyyyyyyy is ready for      *
  *                               migration                      *
  *                      when run against a QSG/DSG containing   *
  *                      one or more queue managers that are     *
  *                      running at, or capable of being         *
  *                      migrated back to, V701 or V710.         *
  *                                                              *
  *                      Attempting to start a queue manager at  *
  *                      V910 results in the queue manager       *
  *                      failing to start, and reporting:        *
  *                                                              *
  *                      CSQ5005E +xxxx CSQ5CONN Queue manager   *
  *                                release level is incompatible *
  *                                with queue-sharing group      *
  *                                                              *
  *                      Additional keywords:                    *
  *                      CSQV086E S6C6 00F50029                  *
  ****************************************************************
  Queue managers running at V910 can coexist in the same QSG as
  queue managers still running at Version 8 or Version 9
  Coexistence with Version 7 queue managers is not supported.
  
  In the reported case, the other queue managers were running a
  supported release, however they were running in (COMPAT,710)
  and so still retained the ability to be backwards migrated to
  Version 7.
  

Problem conclusion

• CSQ5PQSG is changed to correctly report that the QSG/DSG is not
  ready for migration due to incompatible qmgr levels, when any
  qmgr in the QSG/DSG is either running at, or capable of running
  at Version 7.
  
  The IBM MQ for z/OS Version 9.1.x Knowledge center is updated:
  IBM MQ 9.1.x
    IBM MQ
      Maintaining and migrating
        Migrating IBM MQ
          Migrating IBM MQ on z/OS
            Queue sharing group migration
  ( https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/
                                com.ibm.mq.mig.doc/q006440_.htm )
  
  "
  You cannot combine a queue manager at Version 9.1.0, or later,
  in the same queue sharing group as queue managers earlier than
  Version 8.0.0.
  "
  is changed to
  "
  You cannot combine a queue manager at Version 9.1.0, or later,
  in the same queue sharing group as queue managers at, or capable
  of running at versions earlier than Version 8.0.0.
  "
  
  
  IBM MQ 9.1.x
    IBM MQ
      Maintaining and migrating
        Migrating IBM MQ
          Migrating IBM MQ on z/OS
            Migrating IBM MQ for z/OS - order of tasks
             Planning to migrate IBM MQ to a later version on z/OS
  ( https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/
                                com.ibm.mq.mig.doc/q118450_.htm )
  "
  If you are migrating to Version 9.1 from Version 7.1, you must
  first migrate to Version 8.0 or Version 9.0.
  "
  is changed to
  "
  If you are migrating to Version 9.1 from Version 7.1, you must
  first migrate to Version 8.0 or Version 9.0 and restart each
  queue manager with OPMODE=(NEWFUNC,800) or OPMODE=(NEWFUNC,900)
  "
  
  IBM MQ 9.1.x
    IBM MQ
      Maintaining and migrating
        Migrating IBM MQ
          Migrating IBM MQ on z/OS
            Migrating IBM MQ for z/OS - order of tasks
              Preparing to migrate a single IBM MQ for z/OS queue
                                                          manager
  ( https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/
                                com.ibm.mq.mig.doc/q115400_.htm )
  
  "
  9. If you are using queue sharing groups, run CSQ5PQSG. You must
     specify the MIGRATE QSG or MIGRATE DSG function, to verify
     that all queue managers in the QSG or DSG are at a version
     that is compatible with IBM MQ Version 9.1.0.
  "
  is changed to
  "
  9. If you are using queue sharing groups, run CSQ5PQSG. You must
     specify the MIGRATE QSG or MIGRATE DSG function, to verify
     that all queue managers in the QSG or DSG are at a version
     that is compatible with IBM MQ Version 9.1.0.
  
     If any incompatible queue managers are found, issue DISPLAY
     SYSTEM on each queue manager in the QSG.
     Identify any queue managers where DISPLAY SYSTEM reports a
     compatibility level of 701 or 710, for example:
       OPMODE(COMPAT, 701)
       OPMODE(COMPAT, 710, 710)
  
     The system parameters module (ZPARM) for each such queue
     manager should be recompiled with OPMODE=(NEWFUNC,800) or
     OPMODE=(NEWFUNC,900) and the queue managers restarted, prior
     to rerunning CSQ5PQSG to validate compatibility with V910.
  "
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI66880

Modules/Macros

• CSQ5AUTL CSQ5B910
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI66880

     UP20/01/25 P F001 ¢

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.