PM26280: DFHDS0002 SEVERE ERROR (CODE X'0204') AFTER PURGE WHILE IN DB2

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A SOAP application is running in CICS and issues SQL calls. The
  task is purged while control is in DB2 and receives error:
  .
  DFHDS0002 A severe error (code X'0204') has occurred in
            module DFHDSTCB.
  .
  The task then hangs in a RESUMED_EARLY state. After the task is
  purged, it's L8 TCB is set unclean and deleted. But pipeline
  logic doesn't know that the L8 TCB has gone away. During
  recovery, DFHPITP isses an EXEC CICS SOAPFAULT_CREATE. Because
  the task is already running on the QR TCB, DFHEIP does not turn
  off the ABTERM_ALLOWED bit.  The Kernel stacks show that DFHPISF
  is processing the SOAPFAULT_CREATE and issues a GETMAIN. The
  task is suspended because the SMLOCK is not available and it is
  at this point that Dispatcher detects that the task is in an
  invalid state, running ABTERM_ALLOWED on the QR TCB, so the
  error DSTCB_INVALID_ABTERM is issued with the DFHDS0002 0204.
  .
  Additional Symptom(s) Search Keyword(s):
  KIXREVSVR   Trace also shows exception entry:
  .
  PI 100D PITL *EXC* - TARGET_LINK_ABENDED -
                       FUNCTION(PROCESS_SOAP_REQUEST)
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: A web services request is made that     *
  *                      prompts an SQL call to DB2, during      *
  *                      which the task is purged.               *
  *                      A DFHDS0002 severe error (X'0204')      *
  *                      occurs in module DFHDSTCB and the task  *
  *                      is hung RESUMED_EARLY.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When a SOAP request is made with a SQL call to DB2, the task is
  running on an L8 TCB. If the task is purged, then DFHPITL and
  DFHPITP assume that the task is still running on the L8 TCB
  when attempting a SOAPFAULT create. ABTERM_ALLOWED is being set
  to ABTERM_YES, which is inappropriate as the SOAPFAULT_CREATE
  is now being processed on the QR TCB.
  This results in the severe error x'0204' DSTCB_INVALID_ABTERM.
  

Problem conclusion

• DFHPITL AND DFHPITP have been changed so the ABTERM_ALLOWED
  state is only set to ABTERM_YES when a task is executing on
  its original L8 TCB.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM18911

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

  UK62681

Modules/Macros

•    DESPITL  DFHPITL  DFHPITP
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK62681

     UP10/12/04 P F012

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.