PH65188: NO WARNING IS PROVIDED WHEN DUPLICATE CLUSTER RECIEVER CHANNELS ARE CREATED WITH A MISMATCHED QUEUE MANAGER NAME

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A channel configuration error (specifically, a CLUSRCVR) can
  cause important cluster cache records to be erroneously
  replaced. Where the replaced record is for a full repository,
  the local queue manager can subsequently not be able to
  communicate with this specific full repository. If a REPOS(NO)
  variant of a REFRESH CLUSTER command is issued, this can cause
  messages destined for the lost repository, to fail and be backed
  out and repeatedly retried, which will continue to fail.
  (Pre-GHE APAR) UHL LINK:
  https://jazza06.hursley.ibm.com:9443/ccm/resource/itemName/com.i
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 2 Modification 0, Release 3          *
  *                 Modification 0 and Release 4 Modification 0. *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a CLUSRCVR channel is recreated on *
  *                      a different queue manager with a        *
  *                      mismatched name, it may silently        *
  *                      overwrite cluster records. As a result  *
  *                      of this, communication with the         *
  *                      original queue manager may break,       *
  *                      causing message delivery failures and   *
  *                      REFRESH CLUSTER issues.                 *
  ****************************************************************
  The code responsible for validating CLUSRCVR channel definitions
  did not detect when a duplicate channel name was created with a
  mismatched queue manager name. As a result, incorrect cluster
  cache records could silently overwrite valid ones, leading to
  broken communication with the intended queue manager, message
  delivery failures, and REFRESH CLUSTER command issues.
  

Problem conclusion

• The product has been enhanced to determine if a mismatch arises
  between an existing channel name / queue manager name
  combination and a newly created CLUSRCVR. When a mismatch is
  found, a CSQX809I message is output by the channel initiator to
  alert users that a potential configuration error exists in the
  cluster configuration.
  
  The IBM MQ for z/OS Version 9.2.x, Version 9.3.x and Version
  9.4.x.
  
  Documentation are updated:
  IBM MQ
   Reference
    Messages
     IBM MQ for z/OS messages, completion, and reason codes
      Messages for IBM MQ for z/OS
       Message manager messages (CSQX...)
  ( https://www.ibm.com/docs/en/ibm-mq/
  9.2.x?topic=zos-distributed-queuing-messages-csqx )
  ( https://www.ibm.com/docs/en/ibm-mq/
  9.3.x?topic=zos-distributed-queuing-messages-csqx )
  ( https://www.ibm.com/docs/en/ibm-mq/
  9.4.x?topic=zos-distributed-queuing-messages-csqx )
  
  Added message CSQX890I:
  "
  CSQX890I
      csect-name Cluster receiver channel channel-name has been
      configured by multiple queue managers (attempted by queue
      manager qmgr-uuid1, but already defined for queue manager
      qmgr-uuid2).
  
  Severity
      4
  
  Explanation
      A CLUSRCVR channel with the same name has been defined by
      different queue managers. This mismatch in queue manager
      names indicates a potential cluster configuration error. The
      channel initiator has detected this mismatch and issued this
      message to alert the user.
  
  System programmer response
      Check the queue manager configuration. If you intended to
      replace channel channel-name, check that the commands
      were issued against the correct queue manager. If the
      original channel instance was created in error, correct the
      configuration on qmgr-uuid2. Follow the product
      documentation to remove the channel from the cluster then
      recreate the channel. If the original cluster receiver was
      created in error, recreate it with the correct name.
  "
  

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:

  UO04622 UO04623 UO04624 UO04625 UO04626 UO04627 UO04628 UO04629
  UO04630 UO04631 UO04632 UO04633 UO04634 UO04635 UO04636 UO04637
  UO04638

Modules/Macros

• CMQXRECO CSQFXLAT CSQFXTXC CSQFXTXE CSQFXTXF CSQFXTXK CSQFXTXU
  CSQXRRMF
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R200 PSY UO04634

     UP25/09/13 P F509

• R201 PSY UO04635

     UP25/09/13 P F509

• R202 PSY UO04636

     UP25/09/13 P F509

• R203 PSY UO04637

     UP25/09/13 P F509

• R204 PSY UO04638

     UP25/09/13 P F509

• R205 PSY UO04639

     UP25/09/13 P F509

• R300 PSY UO04628

     UP25/09/13 P F509

• R301 PSY UO04629

     UP25/09/13 P F509

• R302 PSY UO04630

     UP25/09/13 P F509

• R303 PSY UO04631

     UP25/09/13 P F509

• R304 PSY UO04632

     UP25/09/13 P F509

• R305 PSY UO04633

     UP25/09/13 P F509

• R400 PSY UO04622

     UP25/09/13 P F509

• R401 PSY UO04623

     UP25/09/13 P F509

• R402 PSY UO04624

     UP25/09/13 P F509

• R403 PSY UO04625

     UP25/09/13 P F509

• R404 PSY UO04626

     UP25/09/13 P F509

• R405 PSY UO04627

     UP25/09/13 P F509

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.