PH58212: CLUSTERING RECOVERY AND DIAGNOSTIC IMPROVEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CLUSTERING RECOVERY AND DIAGNOSTIC IMPROVEMENTS
  .
  The equivalent APAR for multi-platform is IT43646.
  The fix is included in the 9.4.0 base.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 3 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: When restoring from a backup or after   *
  *                      a disaster recovery event, it is        *
  *                      possible for the clustering sequence    *
  *                      numbering algorithm to be improved.     *
  ****************************************************************
  The clustering sequence numbering algorithm meant it was
  possible for previously published updates to be lost by queue
  managers in a cluster if a REFRESH CLUSTER was not issued
  following a disaster recovery event or restoring from a backup.
  

Problem conclusion

• The code has been changed to rebase all sequence numbers
  following a queue manager restart. Additional messages CSQX888E
  and CSQX889E have also been added to indicate potential
  administrative errors.
  
  
  The following messages CSQX888E and CSQX889E have been added to
  the 9.3 IBM MQ Documentation:
  IBM MQ
   -Reference
    -Messages and reason codes
     -IBM MQ for z/OS messages, completion, and reason codes
      -Messages for IBM MQ for z/OS
       -Distributed queuing messages (CSQX...)
  (https://www.ibm.com/docs/en/ibm-mq/9.3?topic=zos-distributed-
  queuing-messages-csqx)
  
  Distributed queuing messages (CSQX...)
  
  "
  CSQX888E
  csect-name Cluster object object-name in cluster cluster-name 
  (QMID qmid) expiring due to definition mismatch.
  
  Severity
     8
  
  Explanation
  Object object-name shared in cluster cluster-name (QMID qmid)
  has not been updated for at least 30 days but an alternative
  instance remains active in the cluster.
  
  This often indicates an administrative error, such as recovery
  from backup of a cluster queue manager without REFRESH CLUSTER
  being issued.
  
  If no action is taken the alternative definition will be
  accepted in place of the current definition before it expires.
  
  System action
  None
  
  System programmer response
  Review administrative procedures to ensure only a single
  instance of the queue manager with this QMID is active in the
  cluster at any given time.
  
  If only the 'correct' host for this object is now active, you
  can optionally issue REFRESH CLUSTER on that queue manager to
  ensure its definitions are used from this point onwards and
  suppress further error messages.
  
  
  CSQX889E
  csect-name Cluster object object-name in cluster cluster-name 
  (QMID qmid) replaced with 'older' definition.
  
  Severity
     8
  
  Explanation
  Object object-name shared in cluster cluster-name (QMID qmid)
  was due to expire, but publications from an alternative
  instance were received.
  To prevent expiry these definitions will be used, but this
  might indicate an operational error in the cluster has occurred.
  
  System action
  None
  
  System programmer response
  No action is required as the 'visible' definition will now be
  used, but you might want to review administrative procedures to
  ensure that only a single instance of the queue manager with
  this QMID is active in the cluster at any given time.
  "
  

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:

  UI99381 UI99382 UI99383 UI99384 UI99385 UI99386

Modules/Macros

• CMQXRECO CMQXRMNT CSQFXLAT CSQFXTXC CSQFXTXE CSQFXTXF CSQFXTXK
  CSQFXTXU CSQIRECP CSQMSTRT CSQXRCTL CSQXRRMF CSQXTRTB
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R300 PSY UI99381

     UP25/01/07 P F501

• R301 PSY UI99382

     UP25/01/07 P F501

• R302 PSY UI99383

     UP25/01/07 P F501

• R303 PSY UI99384

     UP25/01/07 P F501

• R304 PSY UI99385

     UP25/01/07 P F501

• R305 PSY UI99386

     UP25/01/07 P F501

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.