PH62907: CSQU568E ERROR REPORTED WHEN ADDING A QUEUE MANAGER INTO A QSG WHERE IT IS ALREADY DEFINED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CSQU568E QMGR number mismatch -SMDS group value=-1 is reported
  when adding a queue manager into a QSG using CSQ5PQSG ADD QMGR
  where it is already defined while the VERIFY QSG reports no
  discrepancies.
  
  Error Reported:
      CSQU546E  Unable to add QMGR XXXX entry, already exists in
  DB2 table CSQ.ADMIN_B_QMGR
      CSQU568E  QMGR number mismatch for QMGR XXXX: DB2 value=7,
  XCF member value=7, CSQ_ADMIN connection value=0, SMDS group
  value=-1
  
      CSQU567E  QMGR XXXX not added to DB2 table due to a number
  mismatch
      CSQU528I  Disconnected from DB2 XXXX
  
      CSQU147I CSQ5PQSG Utility terminated, return code=8
  
  
  Additional consistency checking is included in the CSQ5PQSG
  utility to detect some potentially erroneous situations where a
  queue manager could be re-added back into a QSG with a different
  ID number and cause consistency problems with SMDS.
  This code did not correctly account for the scenario where a
  queue manager is being added back into a QSG just to rebuild the
  XCF group and the queue manager happens to have used multiple
  SMDS datasets. In this case, the new consistency checking code
  will incorrectly report an SMDS mismatch of "-1" and will report
  a failure. However, the rebuild of the XCF Group completes
  before the SMDS checking occurs so although the CSQ5PQSG utility
  will report an error and fail with RC=8, the step of re-adding
  the queue manager into XCF should have already been completed.
  Therefore, if the only reason to re-run CSQ5PQSG is to update
  the XCF Group, then the subsequent error "QMGR number mismatch"
  can be ignored.
  

Local fix

• None, the "QMGR number mismatch" can be ignored since the
  rebuild of the XCF Group was already completed
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 4 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: CSQ5PQSG reports the following error    *
  *                      when attempting the ADD QMGR function,  *
  *                      if the queue manager being (re)added    *
  *                      has existing SMDS state information for *
  *                      multiple structures in the              *
  *                      ADMIN_B_STRUCTURE table:                *
  *                      "                                       *
  *                      CSQU568E  QMGR number mismatch for QMGR *
  *                      XXXX: DB2 value=3,XCF member value=3,   *
  *                      CSQ_ADMIN connection value=0,SMDS       *
  *                      groupvalue=-1                           *
  *                      "                                       *
  ****************************************************************
  CSQ5PQSG containts additional validation in CSQ5PQSG to prevent
  queue manager's being added to the qsg if the DB2 records for
  that QSG already contained information for that queue manager
  that was associated with a different queue manager identifier.
  An error in these checks caused information associated with
  the correct queue manager identifier to incorrectly fail these
  checks when found for multiple structures.
  
  Note that when the queue manager is already in the QSG, and
  CSQ5PQSG ADD QMGR is being issued to add XCF group information
  for the queue manager (for example, in DR scenarios), although
  the utility fails as described, the XCF group information is
  still correctly added.
  

Problem conclusion

• The consistency checks have been corrected to account for this
  situation.
  

Temporary fix

Comments

APAR Information

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

  PH61936

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

  UI98288

Modules/Macros

• CSQ5PQSG
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R400 PSY UI98288

     UP24/09/25 P F409 ¢

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.