A fix is available
APAR status
Closed as program error.
Error description
You receive the following string of abends and messages: DFHSO0106 An OpenEdition Assembler Callable Service error (code X'0C36') has occurred in module DFHSOLS. DFHSO0001 An abend (code 0C4/AKEA) has occurred at offset X'0182' in module DFHSOS23. DFHSO0001 An abend (code 0C4/AKEA) has occurred at offset X'02EA' in module DFHSOS05. DFHSO0002 A severe error (code X'0C33') has occurred in module DFHSOLS. DFHSO0001 An abend (code 0C4/AKEA) has occurred at offset X'0260' in module DFHSOS03. . This will eventually lead to the CICS Socket Listener transaction CSOL terminating with an abend ASOL. . Looking at a dump for the first message, DFHSO0106, you'll see an exception trace entry. Looking at data area 1, the 2nd word contains a return code from Unix System services. A x'71' means EBADF The file Descriptor was incorrect. . Going to the socket domain to look at the AIOCB in the SOLTE for the tcpipservice having a problem, you notice that it was in an async accept and had gotten a x'7F' return code from USS meaning ENFILE. The ENFILE means that the global OMVS MAXSOCKETS limit set by the NETWORK DOMAINNAME(AF_INET) statement was breeched. . If the system is not at the global limit when ASYNC ACCEPT is issued and a new connection causes the limit to be reached, CICS fails to detect the error and proceeds as if the new socket connection has arrived. Additional Symptoms: 0C36 0C33 bpx_return_code 71 113 KIXREVSCB
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users * **************************************************************** * PROBLEM DESCRIPTION: TCPIPSERVICE stops working but still * * appears to be open. * **************************************************************** * RECOMMENDATION: * **************************************************************** An asynchronous ACCEPT for a TCPIPSERVICE completes with an AIORV of -1 and an AIORC of X'7F' (ENFILE). This occurred when the system wide socket limit was breached. The sockets listener task suffered a series of severe error messages and multiple system dumps. The CSOL task then abends with abend code ASOL. From this point onwards, the TCPIPSERVICE is marked as OPEN but no new connections are possible even if the TCP/IP stack becomes available again. ADDITIONAL KEYWORDS :- DFHSO0106 MSGDFHSO0106 SO0106 DFHSO0001 MSGDFHSO0001 SO0001 DFHSO0002 MSGDFHSO0002 SO0002 0C36 0182 0C33 AKEA 0C4 S0C4 ABEND0C4 ABENDS0C4 ABENDASOL
Problem conclusion
DFHSOLS has been altered to switch on a new flag lte_ENFILE when an ASYNC ACCEPT fails with ENFILE. If this flag is on then the TCPIPSERVICE is closed immediately and DFHSO0102 issued. A new trace id tid_sols_ENFILE_received (X'0C64') is used. DFHSOTRI is also changed to interpret this new exception trace. The CICS TS 3.1 Trace Entries ( SC34644306 ) will be updated. In chapter 36 (Socket domain trace points), the following new entry will be added :- Point ID Module Lvl Type Data SO 0C64 DFHSOLS Exc ENFILE received 1 bpx_interface 2 LTE The CICS Transaction Server for z/OS CICS Supplementary Data Areas Version 3 Release 1 manual ( GC34690502 ) will be updated in the SOA (Sockets Anchor Block) to include the following value for LTE_FLAG2: (51) BITSTRING 1 LTE_FLAG2 .... 1... LTE_ENFILE ENFILE received The CICS TS 3.2 Trace Entries ( SC34682803 ) will be updated. In chapter 37 (Socket domain trace points), the following new entry will be added :- Point ID Module Lvl Type Data SO 0C64 DFHSOLS Exc ENFILE received 1 bpx_interface 2 LTE The CICS Transaction Server for z/OS CICS Supplementary Data Areas Version 3 Release 2 manual ( GC34686402 ) will be updated in the SOA (Sockets Anchor Block) to include the following value for LTE_FLAG2: (41) BITSTRING 1 LTE_FLAG2 .... 1... LTE_ENFILE ENFILE received
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM15545
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2010-05-28
Closed date
2010-07-19
Last modified date
2010-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM17980 UK58912 UK58913 UK58914 UK58915
Modules/Macros
DESSOAN DESSOLS DESSOTRI DFHSOANC DFHSOAND DFHSOANH DFHSOCCC DFHSODCC DFHSOLS DFHSOTRI
SC34644306 | GC34690502 | SC34682803 | GC34686402 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R400 PSY UK58912
UP10/07/23 P F007
R500 PSY UK58914
UP10/07/23 P F007
R403 PSN UP
AM15545
R503 PSN UP
AM15545
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.1","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.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 August 2010