PM87535: CICS SOCKETS: PGIV ELEMENTS NOT CLEANED UP WHEN BTL STORAGE IS DEPLETED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When all of BTL storage is depleted, an abend S878 can occur in
  an application ASID. The sockets transform task level resource
  manager (EZBSORM1) is responsible for performing a TERMAPI to
  close any open sockets and also remove PGIV elements for sockets
  that have been given but not yet taken. The resource manager
  parameter list (RMPL) is allocated in subpool 255 (LSQA) which
  resides in BTL storage. A depletion of the latter can prevent
  the task level resource manager from being called.  As a
  consequence, PGIV element(s) may become stranded, and
  subsequent TAKESOCKET calls may fail with ebadf or einval.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of the IBM Communications Server                   *
  * for z/OS Version 2 Release 1 IP:                             *
  * Sockets API programming                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * PGIV elements not freed after                                *
  * BTL storage exhaustion.                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply PTF                                                    *
  ****************************************************************
  An application listener issued a GIVESOCKET call to pass
  a client connection request to a child server subtask. A
  PGIV element was created to represent the GIVESOCKET call.
  The application address space abended (s878) before the
  child server subtask could issue a TAKESOCKET call to receive
  the socket.  The s878 abend was due to a shortage of BTL
  storage.
  
  The RMPL parameter list for the task level resource manager
  (EZBSORM1) is allocated in subpool 255 (LSQA) which also
  resides in BTL storage.  Because the parameter list could not
  be allocated, EZBSORM1 was unable to run and issue a TERMAPI
  call to free any pending PGIV elements.
  
  When the application was restarted, subsequent TAKESOCKET
  calls failed due to the residual PGIV elements.
  

Problem conclusion

• EZBSOUTL has been amended to remove residual PGIV elements.
  
  This APAR provides the resolution for FIN APAR PM54757.
  

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:

  UK98624

Modules/Macros

• EZBSOUTL EZBCTFME
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R210 PSY UK98624

     UP13/11/27 P F311

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.