PH56214: ABEND DURING FILE OPEN CORRUPTS OPEN RLS ACB CHAIN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An abend can be issued in module DFHFCRO between an FCTE being
  added to the open RLS ACB chain and the file successfully being
  opened. Normally, CICS will check the return code from the open
  SVC and remove the FCTE from the chain if the open has failed.
  However, when there is an abend issued, CICS will enter the
  recovery routine in DFHFCRO and leave the FCTE on the chain even
  though the file is still closed. This corruption of the chain
  may lead to a loop in DFHFCRO when CICS later removes an FCTE
  from the chain.
  Additional Symptom(s) Search Keyword(s): KIXREVPAD DFHFC0001
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: An abend 913/AKEX with an FC0001 dump   *
  *                      occurs in DFHFCRO.                      *
  *                      The region experiences slowdowns and    *
  *                      some runaway tasks abend AKEC in        *
  *                      DFHFCRO.                                *
  ****************************************************************
  DFHFCRO is opening a file and puts an FCTE onto the RLS ACB
  chain. The OPEN SVC abends S913 and CICS enters the recovery
  routine. The recovery processing does not remove the FCTE from
  the chain even though the file is still closed.
  
  More files are successfully opened and get added to the chain.
  The file that failed with the open error gets opened again, this
  time successfully, and its FCTE is updated to point to the
  previous FCTE. There are now two different FCTEs pointing to
  this file on the chain thus corrupting the chain.
  
  When a file gets closed, CICS removes its FCTE entry from the
  chain then tries to find the end of the chain. It never finds
  the end, as the chain is now a loop.
  The chain is processed until kernel error runaway intercepts it
  and issues an AKEC abend. This occurs each time a file is
  closed.
  

Problem conclusion

• DFHFCRO has been changed to ensure the chain is tidied up if the
  OPEN call fails.
  
  Keywords:
  fc_rls_acb_chain
  DFHFC0001
  

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:

  PH59826 UI96598 UI96599

Modules/Macros

• DFHFCRO
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI96599

     UP24/04/23 P F404 ¢

• R300 PSY UI96598

     UP24/04/26 P F404 ¢

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.