PH10947: SOCKET COUNTS NOT DECREMENTED AFTER CLIENT CLOSES CONNECTION 19/04/15 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Orphaned sockets whose SOCKETCLOSE value is expired are
  building up and affecting the CICS region.  The associated
  TCPIPSERVICE must be closed (IMMCLOSE) and reopened to rid the
  region of the orphaned sockets.
  
  CICS reports the following:
  DFHSO1002 BPX Retcode=1,124  RSNcode=x'77B77221'
  
  Trace shows:
  GETSOCKNAME_FAILURE with return code of 1124 and reason code
  749B0000.
  The 1124 return code means ENOTCONN (socket not connected).
  
  Additional Symptom(s) Search Keyword(s): KIXREVSCB
  

Local fix

• Immediate close the affected TCPIPSERVICE.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users with APAR PH01925 applied.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Sockets are not being closed after the  *
  *                      SOCKETCLOSE interval has expired        *
  *                      following message DFHSO1002 being       *
  *                      issued.                                 *
  ****************************************************************
  A client connects to a CICS region that has an ATTLSAWARE
  TCPIPSERVICE and is assigned a socket descriptor on the SL TCB
  with the same descriptor number as an active socket on the SO
  TCB. The client then disconnects before the Socket Listener task
  (CSOL) has issued BPXIGNM to obtain the local and remote IP
  address and port information for the connection.
  
  CSOL then makes a UNIX SIOCTTLSCTL call to ATTLS to establish
  the state of the connection. As part of issuing message
  DFHSO1002 to report the ENOTCONN response to this call, CICS
  switches to the SO TCB and incorrectly references the socket
  descriptor with the matching number. This causes problems with
  assignment of socket descriptors in later processing, eventually
  leaving CICS with a socket that is not closed after the
  SOCKETCLOSE interval has expired. Repeated instances of the
  error lead to a build up of these sockets.
  
  Additional keywords: SO1002 MSGDFHSO1002
  

Problem conclusion

• UI59537
  CICS has been changed so CSOL checks if the remote IP address
  information is available when issuing message DFHSO1002. If not
  the string 'UNKNOWN' is used rather than switching to the SO TCB
  and potentially accessing the wrong socket descriptor.
  This correction allows subsequent assignment of socket
  descriptors to proceed normally with sockets being closed after
  the SOCKETCLOSE interval expires.
  

Temporary fix

Comments

APAR Information

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

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

  UI64368 UI64369

Modules/Macros

• DFHMESOC DFHMESOE DFHMESOK DFHSOLS  DFHSOTRI
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI64368

     UP19/07/24 P F907 {

• R200 PSY UI64369

     UP19/07/24 P F907 {

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.