IBM Support

PK85944: CSOL LISTENER STOPS ISSUING ACCEPTS FOR NEW REQUESTS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CSOL stops issuing ACCEPT to TCPIP once a non-zero return code
    is received from TCP/IP on the ACCEPT.
    This APAR is similar to PK47844 and PK51049 on z/OS.
    
    Additional Symptom(s) Search Keyword(s):
    KIXREVSCB
    MAXSOCKETs JRMAXSOCKETS TCP IP
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: The ACCEPT call for a TCPIPSERVICE      *
    *                      fails and is not re-issued by CICS.     *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The CICS TCPIP listener task (CSOL) processes incoming
    connections via an outstanding ACCEPT. After processing the
    connection it issues another ACCEPT waiting for more work.
    This ACCEPT fails leaving the listener task unable to
    accept further connections for this TCPIPSERVICE.
    
    A CEMT INQUIRE TCPIPSERVICE will show that the TCPIPSERVICE is
    open, but user requests will not be processed until the
    TCPIPSERVICE is closed and re-opened.
    
    Please note that the same symptom will occur if TCP/IP does
    not issue a POST for the ACCEPT after ABORT processing that
    may result from a browser RESET. TCP/IP may need to be
    restarted in this case to enable the TCPIPSERVICE to function
    correctly.
    

Problem conclusion

  • DFHSOCK has been amended to issue a new message, DFHSO0130,
    and deregister the TCPIPSERVICE, when a non-zero return code
    is passed back from a BPX1AIO ACCEPT call.
    
    The CICS Transaction Server for VSE/ESA V1.1 Messages and
    Codes GC34-5561-08 will be updated to include the new message
    DFHSO0130 inserted at page 338 after message DFHSO0129A
    as follows:
    
    DFHSO0130  DATE TIME APPLID  A TCPIP ACCEPT
              call has failed. The TCPIPSERVICE
               TCPIPSERVICE  on port  PORTNUMBER  , at
              IP address  IPADDRESS  will be closed. The
              values returned are bpx_return_value(  BPX
              RETURN VALUE  ), bpx_return_code(
               BPX_RETURN_CODE  ), and bpx_reason_code(
               BPX_REASON_CODE  ).
    
    EXPLANATION:  A TCP/IP ACCEPT call has returned an error.
    
    SYSTEM ACTION:  An exception trace entry is made in the
    trace table.  No system dump is taken, unless you have
    specifically requested a dump in the dump table.
    CICS continues unless you have specified in the dump table
    that CICS should terminate.
    
    The TCPIPSERVICE  tcpipservice  on port  portnumber
    at the specified IP address is shutdown. When this shutdown
    is complete message DFHSO0108 is issued.
    
    The return value, return code and reason code reported by
    TCP/IP are displayed to aid with diagnostics.
    
    USER RESPONSE:  Determine the reason for the ACCEPT
    failure. The return code and reason code included in the
    message text are described in the z/OS UNIX System Services
    Messages and Codes manual under the asyncio (BPX1AIO)
    callable service description.
    
    Check the system console for any messages issued by TCP/IP
    and take the recovery action indicated.
    
    The TCPIPSERVICE  tcpipservice  is closed, and after the
    TCP/IP problem has been resolved, the closed TCPIPSERVICE
    should be reopened.
    
    DESTINATION:  Console
    
    MODULE:  DFHSOCK
    
    XMEOUT Parameters: date, time, applid, tcpipservice, portnumber,
    ipaddress, bpx return value, bpx_return_code, bpx_reason_code
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK85944

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-05-05

  • Closed date

    2009-05-28

  • Last modified date

    2010-03-24

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

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

    UK47047

Modules/Macros

  •    DESSOAN  DESSOCK  DFHMESOC DFHMESOE DFHMESOG
    DFHMESOK DFHSOCK  DFHSODCC DFHSODCD MFHMESOE
    

Publications Referenced
GC34556108    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK47047

       UP09/06/02 P E422

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:
24 March 2010