PH43191: MQ V9.2 CSQX456I IN PARTIAL REPOSITORY FROM CLUSTER OBJECT SUBSCRIPTION NOT REMADE BEFORE EXPIRY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After a cluster object is out of use for an extended period (at
  least 27 days) on a partial repository qmgr, its subscription
  is marked as old but is renewed for two grace periods. While in
  this state, any subsequent republications of the cluster object
  will not update the expiry time so that the object will
  eventually expire out of the partial repository. If the object
  then comes back into use it will have its refresh flag turned
  on to show that subscriptions should be remade. Before the
  subscriptions get remade, the expiry period on the object may
  elapse. While this doesn't immediately cause the object to be
  deleted, it does result in CSQX456I being issued, as the
  partial repository thinks it must have missed an update.
  

Local fix

• Periodically issue REFRESH CLUSTER() REPOS(NO) on the affected
  queue manager
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 2 Modification 0 and                 *
  *                 Release 3 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: When cluster objects have been unused   *
  *                      for greater than the object expiry      *
  *                      time (30 days), various errors can      *
  *                      occur, including:                       *
  *                      - Message CSQX456I is issued to report  *
  *                      a missing subscription                  *
  *                      - MQOPEN returns MQRC_UNKNOWN_OBJECT    *
  *                      when opening a remote cluster queue     *
  ****************************************************************
  When a clustered queue is used on a partial repository, a
  subscription is created requesting that the full repository
  sends the queue definition when it is updated.
  Errors in calculating the expiry time of this subscription
  can result in the subscription expiring early (resulting in
  CSQX456I), or expiring after the object has expired (leading to
  erroneous MQRC 2085 (MQRC_UNKNOWN_OBJECT) errors.
  

Problem conclusion

• rrmMaintainCLSub has been changed to calculate the expiry time
  of a subscription that has expired and entered its grace period
  correctly, and to correctly re-subscribe when an object with a
  subscription in the grace period is used again.
  

Temporary fix

Comments

• ×**** PE22/12/02 FIX IN ERROR. SEE APAR PH51254  FOR DESCRIPTION
  

APAR Information

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

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

  UI81071 UI82788

Modules/Macros

• CMQXRMNT
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R200 PSY UI81071

     UP22/07/01 P F206

• R300 PSY UI82788

     UP22/10/22 P F210 ¢

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.