IBM Support

PM13330: DFHFC0002 A SEVERE ERROR (CODE X'0475') HAS OCCURRED IN MODULE DFHFCFS 10/06/13 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

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