PI79484: SHUTDOWN OF CICS HANGS WAITING FOR S8 TCB TO BE CREATED BUT IPT TCB IS MISSING

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During a normal shutdown of CICS, the region hung and had to be
  cancelled.
  
  The DS domain is in a DMWTQUEU wait state which occurs when the
  quiescing of a CICS domain has not yet completed.  It is
  waiting for the SO domain to complete its quiesce.  The SO
  domain is in a LMQUEUE wait trying to acquire the DSITLOCK
  exclusively.  The owner of this lock is a task which called
  DFHSOPL fo a CLOSE_SOCKET_IN_POOL request.  DFHSOPL gets the
  SOMGLOCK Exclusively in this process.  DFHSOSE is then called
  for SECURE_SOC_CLOSE which will eventually call DFHDSAT for
  CHANGE_MODE.  The task is then switched to the SP TCB to create
  a new pthread for the new TCB.  DFHLEPT running on the SP TCB
  has gone into a wait out of lept_create_pthread.
  .
  This task is waiting for the SP TCBs IPT Thread to create an S8
  TCB so it can complete the SECURE_SOC_CLOSE.  But the IPT TCB
  is no longer there.
  .
  In addition, the following failure may occur:
  DFHSO0001 ABEND 0C1/AKEA in module DFHSODS
  .
  Or CICS shutdown might be almost all the way down and then
  the TI task, running on the SO TCB to handle a NOTIFY event,
  takes error:
  .
  DFHKE0002 A severe error (code X'0504') has occurred in module
   DFHKEDS.
  .
  This error occurs trying to CHANGE_MODE but the DS and SO
  domains have already quiesced. (CHANGE_MODE_ERROR)
  Additional Symptom(s) Search Keyword(s): KIXREVCTC
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS hangs during shutdown when an      *
  *                      outbound socket times out.              *
  ****************************************************************
  * RECOMMENDATION: .                                            *
  ****************************************************************
  A URIMAP with USAGE(CLIENT) SCHEME(HTTPS) and a non-zero
  SOCKETCLOSE value is installed.  This causes outbound
  connection pooling to be in use for all connections using this
  URIMAP.
  
  When CICS is shut down at least 1 socket remains in the outbound
  connection pool.  The SOCKETCLOSE time expires for this socket
  at the same time that DFHSODM is terminating the CICS SSL
  environment.  The timing of these events means that the TI
  task holds the DSITLOCK and gets stuck waiting for an S8 TCB
  to be created.  DFHSODM is in the process of deleting the SP TCB
  and it suspends waiting for the DSITLOCK.  The request to create
  a new S8 TCB will never complete, because the SSL environment
  has been terminated, and so CICS shutdown hangs.
  

Problem conclusion

• DFHSODM and DFHSOPL have been changed to explicitly close all
  sockets within outbound connection pools before terminating
  the SSL environment.
  

Temporary fix

Comments

APAR Information

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

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

  UI48057 UI48058 UI48060 UI48061 PI83321

Modules/Macros

• DFHSOAD  DFHSOCK  DFHSODM  DFHSODUF DFHSOIS  DFHSOL   DFHSOLI
  DFHSOLS  DFHSOLX  DFHSOM01 DFHSOM02 DFHSOM03 DFHSOPL  DFHSOPLT
  DFHSORD  DFHSOS00 DFHSOS01 DFHSOS02 DFHSOS03 DFHSOS04 DFHSOS05
  DFHSOS06 DFHSOS07 DFHSOS08 DFHSOS09 DFHSOS10 DFHSOS11 DFHSOS12
  DFHSOS13 DFHSOS14 DFHSOS15 DFHSOS16 DFHSOS17 DFHSOS18 DFHSOS19
  DFHSOS20 DFHSOS21 DFHSOS22 DFHSOS23 DFHSOSE  DFHSOST  DFHSOTB
  DFHSOTI  DFHSOTRI DFHSOUE  DFHSOXM  DFHWBCL  DFHWBSC  DFHWBUR
  DFJ@H360
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI48057

     UP17/06/17 P F706

• R00D PSY UI48058

     UP17/06/17 P F706

• R900 PSY UI48060

     UP17/06/17 P F706

• R90D PSY UI48061

     UP17/06/17 P F706

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.