PM89168: DFHAP0001 CODE ---/AKEA AT +X'0EEC' INTO DFHERMSP FOLLOWED BY DFHRM0002 CODE X'0377' IN DFHRMLSO : CICS TERMINATES WITH THAT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your CICS region abended with the following messages
  issued to the console:
  .
  DFHAP0001 CICSREGN AN ABEND (CODE ---/AKEA) HAS OCCURRED
   AT OFFSET X'0EEC' IN MODULE DFHERMSP .
  DFHRM0002 CICSREG2  A SEVERE ERROR (CODE X'0377') HAS
   OCCURRED IN MODULE DFHRMLSO .
  .
  In either the DFHAP0001 dump or the DFHRM0002, the last entries
  in the Kernel Error Table look like this:
  .
  KE_NUM  ERROR TYPE           ERR_CODE  MODULE    OFFSET
  ======  ==========           ========  ======    ======
   0042   TRAN_ABEND_PERCOLATE ---/4038  DFHEPC    00000724
   0042   ABEND                04E/AKEB  UNKNOWN   UNKNOWN
   0042   PROGRAM_CHECK        0C1/AKEA  UNKNOWN   UNKNOWN
   0042   PROGRAM_CHECK        0C4/AKEA  DFHTRPX   00000398
   0042   PERCOLATE            ---/AKEA  DFHERM    0000150A
   0042   PERCOLATE            ---/AKEA  DFHERMSP  00000EEC
  .
  The key one of those is the 0C1 .  Investigation of that
  Kernel Error Data shows that that 0C1 is caused by a branch
  to low core from +x'AFC' into DFHPCP at the UK76215 level.
  (Get a listing of DFHPCPG at UK76215 to see DFHPCP.)  This
  0C1 is in the pcpg_abend procedure after a call to DFHABAB
  for Start_Abend has returned with Invalid_Token.  This code
  assumes that the only reason a Start_Abend will return is if
  an XPCTA exit has requested a retry.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A severe error (code x'0377') occurred  *
  *                      in module DFHRMLSO after AOR reports    *
  *                      the condition to TOR by transaction     *
  *                      routing.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  TOR invokes an AOR application by transaction routing. An
  abend4038 occurs in the application so DFHPCPG is called to
  create a TACB and then start this abend. DFHAPAC is called to
  report the error to TOR terminal. During MRO communication,
  TOR terminal is disconnected so AOR receives an FMH 7 request.
  AOR creates a second abend and turns on a TCA flag TCAIACB. As
  CICS is already in the process of abend handling. MRO decides
  not to start this abend so the logic returns to DFHAPAC. DFHAPAC
  changes the latest TACB pointer back to the first 4038 TACB
  without also restoring TCAIACB back. Then CICS begins to backout
  and fails to backout DB2. So DFHPCPG is called again to handle
  a third abend. The incorrect TCAIACB makes DFHPCPG use the
  latest 4038 TACB and not create a new one. When DFHPCPG calls
  DFHABAB to start the abend, DFHABAB realizes the TACB has
  already been started so returns an exception. DFHPCPG thinks
  DFHABAB returns because XPCTA global user exit sets a retry
  address, which is not true. DFHPCPG branches to zero retry
  address so abendS0C1 happens.
  Additional keywords: abendAD3K, msgDFHRM0002, msgDFHAP0001,
  abend0C1, S0C1A, ATCB, abendATCV.
  

Problem conclusion

• DFHAPAC has been changed to restore back TCAIACB when DFHTFP
  returns.
  

Temporary fix

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

Comments

APAR Information

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

  PM83033

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

  UK95631

Modules/Macros

• DFHAPAC
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UK95631

     UP13/07/13 P F307

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.