PI08793: WMQ Z/OS V7 CHANGES TO CLWLPRTY AND CLWLRANK ARE NOT REFLECTED ON CLUSTERED QUEUE MANAGER ALIAS OBJECT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the CLWLPRTY of a clustered queue manager alias is altered,
  this change is reflected on the local queue manager but not in
  the cluster.
  
  Example:
  
  1/ define a cluster queue manager alias
     DEFINE QREMOTE(T_CLUS_QMGR_ALIAS) RNAME(' ' ) RQMNAME(' ')
  CLUSTER(CLUS1) CLWLPRTY(0)
  
  2/ Display the qremote and cluster information
     DISPLAY QUEUE(T_CLUS_QMGR_ALIAS) CLWLPRTY CLUSINFO
  
  CSQM293I % CSQMDRTC 2 QUEUE FOUND MATCHING REQUEST CRITERIA
  CSQM201I % CSQMDRTC  DIS QUEUE DETAILS
  QUEUE(T_CLUS_QMGR_ALIAS)
  TYPE(QREMOTE)
  QSGDISP(QMGR)
  CLWLPRTY(0)
   END QUEUE DETAILS
  CSQM201I % CSQMDRTC  DIS QUEUE DETAILS
  QUEUE(T_CLUS_QMGR_ALIAS)
  TYPE(QCLUSTER)
  QSGDISP(QMGR)
  CLWLPRTY(0)
   END QUEUE DETAILS
  CSQ9022I % CSQMDRTC ' DIS QUEUE' NORMAL COMPLETION
  
  
  3/ Alter the CLWLPRTY to 1
     ALTER QREMOTE(T_CLUS_QMGR_ALIAS) CLWLPRTY(1)
  
  4/ Display the queue again :
  
  DISPLAY QUEUE(T_CLUS_QMGR_ALIAS) CLWLPRTY CLUSINFO
  CSQM293I % CSQMDRTC 2 QUEUE FOUND MATCHING REQUEST CRITERIA
  CSQM201I % CSQMDRTC  DIS QUEUE DETAILS
  QUEUE(T_CLUS_QMGR_ALIAS)
  TYPE(QREMOTE)
  QSGDISP(QMGR)
  CLWLPRTY(1)
   END QUEUE DETAILS
  CSQM201I % CSQMDRTC  DIS QUEUE DETAILS
  QUEUE(T_CLUS_QMGR_ALIAS)
  TYPE(QCLUSTER)
  QSGDISP(QMGR)
  CLWLPRTY(0)
   END QUEUE DETAILS
  CSQ9022I % CSQMDRTC ' DIS QUEUE' NORMAL COMPLETION
  
  As can be seen above the CLWLPRTY has not been reflected on the
  qcluster object.
  

Local fix

• A work around for this issue is to ALTER CLWLPRTY and update the
  DESCRIPTION field at the same time.
  
   ALTER QREMOTE(T_CLUS_QMGR_ALIAS) CLWLPRTY(2) DESCR(TEST)
  
   DISPLAY QUEUE(T_CLUS_QMGR_ALIAS) CLWLPRTY DESCR CLUSINFO
   CSQM293I % CSQMDRTC 2 QUEUE FOUND MATCHING REQUEST CRITERIA
   CSQM201I % CSQMDRTC  DIS QUEUE DETAILS
   QUEUE(T_CLUS_QMGR_ALIAS)
   TYPE(QREMOTE)
   QSGDISP(QMGR)
   DESCR(TEST)
   CLWLPRTY(2)
   END QUEUE DETAILS
  CSQM201I % CSQMDRTC  DIS QUEUE DETAILS
  QUEUE(T_CLUS_QMGR_ALIAS)
  TYPE(QCLUSTER)
  QSGDISP(QMGR)
  DESCR(TEST)
  CLWLPRTY(2)
   END QUEUE DETAILS
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 0 Modification 1 and Release 1       *
  *                 Modification 0.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Altering CLWLRANK or CLWLPRTY on a      *
  *                      clustered QREMOTE definition doesn't    *
  *                      change the values on the cluster        *
  *                      object.                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When a QREMOTE definition is altered CSQMCNA6 is called to
  perform the change.
  The ClusterQ proc will compare the before and after values of
  cluster related parameters to see if any have changed, and if so
  it will call CSQMQCLU to create a PCF message of type
  MQCMD_CLUS_INSERT_CLQ and put it to the
  SYSTEM.CLUSTER.COMMAND.QUEUE for processing by the repository
  manager.
  However ClusterQ omits to compare the CLWLRANK and CLWLPRTY
  parameters and thus when these are changed the cluster object is
  left unaltered.
  

Problem conclusion

• CSQMCNA6 has been changed to check for any changes to CLWLRANK
  and CLWLPRTY.
  010Y
  100Y
  CSQMCNA6
  

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:

  UI14557 UI14558

Modules/Macros

• CSQMCNA6
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R010 PSY UI14557

     UP14/03/04 P F403

• R100 PSY UI14558

     UP14/03/04 P F403

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.