Manuals / Compaq / Computer Equipment / Network Card

Compaq AAR04BCTE manual

Models: AAR04BCTE

1 132

Download 132 pages 53.41 Kb

Page 12

Image 12

Page 12

Image 12

Contents

January Compaq TCP/IP Services for OpenVMS SNMP Programming and ReferenceSoftware VersionCompaq TCP/IP Services for OpenVMS Version Order Number AA-R04BC-TEThis document was prepared using DECdocument, Version 3.3-1b 2001 Compaq Computer CorporationZK6530 This document is available on CD-ROM 2 MIBs Provided with TCP/IP Services 3 Creating a Subagent Using the eSNMP APIPreface 1 Overview4 Using the SNMP Utilities 5 eSNMP API Routines6 Troubleshooting eSNMP Problems IndexFigures TablesPage Preface Intended AudienceDocument Structure Related Documents Table 1 TCP/IP Services DocumentationContents ManualHow to Order Additional Documentation Reader’s CommentsConventions Table 1 Cont. TCP/IP Services Documentationbold text italic textMonospace text Page Overview 1.1 SNMP Architecture1.2 Request Handling Overview 1.1 SNMP ArchitectureFigure 1-1 SNMP Architecture Overview 1.2 Request Handling Figure 1-2 eSNMP Data Flow1.3 TCP/IP Services Components for SNMP Overview 1.2 Request HandlingGet GetNext GetBulk Set Table 1-1 SNMP Component FilesOverview 1.3 TCP/IP Services Components for SNMP 1.4 Writing an eSNMP SubagentTable 1-1 Cont. SNMP Component Files File1.5 The eSNMP API Overview 1.4 Writing an eSNMP SubagentTable 1-2 Files for Building a Subagent 1.6 The MIB Compiler Overview 1.5 The eSNMP API1.5.1 The SNMP Utilities 1.7.1 Using Existing SNMP Version 1 MIB Modules 1.7 SNMP VersionsOverview 1.6 The MIB Compiler 1.8 For More Information Overview 1.7 SNMP VersionsPage MIBs Provided with TCP/IP Services 2.1 Overview of the Host Resources MIB2.1.1 Deﬁning Host Resources MIB Implemented Objects Table 2-1 Host Resources MIB ObjectsMIBs Provided with TCP/IP Services 2.1 Overview of the Host Resources MIBTable 2-1 Cont. Host Resources MIB Objects Object Name2.1.2 Restrictions to Host Resources MIB hrPartitionTable hrPrinterTable hrSWInstalled hrSWInstalledTableTable 2-1 Cont. Host Resources MIB Objects MIBs Provided with TCP/IP Services 2.1 Overview of the Host Resources MIBOff line Remote UCB marked delete-on-zero-reference-count 2.2 Overview of MIB hrFSIndexhrFSStorageIndex is always hrStorageType always contains the value of hrStorageFixedDiskMIBs Provided with TCP/IP Services 2.2 Overview of MIB 2.2.1 MIB II Implemented Groups2.2.2 Restrictions to MIB II Implementation system interfaces Internet Protocol ICMP TCP UDP SNMPMIBs Provided with TCP/IP Services 2.2 Overview of MIB ifOutDiscards Counter32 ifOutQLen Gauge32d n hhmmss Page Creating a Subagent Using the eSNMP API 3.1 Creating a MIB Speciﬁcation3.2 The Structure of Management Information Creating a Subagent Using the eSNMP API 3.2 The Structure of Management Information3.2.1 Assigning Object Identiﬁcation Codes 3.2.2 MIB SubtreesCreating a Subagent Using the eSNMP API Creating a Subagent Using the eSNMP API3.2 The Structure of Management Information Figure 3-1 MIB II in SMI Tree StructureCreating a Subagent Using the eSNMP API 3.2 The Structure of Management InformationFor example, the chess MIB provided with the sample code in the 3.3 Creating a MIB Source File 3.3.1 Writing the ASN.1 Input File3.3.2 Processing the Input File with the MIB Compiler Creating a Subagent Using the eSNMP API3.3 Creating a MIB Source File Creating a Subagent Using the eSNMP APIThe parameters and qualiﬁers for the MIBCOMP command are as follows Parameter or QualiﬁerCreating a Subagent Using the eSNMP API 3.3.2.1 UNIX Utilities Supplied with TCP/IP Services3.3 Creating a MIB Source File 3.3.2.2 Object TablesCreating a Subagent Using the eSNMP API 3.3 Creating a MIB Source File1. Declaration Section 2. Index Deﬁnitions SectionCreating a Subagent Using the eSNMP API 3.3 Creating a MIB Source File5. Method Routine Prototypes Section 3.3.2.4 The subtreeTBL.C Output FilesCreating a Subagent Using the eSNMP API 3.3 Creating a MIB Source File2. Array of OBJECT Structures Section 3.4 Including the Routines and Building the Subagent Creating a Subagent Using the eSNMP API3.3 Creating a MIB Source File 3. Initialized Subtree Structure Section3.4 Including the Routines and Building the Subagent Creating a Subagent Using the eSNMP APITo link with the eSNMP object library, enter the following command File Name Edit RequiredTCPIP$EXTENSIONMIBSHUTDOWN.COM Page Using the SNMP Utilities 4.1 Using the MIB Browser4.1.1 MIB Browser Parameters agentUsing the SNMP Utilities 4.1 Using the MIB Browser 4.1.2 MIB Browser Flagscommunity request-typeUsing the SNMP Utilities 4.1 Using the MIB Browseri maxignores Table 4-2 Flags for the snmprequest Commandn nonrepeaters p portr maxretries Using the SNMP Utilities 4.1 Using the MIB Browser4.1 Using the MIB Browser 4.1.3 MIB Browser Data Typess sleepinterval v version4.1.4 Command Examples for snmprequest Using the SNMP Utilities 4.1 Using the MIB BrowserExamples Using the SNMP Utilities 4.1 Using the MIB Browser 1.3.6.1.2.1.2.2.1.3.1 = 24 1.3.6.1.2.1.2.2.1.1.3 =4.2 Using the Trap Sender and Trap Receiver Programs Using the SNMP Utilities 4.1 Using the MIB Browser4.2.1 Entering Commands for the Trap Sender Program 4.2.1.1 Trap Sender Parameters4.2 Using the Trap Sender and Trap Receiver Programs enterprisegeneric-trap specific-trap4.2 Using the Trap Sender and Trap Receiver Programs h hostUsing the SNMP Utilities Flags for the snmptrapsnd Command4.2.2 Entering Commands for the Trap Receiver Program p portUsing the SNMP Utilities 4.2 Using the Trap Sender and Trap Receiver Programs4.2.2.3 Trap Receiver Examples C..-..0Page eSNMP API Routines 5.1 Interface Routinesesnmpinit eSNMP API Routines esnmpinitFormat Argumentsesnmpregister eSNMP API Routines esnmpregistertimeout FormateSNMP API Routines esnmpregister Return ValuesExample #include esnmp.hRESPONSETIMEOUT, REGISTRATIONPRIORITY eSNMP API Routines esnmpregisterstatus = esnmpregister &ipRouteEntrysubtree if status != ESNMPLIBOKesnmpunregister eSNMP API Routines esnmpunregisterFormat Argumentsesnmpregister2 eSNMP API Routines esnmpregister2Format ArgumentseSNMP API Routines esnmpregister2 Description5-8 eSNMP API Routines eSNMP API Routines esnmpregister2 Return ValueseSNMP API Routines esnmpregister2 Example 5-10 eSNMP API Routinesesnmpunregister2 eSNMP API Routines esnmpunregister2Format Argumentsesnmpcapabilities eSNMP API Routines esnmpcapabilitiesFormat Argumentsesnmpuncapabilities eSNMP API Routines esnmpuncapabilitiesFormat Argumentsesnmppoll eSNMP API Routines esnmppollFormat Descriptionesnmpareyouthere eSNMP API Routines esnmpareyouthereFormat Descriptionesnmptrap eSNMP API Routines esnmptrapFormat Argumentsesnmpterm eSNMP API Routines esnmptermFormat Descriptionesnmpsysuptime eSNMP API Routines esnmpsysuptimeArgument Format5.2 Method Routines eSNMP API Routines 5.2 Method Routinesget Routine eSNMP API Routines get RoutineFormat ArgumentseSNMP API Routines get RoutineDescription Return Valuesset Routine eSNMP API Routines set RoutineFormat Argumentsset Routine eSNMP API RoutinesDescription The libesnmp routines call whatever routine is speciﬁed for Set operations in the object table identiﬁed by the registered subtreeeSNMP API Routines set Routine Return Values 5.2.1 Processing *set Routines5-24 eSNMP API Routines eSNMP API Routines set Routine 5.2.2 Method Routine Applications Programming eSNMP API Routines set Routineint mibgroupget METHOD *method int mibgroupset5.2.3 Value Representation eSNMP API Routines set Routineointeger ostring ooctet ooid eSNMP API Routines set Routine ESNMPTYPEObjectId varbind-value.oid and the varbind-name ﬁeldseSNMP API Routines set Routine 5.3 Support Routines eSNMP API Routines 5.3 Support Routinesointeger eSNMP API Routines ointegerFormat ArgumentseSNMP API Routines ointeger Example 5-32 eSNMP API Routinesooctet eSNMP API Routines ooctetFormat Argumentsooid eSNMP API Routines ooidFormat Argumentsostring eSNMP API Routines ostringFormat ArgumentseSNMP API Routines ostring Example 5-36 eSNMP API Routinesocounter64 eSNMP API Routines ocounter64Format Argumentsstr2oid eSNMP API Routines str2oidFormat Argumentssprintoid eSNMP API Routines sprintoidFormat Descriptioninstance2oid eSNMP API Routines instance2oidFormat ArgumentseSNMP API Routines instance2oid Example oid2instance eSNMP API Routines oid2instanceFormat ArgumentseSNMP API Routines oid2instance Example instLengtheSNMP API Routines incominginst2ip eSNMP API Routines inst2ipFormat ArgumentseSNMP API Routines inst2ip Description ExamplesReturn Values incomingeSNMP API Routines inst2ip n is a single value integercmpoid eSNMP API Routines cmpoidFormat Descriptioncmpoidpreﬁx eSNMP API Routines cmpoidpreﬁxFormat Descriptioncloneoid eSNMP API Routines cloneoidFormat Argumentsfreeoid eSNMP API Routines freeoidFormat Descriptionclonebuf eSNMP API Routines clonebufFormat Argumentsmem2oct eSNMP API Routines mem2octFormat Argumentscmpoct eSNMP API Routines cmpoctFormat Argumentscloneoct eSNMP API Routines cloneoctFormat Argumentsfreeoct eSNMP API Routines freeoctFormat Descriptionfreevarbinddata eSNMP API Routines freevarbinddataFormat Descriptionsetdebuglevel eSNMP API Routines setdebuglevelFormat Argumentsisdebuglevel eSNMP API Routines isdebuglevelFormat Return ValuesESNMPLOG eSNMP API Routines ESNMPLOGFormat Descriptionprintvarbind eSNMP API Routines printvarbindFormat Argumentssetselectlimit eSNMP API Routines setselectlimitFormat Argumentssetprogname eSNMP API Routines setprognameFormat Argumentsrestoreprogname eSNMP API Routines restoreprogname#include esnmp.h restoreprogname Formatparseprogname eSNMP API Routines parseprognameFormat Argumentsesnmpcleanup eSNMP API Routines esnmpcleanup#include esnmp.h int rc = ESNMPLIBOK rc = esnmpcleanup FormatPage Troubleshooting eSNMP Problems 6.1 Modifying the Subagent Error Limit6.2 Modifying the Subagent Timeout Troubleshooting eSNMP Problems 6.2 Modifying the Subagent Timeout 6.3 Log FilesTroubleshooting eSNMP Problems 6.3 Log Files Page Index printvarbind support routine setdebuglevel support routinesetprogname support routine setselectlimit support routineIndex-3