IBM Support

PI70530: DFHSO0106 WITH ERROR (CODE X'0236') DURING SHUTDOWN OF CICS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CICS has at least one TCPIPSERVICE open.  When CICS is
    shutdown the CSOL task is used to close the TCPIPSERVICE
    listener socket.  If a new connection is made to CICS after the
    shutdown process has begun, but before the listener socket is
    closed then CICS will still try to process that new connection
    request.
    
    In this situation a givesocket call then fails with EINVAL and
    the following message and dump is taken;
    DFHSO0106 Error (Code X'0236') of Language Environment Callable
    Service in Modul DFHSOCK.
    

Local fix

  • Close TCP/IP (cemt s tcpip clo) before shutdown.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message DFHSO0106 A Language            *
    *                      Environment Callable Service error      *
    *                      (code X'0236') has occurred in module   *
    *                      DFHSOCK is issued during a TCPIPSERVICE *
    *                      being closed.                           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A new connection comes into CICS for a TCPIPSERVICE which is
    being closed (either CLOSE or IMMCLOSE) or during CICS shutdown
    or during TCPIP CLOSE processing. When this happens, an LTE
    control block is added to the SOA_CONN_CHAIN_HEAD_PTR chain.
    This LTE is freemained when the TCPIPSERVICE is terminated but
    the CICS listener task (CSOL) still proceeds to process the new
    connection. This leads to msgDFHSO0106 being issued.
    
    Additional Keywords: SO0106 0236
    

Problem conclusion

  • DFHSOCK has been changed to ensure that when an LTE control
    block is freemained, it is first removed from the chain of
    LTE blocks anchored from SOA_CONN_CHAIN_HEAD_PTR (assuming it is
    on the chain).
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI70530

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-10-12

  • Closed date

    2017-03-02

  • Last modified date

    2017-03-10

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

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

    PI76583 UI45208

Modules/Macros

  • DFHSOCK  DFHSOCKT
    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UI45208

       UP17/03/10 I 1000

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:
10 March 2017