PM39441: EZBSOH03 DYNAREA CELL POOL STORAGE ORPHANED IN SUBPOOL 0 KEY 8 AFTER SUBTASKS TERMINATE

APAR status

• Closed as fixed if next.

Error description

• For every TCPIP socket API subtask that issues a valid first
  call, most commonly an INITAPI, a dynamic storage area is
  obtained from module EZBSOH03. This area has the identifier:
  'EZBSOH03 DYNAREA CELL POOL' and resides in subpool 0 key 8.
  The area is freed when the subtask issues a TERMAPI call.
  A case exists where a subtask (attached with option SZERO) may
  terminate without issuing a TERMAPI. The TCPIP socket API
  resource manager will then invoke TERMAPI on behalf of the
  subtask.  When TERMAPI is issued from the resource manager,
  the EZBSOH03 dynamic storage area does not get freed until
  the main socket API task ends.
  

Local fix

• Issue TERMAPI before terminating the subtask.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Releases 10, 11, 12, and  *
  *                 13 IP: Sockets API programming               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Subpool 0 key 8 storage allocated by    *
  *                      EZBSOH03 not freed when application     *
  *                      subtask terminates without issuing      *
  *                      TERMAPI call.                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Module EZBSOH03 is called by an application subtask as part
  of TCPIP socket processing (e.g. EZASMI or EZASOKET). EZBSOH03
  proceeds to allocate a dynamic storage area in subpool 0
  key 8.  This storage area remains allocated until the subtask
  issues a TERMAPI call.  If the subtask is attached with the
  SZERO parameter (subpool 0 storage shared), and the subtask
  detaches without first issuing a TERMAPI call, then the
  EZBSOH03 dynamic storage area does not get freed until the
  application main socket API task is terminated.  This can
  lead to a slow growth of subpool 0 key 8 storage over time.
  
  The EZBSOH03 dynamic storage area is prepended with the
  following:
  
  'EZBSOH03 DYNAREA CELL POOL'
  +-------------------------------------------------------------+
  + 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

• This APAR is fixed in HIP61D0 by APAR PM82694.
  
  
  The solution for this APAR is included in
  CS for zOS Version 2 Release 1.
  

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

• R1A0 PSN

     UP

• R1B0 PSN

     UP

• R1C0 PSN

     UP