IBM Support

PI05227: DFHFC0999 : CICS NEVER RECONNECTS TO RLS FOLLOWING A DYNAMIC RLS RESTART.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A CICS region remains up while the DFSMS RLS server is brought
    down and restarted. Dynamic RLS restart begins but does not
    end.  Access to RLS files from this CICS region remains
    disabled.
    .
    This CICS region issues the following message when dynamic RLS
    restart begins:
    .
    DFHFC0568I CICSPRD1 File control dynamic RLS restart has
    started.
    .
    But this CICS region never issues the message DFHFC0569I saying
    that dynamic RLS restart has ended.  And it never issue the
    message DFHFC0570 saying that RLS access is enabled.
    .
    In this state when there is an attempt to open an RLS file from
    this region, the following message is issued:
    .
    DFHFC0999 CICSPRD1 RLS OPEN of file FILERLS1 failed. RLS access
    is disabled.
    .
    Earlier in the log, this CICS region issued the following
    message:
    .
    DFHFC0001 CICSPRD1 An abend (code 058/AKEX) has occurred at
    offset X'4D7A' in module DFHFCRO.
    .
    
    In the DFHFC0001 dump you can see that this abend058 happened
    while a file ABCDFIL1 was being closed.
    .
    In a dump taken later, you can see that there is a CSFR task
    that is in a FCACWAIT *CTLACB* wait.  This task is waiting for
    all open RLS files to close.  In FC=3 you can find the FC
    Static area.  +3B8 into that is FC_RLS_ACB_CHAIN which is the
    anchor for a chain of open RLS files.  File ABCDFIL1, the file
    involved with the Close that resulted in abend058, is on that
    chain. Because of the abend while closing the file, the file
    will never completely close and CICS will never be able to
    reconnect to RLS.
    
    
    
    
    
    
    Additional Symptom(s) Search Keyword(s): KIXREVDWZ
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS will not reconnect to the SMSVSAM  *
    *                      server after an 058 abend during a      *
    *                      close.                                  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The SMSVSAM server recycles while CICS has files open in RLS
    mode. This causes CICS to attempt to close all the open RLS
    files.
    
    However, if a close abends and drives DFHFCRO's recovery
    routine, subsequent close processing is bypassed leaving
    the file on the open ACB chain. In the case of an 058 abend
    during close processing, the close should be treated as if it
    had worked and the abend can be ignored.
    
    SMSVSAM is automatically restarted, but CICS does not reconnect.
    
    Additional Keywords: AKEX abendAKEX msgDFHFC0001 DFHFC0001
                         FC0001 abend058 abend0D6 0D6 PK92828 0D5
                         FC_RLS_ACB_CHAIN
    

Problem conclusion

  • DFHFCRO's recovery processing has been amended for an 058 or 0D6
    abend to clean up the environment so that the ACB is not left on
    the open chain.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI05227

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-10-31

  • Closed date

    2013-11-14

  • Last modified date

    2015-03-05

  • APAR is sysrouted FROM one or more of the following:

    PI05030

  • APAR is sysrouted TO one or more of the following:

    UI12538

Modules/Macros

  • DFHFCRO
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI12538

       UP13/12/02 P F311

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":"5.1","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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
05 March 2015