A fix is available
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:
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