PH64232: ADMIN STRUCTURE RECOVERY SKIPPED FOR PEER QUEUE MANAGERS WITHOUT XCF DATA

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• While starting a queue sharing group on an alternative site, the
  the first queue manager to restart detected that the Admin
  Structure needed to be rebuilt.
  The queue manager attempted to rebuild the Admin Structure
  contents for itself, and several peer queue managers, however
  no rebuild was attempted for peers for which no XCF data existed
  due to an error/delay in running CSQ5PQSG ADD QMGR for those
  peers, and Admin Structure recovery was incorrectly deemed to be
  complete.
  The missing Admin Structure entries were later rebuilt when the
  owning queue managers restarted following successful CSQ5PQSG
  ADD QMGR execution
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 3 Modification 0 and                 *
  *                 Release 4 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Admin structure recovery can be skipped *
  *                      for queue managers following recovery   *
  *                      at an alternate site if CSQ5PQSG ADD    *
  *                      QMGR was not run successfully for every *
  *                      queue manager prior to the first queue  *
  *                      manager being restarted.                *
  *                      In rare cases this could lead to        *
  *                      incorrect resolution of in progress     *
  *                      units of recovery.                      *
  ****************************************************************
  When restarting queue managers in a queue sharing group at an
  alternate site the XCF Group data for the queue sharing group
  will no longer exist.
  Prior to starting any queue manager in the QSG it is necessary
  to run CSQ5PQSG with the ADD QMGR function to recreate XCF
  Group data for each queue manager in the QSG.
  The queue manager will detect if its own XCF group data has not
  been recreated and terminate startup processing, however it
  does not detect if the XCF group data for any peer queue
  managers has not been correctly recreated.
  
  If a started queue manager initiates Admin Structure recovery,
  while the XCF group data for the QSG is incomplete, the missing
  state data can cause recovery of in progress units of recovery
  on peers without the expected XCF data to be incorrectly skipped
  

Problem conclusion

• During queue manager startup, queue managers in a queue sharing
  group will check that the required XCF Group data is present for
  each queue manager in the Queue Sharing Group, and will recreate
  any missing entries, removing the need to first run
  CSQ5PQSG "ADD QMGR" to recreate the XCF data.
  
  CSQ5042I will be issued for each queue manager where existing
  XCF data is found.
  CSQ5043I will be issued for each queue manager where existing
  XCF data was not found, and the missing XCF data was recreated.
  
  The Knowledge Center is updated as follows:
  
  Db2 manager messages (CSQ5...)
  https://www.ibm.com/docs/en/ibm-mq/9.4?
                              topic=zos-db2-manager-messages-csq5
  
  The System Programmer Response for message CSQ5010E is updated
  such that the section starting with
  "
  This message may occur if one or more of the queue managers in
  a queue sharing group (QSG) do not have a member entry in the
  XCF group for the QSG.
  "
  and continuing to the end, applies only if APAR PH64232 has not
  been applied.
  
  
  New message CSQ5042I is added:
  "
  CSQ5042I
  csect-name XCF entry for queue manager qmgr-id (qmgr-name)
  found.
  
  Explanation
  The XCF entry for the queue manager identified was found during
  startup.
  
  System action
  Processing continues.
  
  System programmer response
  None.
  "
  
  New message CSQ5043I is added:
  CSQ5043I
  csect-name XCF entry for queue manager qmgr-id (qmgr-name)
  recreated.
  
  Explanation
  The XCF entry for the queue manager identified was not found
  during startup.
  This is expected when recovering a queue sharing group at an
  alternative site.
  
  System action
  The missing XCF entry is recreated by the starting queue manager
  
  System programmer response
  None.
  
  
  Alternative site recovery on z/OS
  https://www.ibm.com/docs/en/ibm-mq/9.4?
                    topic=mq-alternative-site-recovery-zos#
                     q022650___RecoveringAQueueSharingGroupAtThe
  
  In the section
  "Recovering a queue sharing group at the alternative site"
  point 4 is changed from:
  "
  4. Run the ADD QMGR command of the CSQ5PQSG utility for every
  queue manager in the queue sharing group. This will restore the
  XCF group entry for each queue manager.
  "
  to
  "
  4. If APAR PH64232 is not applied, run the ADD QMGR command of
  the CSQ5PQSG utility for every queue manager in the queue
  sharing group. This will restore the XCF group entry for each
  queue manager.
  
  If APAR PH64232 is applied the first queue manager to start will
  restore the XCF group entry for each queue manager.
  "
  
  The queue sharing group utility (CSQ5PQSG) on z/OS
  https://www.ibm.com/docs/en/ibm-mq/9.4?
          topic=reference-queue-sharing-group-utility-csq5pqsg-zos
  
  In the description of the "ADD QMGR" parameter the paragraph
  "
  If a queue manager exists in Db2 table CSQ.ADMIN_B_QMGR, but is
  missing from MVS XCF group, you can run this utility to restore
  the appropriate XCF group entry, as indicated by CSQ5010E
  message.
  "
  is changed to:
  "
  If a queue manager exists in Db2 table CSQ.ADMIN_B_QMGR, but is
  missing from MVS XCF group, you can run this utility to restore
  the appropriate XCF group entry, as indicated by CSQ5010E
  message. This is not necessary if APAR PH64232 has been applied.
  "
  

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:

  UI99894 UI99895 UI99896 UI99897 UI99898 UI99899 UI99900 UI99901
  UI99902 UI99903 UI99904 UI99905

Modules/Macros

• CSQ5245M CSQ5245N CSQ5ALOB CSQ5CONN CSQ5L930 CSQ5L940 CSQ5LEPL
  CSQ5QXCF CSQ5XRBD CSQF5DIC CSQF5DIE CSQF5DIF CSQF5DIK CSQF5DIU
  CSQFMTXC CSQFMTXE CSQFMTXF CSQFMTXK CSQFMTXU
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R300 PSY UI99900

     UP25/02/18 P F502 ¢

• R301 PSY UI99901

     UP25/02/18 P F502 ¢

• R302 PSY UI99902

     UP25/02/18 P F502 ¢

• R303 PSY UI99903

     UP25/02/18 P F502 ¢

• R304 PSY UI99904

     UP25/02/18 P F502 ¢

• R305 PSY UI99905

     UP25/02/18 P F502 ¢

• R400 PSY UI99894

     UP25/02/18 P F502 ¢

• R401 PSY UI99895

     UP25/02/18 P F502 ¢

• R402 PSY UI99896

     UP25/02/18 P F502 ¢

• R403 PSY UI99897

     UP25/02/18 P F502 ¢

• R404 PSY UI99898

     UP25/02/18 P F502 ¢

• R405 PSY UI99899

     UP25/02/18 P F502 ¢

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.