PK80762: SNMP MANAGER API HAS VARIOUS PROBLEMS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• More SNMP Manager API problems
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release(s) 9 and 10       *
  *                 IP: SNMP Manager API.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Multiple problems with the snmpv3 trap  *
  *                      support.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The snmpv3 trap support has the following problems.
  
  Manager picks up the wrong version of the session control block
  
  CBC-DES is incorrectly being accepted as a valid privProto
  value.
  
  The snmpv3 trap security was not being built correctly.
  
  The API call snmpValueCreateIPAddr followed by snmpAddVarBind
  fails with RC=10.
  +-------------------------------------------------------------+
  + 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 code has been corrected.
  Modules SNMPINIT, SNMPPDU, SNMPPLFM, SNMPVAL and SNMPVB have
  been amended to correct the problems.
  
  The following documentation changes are being made to the
  
  z/OS Communications Server: IP Programmer's Guide and Reference
  Version 1 Release 9 and 10
  SRL = SC318787
  
  Section: SNMP Manager API configuration file
  
  In the sample configuration file replace the HMAC-SHA example
  with the following version.
  9.8.0.1  162 snmpv3 userid - AuthPriv
     HMAC-SHA f40b19aa7c2d3b685655ba74d7771522faa3571c
          DES f40b19aa7c2d3b685655ba74d7771522faa3571c
  
  Section: Steps for compiling and linking SNMP manager API
           application
  
    Before the paragraph
      "Make sure to include the <snmpmgr.h> header file"
      insert the following:
      To enable the use of MVS-specific data structures,
      you must define the 'MVS'  constant, using either
      a compile option (-DMVS) or a define directive
      (#define MVS) in your application.
  
  Section: SNMP Manager API statement syntax
  
  Add the following introductory sentences under the heading:
    This section describes each of the configuration entry
     parameters:
      The term 'target' can refer to either a target SNMP
      agent or an application receiving a trap or inform
      sent by an SNMP manager application.
  
  Section: SNMP manager API functions
   The following functions have been removed from the API.
   SNMP_MGR_RC_DEPRECATED will be returned if they are used.
     snmpValueCreateBits:
     snmpValueCreateUnsignedInteger32:
     snmpValueCreateNSApAddrs:
  
  * Cross Reference between External and Internal Names
  EZASNMGR (SNMPMGR )  EZASNMGS (SNMPSMGR)  HHHPPLFM (SNMPPLFM)
  EZASNMGR (SNMPMGR )  HHHPPLFM (SNMPPLFM)  EZASNMGR (SNMPMGR )
  EZASNMGS (SNMPSMGR)
  

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:

  UK45482 UK45484 PK87457

Modules/Macros

• EZASNMGR EZASNMGS EZBSNMPA EZBSNMPX EZBSNMP6
  HHHPPLFM SNMPINIT SNMPPDU  SNMPPLFM SNMPVAL  SNMPVB   S3MPINIT
  S3MPPDU  S3MPPLFM S3MPVAL  S3MPVB   S6MPINIT S6MPPDU  S6MPPLFM
  S6MPVAL  S6MPVB
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1A0 PSY UK45482

     UP09/06/27 P F906

• R199 PSY UK45484

     UP09/06/27 P F906

• R190 PSN

     UP

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.