IBM Support

PM05268: CICS SHUTDOWN HANGS DUE TO THE SOCKET DOMAIN NOT QUIESCING

A fix is available

Subscribe

You can track all active APARs for this component.

 

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