PK32511: ADD CALLS IN DFHPITP TO SET THE TASK ABTERM_NO BEFORE THE LAST 2 BACKOUT_UOW CALLS AND THEN SET THE TASK BA 06/11/01 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The 3rd call in DFHPITP at sequence 7146900 which doesn't have
  the code to turn off ABTERM_YES before this BACKOT_UOW call.
  DFHDSTCB throws out the request with trace entry
  TCB L8003 DS 0204 DSTCB *EXC* DSTCB_INVALID_ABTERM
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHDS0002 A severe error (code X'0204') *
  *                      has occurred in module DFHDSTCB.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If a CICS application program is run as a webservice, DFHPITP
  (the CICS SOAP Application Handler) is executed as part of the
  processing. DFHPITP is defined as OPENAPI and so runs under an
  L8 TCB with the transaction's purgeable status set to
  ABTERM_ALLOWED(YES). DFHPITP does a PROCESS_SOAP_REQUEST call
  and the CICS application is driven. If the application abends,
  a response of target_abended is returned.
  
  With the PTF for PK23547 applied (UK15764), DFHPITP processes
  the error by backing out the unit of work via a DFHRMUWM
  BACKOUT_UOW call. This eventually results in a dispatcher
  WAIT_MVS for the logger, but the dispatcher code requires an
  ABTERM_ALLOWED setting of NO and so issues MSGDFHDS0002 code
  0204 (INVALID_ABTERM). CICS then goes into an indefinite wait
  because the transaction holds the DFHLOG lock.
  
  The same problem will occur if the response to DFHPITP is
  vendor_soapfault_outbound, because this also causes a UOW
  backout.
  
  Additional keywords: DS0002 DFHDS0002 abendDS0002 pipeline
  soapfault pitl_target_abended pitl_vendor_soapfault_outbound
  DFHDSTCB DSTCB_INVALID_ABTERM TARGET_LINK_ABENDED
  

Problem conclusion

• UK15764 UK16029 UK16633
  DFHPITP has been altered to set abterm_allowed to ABTERM_NO
  before the BACKOUT_UOW call, then restore it to ABTERM_YES
  after the call.
  

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:

  UK19372

Modules/Macros

•    DFHPITP
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK19372

     UP06/11/29 P F611

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.