PI83321: 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
  .
  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:

  PI79484

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

  UI49020 UI49021

Modules/Macros

• DFHSOAD  DFHSOCK  DFHSODM  DFHSODUF DFHSOIS  DFHSOL   DFHSOLI
  DFHSOLS  DFHSOLX  DFHSOLX6 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

• R100 PSY UI49020

     UP17/07/29 P F707

• R10D PSY UI49021

     UP17/08/02 P F707

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.