PM80641: DFHAP0707 0C1 IN TASK RELATED USER EXIT DFHDBAT FOLLOWED BY DFHAP0001 0C1 IN MODULE DFHDBAT DURING SHUTDOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• While in the process of shutting down a CICS TS v4.2 region it
  ends up receiving an abend 0C1/AKEA in DFHDBAT.  The reason for
  this operation exception is that the PSW 00000002 is pointing
  to an invalid instruction.  When 0C1 occur most of the time it
  is tied to a bad branch which comes from DFHDBAT module.
  
  Pulling up the listing for DFHDBAT at UK76215 and going to
  offset x'1E72' shows the BALR.  There is a Load of instruction
  prior to this BALR and it is using an Active Usings of
  STATIC_AREA,R3.  But taking Reg3+C points to bytes contain
  X'00'.
  
  Reg3 in DFHDBAT is supposed to always point to the STATIC_AREA
  but at label IDISCND1, Reg3 is being changed, and loaded with a
  value, then used in a compare swap instruction.  This has
  altered Reg3 so it no longer points to the STATIC_AREA, but
  further down at label IGUNLOCK the code assumes Reg3 does still
  point to this area.  But since it does not, it loads an
  incorrect value for our suspend exit- IXSUSPEN, and branches
  to low core.
  
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: CICS users also using IMS.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHAP0707 An abend (code 0C1/AKEA) has  *
  *                      occurred in task related user exit      *
  *                      program DFHDBAT.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In the reported problem, CICS was processing a shutdown and
  attempting to disconnect from IMS. The task related user exit
  DFHDBAT was called to process the disconnect. The DRA (data base
  resource adaptor) address was not available. This led to error
  case processing, which used register 3 as a work register
  incorrectly.
  Additional Keywords: 0C1 S0C1 abendS0C1 abend0C1 AP0707 AP0001
  

Problem conclusion

• DFHDBAT has been modified so that R3 is not used as a work
  register at label IDISCND1.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM76942

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

  UK91501

Modules/Macros

• DFHDBAT
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UK91501

     UP13/02/15 P F302

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.