PM88560: DFHFC0001 AN ABEND (CODE ---/AKEA) HAS OCCURED AT OFFSET X'03E2'IN MODULE DFHFCDTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The dump shows the progression of the 0C2/AKEA which occured in
  module DFHDTPC which leads to the AKEA reported in DFHDTRR and
  finally the DFHFC0001 AKEA at offset X'03E2' in module DFHFCDTS.
  .
  The trace shows taskA and taskB initially issued a READ for
  fileA  on L8 tcbs. TaskA issue a close for the file on the AOR
  after moving to the QR tcb. When Task B attempts to complete
  the READ of the file after changing to the QR TCB the DFHFC0001
  occurs in DFHFCDTS. The FCTDTTKN field for fileA is zeroes.
  .
  ADDITIONAL KEYWORDS:
  data table read ABENDAKEA CICS TS 4.2
  KIXREVxxx
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS application encounters an AFCZ     *
  *                      abend on reading a remote UMDT.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Two CICS transactions attempt to read a UMDT (User Maintained
  Data Table) simultaneously. Both test whether or not the file
  is open in module DFHFCFR and find that it is open.
  
  At this point the tasks each try to switch to the QR TCB
  (if they are not there already).
  Both will then invoke DFHFCDTS to do the read, but before
  this occurs, the remote file is closed on the FOR.
  The first task sees that the file has been closed, and
  issues a local close via DFHFCFS. The read request is then
  shipped and a NOT_OPEN response is returned.
                                                                 .
  When the second transaction gets the QR TCB, it abends AFCZ
  in DFHFCDTS as the table has been closed and the token CICS
  holds for this table is no longer valid. A system dump is taken
  and the joblog shows:
                                                                 .
  An abend (code ---/AKEA) has occurred in module DFHFCDTS.
                                                                 .
  Additional Keywords: AbendAKEA X'03E2' 03E2 DFHFC0001 FC0001
                       msgDFHFC0001 AbendAFCZ AFCZ
  

Problem conclusion

• DFHFCFR has been amended so that it tests whether or not the
  file is open after the switch to the QR TCB takes place.
  DFHFCDTS will no longer be called with a bad token, instead the
  request will be immediately function shipped to the FOR.
  

Temporary fix

• *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM82304

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

  UK94552

Modules/Macros

• DFHFCFR
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UK94552

     UP13/06/01 P F305

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.