IBM Support

PM25851: CICS HANGS AT SHUTDOWN WAITING ON SOA_LTE_EMPTY_ECB.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CICS hangs at shutdown waiting on SOA_LTE_EMPTY_ECB.
    The hang occurs because several STEs associated with an
    ECI TCPIPSERVICE are orphaned after a client disconnects
    before CICS has sent the application response.
    Additional Symptom(s) Search Keyword(s):
    KIXREVCTC
    

Local fix

  • Manually IMMCLOSE the TCPIPSERVICE before shutdown.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS hangs during a normal shutdown if  *
    *                      there are closed sockets that have not  *
    *                      been removed from an ECI TCPIPSERVICE.  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    During shutdown, DFHSODM waits on the SOA_LTE_EMPTY_ECB which is
    only posted when the last TCPIPSERVICE is removed. The sockets
    listener is posted by DFHSODM to quiesce listener activity
    during shutdown. This will close all the listener sockets for
    open TCPIPSERVICEs. However, ECI client sockets associated
    with the TCPIPSERVICEs may be still attached in a closed state.
    The TCPIPSERVICE associated with these sockets is only removed
    when these client sockets are deleted from the TCPIPSERVICE by
    CICS. This never happens, so DFHSODM waits indefinitely on
    SOA_LTE_EMPTY_ECB.
    
    DFHPD410 DS=1 shows the following wait state:
    
      RESOURCE RESOURCE_NAME
      TYPE
      SODOMAIN SO_LTEPTY
    
    SO=1 shows something like this:
    
    Port  Sock Service  Tran SSL Flags     IP Address      STE
    nnnn    nn xxxxxxxx CIEP NO    ABLGCD  INADDR_ANY        n
    
    Port Flags    Send ECB Recv ECB Client IP Addr  I/O      Task
         GTC      00008000 00008000 nnn.nnn.n.nnn   Closed   nnnnn
    
    Each STE shows AIORV FFFFFFFF AIORC 00000461 (ECONNRESET) in the
    ste_sAioCb and/or ste_rAioCb STE fields.
    
    The code in DFHIEIE delete_client must avoid calling procedure
    abend_conversation, which may result in the DFHSOCKI DELETE
    call being performed to delete the socket and remove it from
    the TCPIPSERVICE.
    
    If the TCPIPSERVICE is manually closed using IMMCLOSE, CICS will
    shutdown normally.
    

Problem conclusion

  • DFHIEIE has been changed to avoid the possibility that the
    DFHSOCKI DELETE call can be missed, ensuring that the closed
    socket is removed from the TCPIPSERVICE.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM25851

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-11-03

  • Closed date

    2011-01-26

  • Last modified date

    2011-07-19

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

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

    UK64258

Modules/Macros

  •    DESIEIE  DFHIEIE  DFHIEP
    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK64258

       UP11/01/31 P E431

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
19 July 2011