A fix is available
APAR status
Closed as program error.
Error description
Your CICS region's shutdown is not able to complete. The DS domain is in a DMWTQUEU wait state. This happens because the SO domain has a task in a SODOMAIN SO_LTEPTY wait state. The dump shows an STE and LTE still remain in the SO domain. The SO Domain will not shutdown normally until the STE and LTE are removed from the domain. The CSOL task has the responsibility of closing and removing the STEs at shutdown, and posting the SOA_LTE_EMPTY_ECB status. However, the CSOL task is not running at this time in the process and the result is a shutdown hang. This hang cannot be freed until the region is cancelled. ADDITIONAL KEYWORDS: KIXREVRJS
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: Shutdown hang with domain termination * * task waiting for SOA_LTE_EMPTY_ECB to * * be posted ( SODOMAIN SO_LTEPTY ). * **************************************************************** * RECOMMENDATION: * **************************************************************** A CICS system with an ECI TCPIPSERVICE which has an active CTG connection is shutdown NORMALLY. DFHSODM POSTs the sockets listener task ( CSOL ) to perform a QUIESCE of socket activity. DFHSODM waits on ECB SOA_LTE_EMPTY_ECB which will be posted when all socket activity has QUIESCED. CSOL finds that there is a CTG socket for which synchronous socket I/O has been initiated by another ( CIEP ) task. CSOL is unable to remove this socket immediately so sets the terminated flag in the socket object. This will cause the socket to be closed and deleted later by the CIEP task. CSOL completes QUIESCE processing but SOA_LTE_EMPTY_ECB cannot be posted straight away because of the socket which is being used by the CIEP task. CSOL now detects that a new socket connection has arrived for the CTG TCPIPSERVICE. This connection was queued just as the TCPIPSERVICE started to be QUIESCED. CSOL creates a new socket object for this connection and attaches a new CIEP task. CSOL now terminates. The CIEP task which owns the old socket with the terminated flag on closes and deletes this old socket. The CIEP task which owns the new socket completes without closing its socket because the terminated flag was never set for this new socket. As this socket is never closed and deleted, the SOA_LTE_EMPTY_ECB is never posted. . In addition, after the new socket is created following CSOL QUIESCE processing an ASYNC ACCEPT is issued for a TCPIPSERVICE for which the listener socket has been closed. This leads to :- DFHSO0130 - A TCP/IP ACCEPT call has failed. DFHSO0106 - An OpenEdition Assembler Callable Service error (code X'0C39') has occurred in module DFHSOLS. A system dump - dumpcode SO0002 is also taken. ADDITIONAL KEYWORDS :- msgDFHSO0130 msgDFHSO0106
Problem conclusion
DFHSOS23 has been changed to detect if a new socket connection for an ECI TCPIPSERVICE is being processed at the time that CSOL has been driven for QUIESCE processing. If this occurs, the socket is closed and deleted. In addition, DFHSOLS has been changed to bypass ASYNC ACCEPT processing for a TCPIPSERVICE if the listener socket has been closed.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM05268
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-01-15
Closed date
2010-03-30
Last modified date
2010-05-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM10740 UK55731
Modules/Macros
DESSOLS DESSOSO DFHSOLS DFHSOSOC DFHSOS00 DFHSOS01 DFHSOS02 DFHSOS03 DFHSOS04 DFHSOS05 DFHSOS06 DFHSOS07 DFHSOS08 DFHSOS09 DFHSOS10 DFHSOS11 DFHSOS12 DFHSOS13 DFHSOS14 DFHSOS15 DFHSOS16 DFHSOS17 DFHSOS18 DFHSOS19 DFHSOS20 DFHSOS21 DFHSOS22 DFHSOS23
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK55731
UP10/04/02 P F004
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 May 2010