A fix is available
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
10 March 2017