PH47621: DFHAP0707 AN ABEND 0CX HAS OCCURRED IN TASK RELATED USER EXIT PROGRAM DFHDBAT AT SHUTDOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Normal shutdown is happening under a CEMT task, it has gotten to
  the point where DFHSTP is calling ERM to tell TRUEs that CICS is
  shutting down orderly.   Control is in DFHDBAT within the
  IQUIESCE routine.  There, the CEMT Task is waiting for other
  tasks to finish up with their DBCTL work.
  
  The problem happens when one transaction is finishing up with
  its DBCTL thread.  At label TQUIT in DFHDBAT, it notices that
  there is a waiting disconnection task (CEMT shutdown). So it
  calls the Resume Exit.  The Resume Exit posted the CEMT shutdown
  task awake.  Then the Resume Exit loaded the registers stored on
  entry and branched on R14 to return back to where it was called
  near TQUIT. However, that RSA had different registers than what
  were stored on entry, so branching on R14 results in a wild
  branch and eventual abend0Cx.
  Additional sypmtoms: KIXREVSCB
  ABEND0C2 0C2 ABEND0C1 0C1 ABEND0C4 0C4
  AP0707 AP0001 IMS TRUE DBCTL
  DFHAP0001 An abend (code 0C2/AKEA) has occurred at
            offset X'FFFFFFFF' in module DFHDBAT.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A CEMT PERFORM SHUTDOWN command is      *
  *                      issued for a region with some DBCTL     *
  *                      work actively in progress.  An abend    *
  *                      code 0Cx/AKEA occurs in module DFHDBAT. *
  ****************************************************************
  CICS is running with some IMS-DBCTL work still active in the
  region when a CEMT PERFORM SHUTDOWN command is entered.
  The CEMT command causes the IMS-DBCTL interface to disconnect
  but due to a timing issue this might interfere with the clean up
  of a user task's DBCTL thread and corrupt some registers during
  DFHDBAT processing.  The effect is to cause a wild branch and an
  abend code 0Cx/AKEA in DFHDBAT.
  

Problem conclusion

• DFHDBAT has been changed to use a DFHDBGWA lock while the
  resume exit is called to resume the CEMT task, which prevents
  the register corruption of the user task's RSA.
  

Temporary fix

Comments

APAR Information

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

  PH40804

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

  UI81418

Modules/Macros

• DFHDBAT
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UI81418

     UP22/07/15 P F207

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.