PK25998: SOCKETS LEFT IN CLOSEWAIT STATE IF USER NOT KNOWN TO RACF. THIS CAN TIE UP ALL SOCKETS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using HTTP with SSL, and the user is not known to RACF,
  the socket remains in a status of CLOSEWAIT.  The socket remains
  in this status and CICS can eventually run out of sockets.  The
  CSOL task is unable to CLOSE SOCKET. The SOCKET CLOSE request
  does not complete because there is a RESERVED on the socket.
  The socket remains in this reserved state.
  The CWBA task should remove the RESERVED at syncpoint.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: When running a web based transaction    *
  *                      on a socket,  after completion of the   *
  *                      transaction the socket will remain in   *
  *                      CLOSEWAIT state and never CLOSE.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When an HTTP request is received by CICS where the USERID has
  been changed to one unknown to the ESM wber_error_code is set
  to wbep_security_invalid_userid in DFHWBXM.
  A socket has been reserved for a request, but the ESTABLISH
  has not yet been issued. Therefore when the task terminates,
  the socket is still reserved so will not be closed. The client
  attempts to close the connection, but CICS is still reserving
  the socket so cannot close it, leaving it in a CLOSEWAIT state.
  

Problem conclusion

• When DFHWBXM, BIND_XM_CLIENT detects a non-zero error in
  wrb_error_code it will issue a socket ESTABLISH prior to
  calling Webrequest_tidyup, allowing the socket to be closed
  at task termination.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK17706

Modules/Macros

•    DESWBAP  DESWBDM  DESWBSR  DESWBXM  DFHWBAP
  DFHWBAPA DFHWBAPF DFHWBAPJ DFHWBAPM DFHWBAPT DFHWBAPV DFHWBDM
  DFHWBSR  DFHWBSRA DFHWBSRM DFHWBSRT DFHWBXM  DFHWBXMA DFHWBXMT
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK17706

     UP06/09/06 P F609

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.