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

APAR status

• Closed as fixed if next.

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.
  

Local fix

• Recycle the application address space using a different jobname.
  The stack will have to recycled to get rid of the bad PGIV
  KEYWORDS:
  CICS 878 ABENDS878 PGIV TAKESOCKET GIVESOCKET EZBS0RM1 BTL
  LSQA TERMAPI
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Releases 11, 12, and      *
  *                 13 IP: Sockets API programming               *
  ****************************************************************
  * PROBLEM DESCRIPTION: PGIV elements not freed after           *
  *                      BTL storage exhaustion.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  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.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

Temporary fix

Comments

• The solution for this APAR is included in CS for zOS Version 2
  Release 2.
  
  
  This problem will be tracked as Feature F155004.
  
  This problem has been resolved in V2R1 via PM87535.
  This problem has been resolved in V1R12 and V1R13
  via PI06886.
  

APAR Information

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

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

Fix information

Applicable component levels

• R1B0 PSN

     UP

• R1C0 PSN

     UP

• R1D0 PSN

     UP