PM05570: DFHFC0001 AN ABEND (CODE ---/AKEA) HAS OCCURRED AT OFFSET X'03C6' IN MODULE DFHFCDTS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Two user tasks were running on CICS L8 TCBS and issued EXEC CICS
  READ for a FILE which was defined as a use maintained datatable
  UDMT UDT. This lead to an abend0c2 and DFHFC0001 dump.
  Also a transaction ABENDAFCZ AFCZ.
  In the dump, the CICS trace table shows these are task numbers
  37186 and 37187.
  Task 37186 gets an GET_DIRECT/EXCEPTION from DFHDTRR with
  RESPONSE(020F) and ERROR_CODE(03000000) which leads to a
  CLOSE_FILE being issued now on QR TCB.
  Task 37187 also switched to QR but still atempts to READ the
  same FILE even though it was just CLOSED. As the FILE and
  user data table had just been closed by task 37186,the FCT +
  x'114' contained x'00000000' in field FCTDTTKN data table token
  The PSW shows that 0c2 occurred in DFHDTPC base+ x'15C' and
  was caused by the zero CONNECT_TOKEN, contains(00000000).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS application encounters an AFCZ     *
  *                      abend on reading a remote UMDT. The log *
  *                      shows an abend (code ---/AKEA), and a   *
  *                      system dump is taken.                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Two CICS transactions attempt to read a UMDT (User Maintained
  Data Table) at the same time. 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 can happen 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'03C6' 03C6
  

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 via
  DFHFCRF.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM01648

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

  UK54117

Modules/Macros

• DFHFCFR
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK54117

     UP10/02/11 P F002

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.