A fix is available
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 number
PI44819
Reported component name
WMQ Z/OS 8
Reported component ID
5655W9700
Reported release
000
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-07-12
Closed date
2016-03-09
Last modified date
2016-05-04
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.
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
04 May 2016