IBM Support

PI76583: 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.                           *
    ****************************************************************
    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

Comments

APAR Information

  • APAR number

    PI76583

  • Reported component name

    CICSTS FOR ZVSE

  • Reported component ID

    5655VSE00

  • Reported release

    B2P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-02-14

  • Closed date

    2017-03-02

  • Last modified date

    2017-04-07

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

    PI70530

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

Modules/Macros

  • DFHSOCK
    

Fix information

  • Fixed component name

    CICSTS FOR ZVSE

  • Fixed component ID

    5655VSE00

Applicable component levels

  • RB2P PSY UI45207

       UP17/04/07 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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG32M","label":"APARs - VSE\/ESA environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
07 April 2017