PK65870: OPENAPI WITH CPIC CALL CAN PRODUCE DFHDS0002 SEVERE ERROR CODE X'0204' HAS OCCURRRED IN MODULE DFHDSTCB

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Running OPENAPI and the application program is issuing a CPIC
  call and is running ABTERM_ALLOWED(ABTERM_YES).   The CPIC call
  invokes the CPI-C interface and eventually DFHKELCL tries to
  allocate a stack entry in the current SMODE(24) segment for the
  task.  Because there is no more space in the current SMODE(24)
  segment or the free segments, or the KCB_SEG24_FIRST_FREE, a
  GETMAIN of a new segment from the KESTK24E subpool is issued.
  If the SMLOCK is held the GETMAIN gets suspended.  This is all
  occuring with ABTERM_ALLOWED(ABTERM_YES).
     ABTERM_ALLOWED(ABTERM_YES) never gets changed to
  ABTERM_ALLOWED(ABTERM_NO) as we have not reached the DFHAPEVI
  SWITCH_TO_CICS macro in DFHCPI.  Thus causing the DFHDS0002
  severe error code X'0204'.
  .
  DTA +x'44' shows TASK_STATE =05
  (RUNNING_ABTERM_ALLOWED = 4 and RUNNING_ABTERM_NOT_ALLOWED = 2)
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHDS0002 severe error code X'0204' in  *
  *                      module DFHDSTCB due to DSTCB_INVALID_   *
  *                      ABTERM.                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An OPENAPI task running on an L8 TCB issues a CPIC call.
  This results in DFHCPI being called via DFHCPLC (the CPIC
  stub). DFHCPI requires a stack entry in the SMODE(24)
  segment, but there is no space in the current SMODE(24) entry
  nor any free segments. DFHCPI therefore
  issues a getmain for a new segment from the KESTK24E subpool,
  but this gets suspended on the SMLOCK.
  Unfortunately, at this point the task is still in state
  RUNNING_ABTERM_ALLOWED which causes the DFHDS0002 severe error
  code X'0204' on return from the SUSPEND. A Suspend should not
  be issued with ABTERM_ALLOWED, and the task will hang forever
  in state RESUMED_EARLY.
  
  Additional Keywords: DSTCB_INVALID_ABTERM TAS_FREE_SEGS_24
  KCB_SEG24_FIRST_FREE
  

Problem conclusion

• DFHCPI has been altered to use SMODE(31) and so any getmains
  required for stack storage will be made by MVS and not involve
  a SUSPEND.
  

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:

  UK37952 UK37953

Modules/Macros

•    DFHCPI
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK37952

     UP08/07/12 P F807

• R500 PSY UK37953

     UP08/07/12 P F807

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.