A fix is available
APAR status
Closed as program error.
Error description
There is an UNLOCK for FCFRABL (FRAB lock) but there is no LOCK for this resource. There was a CLOSED issued for the RLS dataset and as a part of the CLOSE processing CICS quiesce's the dataset. XFCSREQ exit was called and had a RC4 which means cancel the the quiesce. After coming back from the XFCSREQ exit we get an exclusive global FRAB lock which is done inline, so there will be no corresponding CICS Trace entries. We then update the FRAB (FCTBC_QSTATE) to say quiesce cancelling, releasing this piece of code, we release the FRAB lock again. This is here for the case when we don't need to update the FRAB at all. However, since this second unlock call is driven and has already been done, DFHFCFS issues the severe error. Additional Symptom(s) Search Keyword(s): FC0002 KIXREVACC
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All. * **************************************************************** * PROBLEM DESCRIPTION: If XFCSREQ responds with UERCBYP to * * a quiesce request, after cancelling * * the quiesce, message DFHFC0002 is * * issued due to a severe error in * * DFHFCFS. * **************************************************************** * RECOMMENDATION: * **************************************************************** If user exit XFCSREQ is active and issues return code UERCBYP to a CLOSE FILE request that has been issued due to a quiesce request then the quiesce is cancelled. The cancelling is done by updating the corresponding FRAB's FCTBC_QSTATE which must be done under the exclusive FRAB global lock and by issuing message DFHFC6024. The codepath mistakenly releases the FRAB lock twice in this scenario and as such leads to lock manager attempting to free a lock that is not being held. This leads to exception trace point 0475 being issued, followed by a disaster response to the original CLOSE_FILE request and message "DFHFC0002 <applid> A severe error (code X'0475') has occurred in module DFHFCFS." being issued. Additional Keywords: msgDFHFC6024 FC6024 6024 msgDFHFC0002 FC0002 0002 AP0475 LM0003 LM0004 UNLOCK/EXCEPTION NOT_LOCK_OWNER
Problem conclusion
UK37688 UK47823 DFHFCFS has been altered to ensure the exclusive global FRAB lock is only released once.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM13330
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
YesPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-04-28
Closed date
2010-06-04
Last modified date
2010-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK57695 PM15582
Modules/Macros
DFHFCFS
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK57695
UP10/06/24 P F006
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 July 2010