IBM Support

PK87457: SNMP MANAGER API HAS VARIOUS PROBLEMS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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) 11 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 number

    PK87457

  • Reported component name

    TCP/IP V3 MVS

  • Reported component ID

    5655HAL00

  • Reported release

    1B0

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2009-05-27

  • Closed date

    2009-06-17

  • Last modified date

    2009-10-02

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

    PK80762

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

    UK47606

Modules/Macros

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

Fix information

  • Fixed component name

    TCP/IP V3 MVS

  • Fixed component ID

    5655HAL00

Applicable component levels

  • R1B0 PSY UK47606

       UP09/09/03 P F909

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1B0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCY4DZ","label":"DO NOT USE"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1B0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 October 2009