PK07285: DFHDS0002 A SEVERE ERROR (CODE X'0204') HAS OCCURRED IN MODULE DFHDSTCB

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Transaction hangs up and then a number of other transactions
  hang also, waiting on DFHLOG.
  DFHPITL has called DFHRMUW ENTRY BACKOUT_UOW which resulted in a
  DFHDSSR WAIT_MVS LGWRITE,0F9511A4,NO,IO,YES,DFHLOG when the task
  running under an open L8 TCB and the task was set to ABTERM_YES
  The task should have been set to ABTERM_NO prior to the DSSR
  WAIT.
  Additional keywords: RESUMED_EARLY
  

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. In this case the
  application program's commarea should have included a zoned
  decimal field, but on exit from the application this field
  contained invalid data, resulting in a CONVERSION_ERROR when
  DFHPIII attempted to move the data into the outbound XML that
  described the commarea.
  DFHPITP processed the error by creating a SOAPFAULT and then
  backing out the UOW via a DFHRMUWM BACKOUT_UOW call. This
  eventually resulted in a dispatcher WAIT_MVS for the logger,
  but the dispatcher code requires an ABTERM_ALLOWED setting of
  NO and so issued MSGDFHDS0002 code 0204 (INVALID_ABTERM).
  CICS then went into an indefinite wait because the
  transaction held the DFHLOG lock.
  
  The same problem will occur if the outbound soap message
  is found to contain invalid XML, because this also causes
  DFHPITP to backout the UOW.
  Additional keywords: DS0002 abendDS0002
  pitl_conv_to_soap_failed pitl_outbound_validation_failed
  pipeline
  

Problem conclusion

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

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:

  UK06884

Modules/Macros

•    DFHPITP
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK06884

     UP05/09/07 P F509

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.