PK37589: ABEND AEXY IN A CICS TRANSACTION USING ESQTRUE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer reported abend AEXY in a CICS transaction using
  ESQTRUE.
  This problem appeared after migrating from CICS/TS 2.3 to
  CICS/TS 3.1.
  At 620, the add_link fails with an exception response, DFHERM
  ignores this and carries on the call the TRUE.
  At 640 the add_link fails with a purged response and there is an
  abend, preventing the TRUE being called.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend AEXY issued by DFHERM during end  *
  *                      of task syncpoint processing.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  During end-of-task syncpoint, DFHERM is driven for any task-end
  TRUEs. It is possible for these to do work requiring an add_link
  request to CICS recovery manager at this stage. For example, the
  TRUE may itself invoke another TRUE that has yet to be driven
  within this UOW, and so requires an RMLK for Recovery Manager.
  However, the UOW has passed the final point when Recovery
  Manager can be called for it. Since the UOW is no longer
  inflight, Recovery Manager class RMLN (the RMC link function
  processor) sets up an rmln_response of rmln_exception, and an
  rmln_reason of rmln_invalid_syncpoint_state. However, the logic
  in RMLN_Add_Link then continues on and resets the response to
  rmln_purged. When this is returned to DFHERM, it is treated as a
  purged response and DFHERM issues an AEXY abend.
  KEYWORDS: TRUE ERM response reason exception purge
            invalid_syncpoint_state abends abendAEXY
            EOT DFHRMCAL RM 0302 ADD_LINK
  

Problem conclusion

• DFHRMLN has been changed. RMLN_Add_Link now does not continue on
  and set a purged response when a UOW has been found to be past
  its inflight stage. This allows an exception response
  to be returned to DFHERM, and the reason of invalid_syncpoint_
  state is ignored, and treated as expected in such a case.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK22809

Modules/Macros

•    DESRMLN  DFHRMLN
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK22809

     UP07/03/13 P F703

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.