PI59467: STORAGE LEAKS WHEN USING THE SNMP API TO COLLECT MIB DATA

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The customer has a long-running task which iteratively issues
  SNMP API calls to collect MIB data.  With each iteration,
  snmp_container storage is orphaned.  This occurs until SNMP API
  calls start failing with SNMP_MGR_RC_OUT_OF_MEMORY (-4).
  It appears that the containers should be freed by
  snmpFreeDecodedPDU() calls but aren't because
  snmpBuildPDU() clears their oid_p and value_p pointers in the
  VarBinds array.
  

Local fix

• Apply PTF or ++APAR.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of the IBM Communications Server                   *
  * for z/OS Version 2 Release 1 and 2 IP: SNMP                  *
  * Manager API                                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Storage leak when using SNMP Manager                         *
  * API                                                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the PTF.                                               *
  ****************************************************************
  The SNMP Manager API failed to free some intermediate storage
  used in creating a PDU.  For a long running application this
  resulted in receiving error SNMP_MGR_RC_OUT_OF_MEMORY (-4) from
  the API requests.
  +-------------------------------------------------------------+
  + 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

• The SNMP Manager API has been changed to free intermediate
  storage used in building PDUs for the application.
  
  * Cross Reference between External and Internal Names
  

Temporary fix

Comments

APAR Information

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

  PI57762

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

  UI37136 UI37137

Modules/Macros

• EZASNLCO EZBSNMPA EZBSNMPX EZBSNMP6
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R210 PSY UI37136

     UP16/05/10 P F605

• R220 PSY UI37137

     UP16/05/10 P F605

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.