PI48689: DFHDS0002 A SEVERE ERROR (CODE X'0204') HAS OCCURRED IN MODULE DFHDSTCB AFTER MIGRATING FROM CICS TS 4.1 TO CICS TS 5.1

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Migrated from CICS TS 4.1 to CICS TS 5.1 and started seeing the
  following message.
  
  DFHDS0002 CICSREGN A severe error (code X'0204') has occurred
  in module DFHDSTCB
  
  This looks to be a problem at CICS/TS 5.1 and for an OPENAPI
  program that does DLI calls and that DLI call from an OPENAPI
  program is the first DLI call made in this run of CICS.
  
  When that DLI call enters DFHEIP, at CICS/TS 5.1, there is no
  DFHAPEVI SWITCH_TO_CICS that would change the state to
  Running_Abterm_Not_Allowed.  So control goes to DFHERM and when
  the DLI subpool is added and the task suspends on a catalog
  call, you get the DFHDS0002 0204 because this suspend is while
  Running_Abterm_Allowed.
  
  Here, the switch-to-cics is skipped only on the specific case
  of a RMCAL SYNCPOINT.
  
  Additional Symptom(s) Search Keyword(s): KIXREVDAM
  kixdcfcic680
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When the first DLI call from an         *
  *                      OPENAPI program is executed the         *
  *                      call leads to message DFHDS0002         *
  *                      being issued along with a dump.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Upon CICS being started, an OPENAPI program that contains DLI
  calls is executed. When the DLI call is issued, if it is the
  first DLI call to be executed in this run of CICS, then message
  DFHDS0002 A severe error (code X'0204') has occurred in module
  DFHDSTCB will be issued. This will be accompanied with a DS0002
  dump.
  
  The severe error occurs because the task running the OPENAPI
  program will attempt to add a subpool for DLI, which will
  require that the task suspends on a catalog call. This suspend
  occurs while abterm_yes is set (Running_Abterm_Allowed) when it
  is expecting abterm_no to be set.
  
  Additional Keywords: msgDFHDS0002 DL/I IMS DL1
  

Problem conclusion

• DFHEIP has been altered so that DLI calls will execute the code
  at label EICC23AA so that a switch to CICS occurs which will
  result in abterm_no being set on.
  

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:

  UI32900

Modules/Macros

• DFHEIP
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI32900

     UP15/11/20 P F511

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.