PM16854: MSGDFHAP1301 MAY OCCUR FOR TRANSACTIONS THAT HAVE BEEN PURGED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If a transaction is purged during the call to Language
  Environment's Rununit_Termination process, a DFHAP1301 message
  can be produced.
    CICS will call Language Environment's Program_Check_Recovery
  process when the purge is detected.  LE will check it's major
  control blocks for any errors, and if any are found LE will exit
  the call with a return code 8.  During LE's Rununit_Termination
  process, they release their Common Anchor Area ( CAA ).  If the
  purge takes place after the CAA has been released, LE will not
  find it and send a RC8 back to CICS.  CICS in turn will produce
  the DFHAP1301 message indicating that LE found corrupt control
  blocks.  To avoid these AP1301 messages, we should not call LE's
  Program Check Recovery process during Rununit Termination when
  the LE CAA has been released.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHAP1301 is produced when a    *
  *                      task is purged after Language           *
  *                      Environment has been driven for         *
  *                      rununit_termination.                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If a transaction is purged during the call to LE's
  rununit_termination process, msgDFHAP1301 can be produced.
  CICS will call LE for program_check_recovery processing when the
  purge is detected.  LE will check its major control blocks for
  any errors and, if any are found, LE will exit the call with a
  return code 8.  During LE's rununit_termination process, they
  release their Common Anchor Area (CAA).  If the purge takes
  place after the CAA has been released, LE will not find it and
  send a return code 8 back to CICS.  CICS in turn will produce
  the DFHAP1301 message indicating that LE found corrupt control
  blocks.  To avoid these AP1301 messages, we should not call LE's
  program_check_recovery process after rununit_termination when
  the LE CAA has been released.
  

Problem conclusion

• DFHAPLI1's recovery routine has been changed so it doesn't
  make the program_check_recovery call to LE after LE has been
  driven for rununit_termination.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE10/12/03 FIX IN ERROR. SEE APAR PM26873  FOR DESCRIPTION
  

APAR Information

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

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

  UK59004

Modules/Macros

•    DESLI1   DFHAPLI1 DFHAPLJ1 DFHAPLX1
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK59004

     UP10/07/24 P F007

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.