PI44819: WMQ Z/OS V800:ALL ATTRIBUTES FOR THE CF STRUCTURE ARE RESET BY CSQUZAP DELDB2.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CFSTRUCT is deleted by CSQUZAP DELDB2 from DB2
  when there are no longer any bits set in the list-header map.
  
  Additional Symptom(s) Search Keyword(s):
  

Local fix

• n/a.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 8 *
  *                 Release 0 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: All attributes for a Coupling Facility  *
  *                      structure are reset by CSQUZAP DELDB2   *
  *                      OBJTYPE(QUEUE).                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  DB2 table CSQ.ADMIN_B_STRUCTURE contains a row for each coupling
  facility structure, and within each row LH_ARRAY contains an
  existence bit for each shared queue using that structure. As
  part of CSQUZAP DELDB2 OBJTYPE(QUEUE) processing in CSQU5ZAP the
  list-header bit for the queue is reset in LH_ARRAY. If CSQ5UZAP
  then finds that all list-header bits are now off (i.e. no queues
  are using the structure) the structure row is deleted from DB2.
  A subsequent attempt to open a shared queue using the same
  structure name will cause a CFSTRUCT to be created automatically
  from scratch, with no regard to the values specified in the
  structure just deleted.
  In the reported problem the customer noticed that the offload
  rules for the structure had been reset after using CSQUZAP to
  delete a queue.
  

Problem conclusion

• CSQUZAP processing has been updated so that DELDB2
  OBJTYPE(QUEUE) processing will no longer delete the associated
  Coupling Facility structure when the last queue using it has
  been deleted.
  A new OBJTYPE(CFSTRUCT) has been added to DELDB2 processing to
  allow a Coupling Facility structure to be explicitly deleted.
  
  ========= DOC Changes for V800 Knowledge Center ===============
  Update the following page (csq_u) in the Knowledge Center for MQ
  add new message CSQU588E as follows:
  
  IBM MQ
  > Reference
      > Diagnostic messages
         > Messages and reason codes for z/OS
          >  Messages
              > Utilities messages (CSQU...)
  
  CSQU588E Unable to delete structure struc-name, structure in use
  
  Explanation
  
  A CSQUZAP DELDB2 OBJTYPE(CFSTRUCT) command was unable to delete
  the Coupling Facility structure as it is required by one or more
  queues.
  
  System action
  
  Processing of the command is terminated.
  
  System programmer response
  
  If the queue(s) using the Coupling Facility structure are not
  required delete them and re-try the command.
  ===============================================================
  000Y
  002Y
  003Y
  004Y
  005Y
  CSQFSTXC
  CSQFSTXE
  CSQFSTXF
  CSQFSTXK
  CSQFSTXU
  CSQUZPAR
  CSQU5ZAP
  

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:

  UI35972 UI35973 UI35974 UI35975 UI35976

Modules/Macros

• CSQFSTXC CSQFSTXE CSQFSTXF CSQFSTXK CSQFSTXU CSQUZPAR CSQU5ZAP
  

Fix information

• Fixed component name

  WMQ Z/OS 8

• Fixed component ID

  5655W9700

Applicable component levels

• R000 PSY UI35972

     UP16/04/12 P F604

• R002 PSY UI35973

     UP16/04/12 P F604

• R003 PSY UI35974

     UP16/04/12 P F604

• R004 PSY UI35975

     UP16/04/12 P F604

• R005 PSY UI35976

     UP16/04/12 P F604

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.