IBM Support

PM15545: TRANSACTION CSOL ABENDS ASOL AFTER RECEIVING PROGRAM CHECKS IN DFHSOS23, DFHSOS05 AND DFHSOS03.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
SC34644306GC34690502SC34682803GC34686402 

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