PM92232: CICS ABENDS WITH MSGDFHAP0002 CODE 0D89 THEN MSGDFHRM0002 CODE 0377 THEN U1800 WHEN A CRTE'D TASK ABENDED AZI9 ASPN AZTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer is using CRTE to do the transaction routing,
  The transaction ID is xxxx running in AOR was purged is
  resulting in an abend AZI9. The abend was handled by the
  application handle abend exit. In the HANDLE abend exit,
  a SEND-TEXT was issued without the WAIT option
  .
  The surrogate TCTTE and the MRO session TCTTE now
  contain the SEND-TEXT. The handle abend exit returns
  to CICS using an EXEC CICS RETURN.
  .
  During task termination, DFHAPAC function REPORT_CONDITION,
  condition ROLLBACK_TERMINATE is called.
  'the transaction has issued an EXEC CICS RETURN in backout
  required program state'.
  The ASPN is issued because the application handle
  exit abend is needed to do either a
     SYNCPOINT or a SYNCPOINT ROLLBACK
     Or re-issued the ABEND request.
  DFHCRIU PERFORM_COMMIT is called by recovery manager.
  with an error code of x'0407' (Abend ATCB) because the
  surrogate TCTTE has a status of -
  "control is on the other side". DFHZTSP convert this to
  an abend AZTS.
  .
  The AZTS causes DFHCRIU recovery routine to be driven and
  message DFHAP0002 to be issued..
  .
  The AP0002 followed by the RM0002 is cause by the
  application handle abend exit returning to CICS with a
  deferred send request to the terminal without doing a
  SYNCPOINT or SYNCPOINT ROLLBACK and an EC ABEND when the
  task is in backout required program state.
  .
  With the same scenario, if the task had been executing as a
  Transaction Route instead of CRTE. Normal transaction route
  would not cause CICS to be terminated abnormally.
  .
  We expect that the behavior should be the same regardless if
  CRTE is using or not.
  Additional Keyword(s) and Symptom(s): KIXREVSVR
  ABENDAZI9 ABENDASPN ABENDAZTS  MSGDFHAP0002 DFHAP0002
  MSGDFHRM0002 DFHRM0002 abendU1800 U1800 MSGDFHAC2216
  DFHAC2216
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Purging Back-End CRTE task in the AOR   *
  *                      while control is in TOR can result in   *
  *                      abends AP0002 and RM0002 at syncpoint   *
  *                      and the loss of the CICS region.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CRTE is used to transaction route a user transaction across an
  MRO connection. The transaction is suspended in a Terminal I/O
  wait in the TOR.
  At this time the Back-End task in the AOR is purged from
  its IRLINK wait. However because the application handled the
  abend no AZI9 abend was produced.
  
  At the end of task because of the handled abend the
  Reported_Condition is ROLLBACK_TERMINATE, and DFHTFP produces
  message DFHAC2246 to the TDQ, and indicates that message
  DFHAC2216 should be sent back to the Terminal with the FMH7.
  
  However, when DFHCRIU attempts to send this data it finds
  that 'control is on the other side' and abends AZTS.
  This results in an AP0002 abend from DFHCRIU and a Disaster
  return code being returned to Recovery Manager, which then
  takes an RM0002 abend and terminates CICS.
  
  With the same scenario if the task had been executing as a
  Transaction Route instead of CRTE then DFHTFP would have
  attempted to Flush any outstanding requests and this would
  identify that control was on the other side. The AZTS abend
  would then have been produced by DFHTFP and not at Syncpoint.
  
  Additional keywords
  TCTEERT RFLUSH TFPNLUC TFPNLUC5 ABENDAZI9 IRC FORCEPURGE
  MSGDFHAP0002 DFHAP0002 MSGDFHRM0002 DFHRM0002
  

Problem conclusion

• DFHTFP has been amended to cancel the deferred WRITE request in
  the surrogate TCTTE when the relay link is MRO.
  

Temporary fix

•             *********
              * HIPER *
              *********
  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:

  PM92728 UI11649

Modules/Macros

•    DFHTFP
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R700 PSY UI11649

     UP13/11/01 P F310

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.