Network management software library allowing a sending and retrieval of multiple SNMP objects

[0003] The present invention relates to a JAVA based simple network management protocol (SNMP) library (application programmer interface (API)) which is most preferably written fully in the JAVA software language. Such a library is useful for creating network management applications that can manage SNMP enabled devices. Such a system can be used to create JAVA based SNMP agents wherein the library takes care of all the SNMP details underneath whereby the user primarily focuses on the logic of the particular application.

[0004] Managing and monitoring connected devices is quite important, both for local area network applications and other interconnected environments. Several protocols are known which are designed to enable network management of network attached devices. These protocols often include a collection of objects and procedures for accessing the objects associated with a network attached device. Simple network management protocol (SNMP) is an example of a relatively well known protocol for managing and monitoring network devices.

[0005] Under SNMP, a network device has an object management system which includes an object database containing various objects relating to the network device, referred to as a management information base (MIB) and agent software for querying and modifying the objects, referred to as an agent. A system being managed under SNMP also includes a management station running manager software which provides centralized control of the various network devices by communicating with the agent software over the network. The software for management typically runs on a network attached computer and an interface is provided in the form of a graphical user interface. The management software obtains information about the objects in the MIBs of the various network attached devices and allows a user to monitor, query or modify the objects in the MIBs. To monitor, query or modify an object the manager software sends a request over the network to the object management system. Agent software for examining or otherwise performing operations on the object examines the request, and if valid, carries out the request and sends a message back to the manager software. If an agent determines that a request is invalid, for example the request is to write to an object which can only be read, the agent returns the message indicating an error.

[0006] In SNMP, the managers software typically obtains information about each network attached device's object management system via a MIB output file. A MIB compiler generates the MIB output file from one or more MIB input files, each of which contains the name of each object in a MIB structure, and the plurality of attributes which describe the objects and the valid operations which can be performed on the objects. The MIB input file reflects the objects and attributes associated with the objects as they were intended to be implemented in the management system. The MIB compiler merges the one or more MIB input files and generates a MIB output file which contains the name of each object in the MIB and the plurality of attributes which describe the objects and the valid operations which can be performed on the objects.

[0007] A software product available from Advent Net provides an SNMP package which is an API or a library written fully in the JAVA software language. This helps a user create network management applications that can manage SNMP enabled devices. It can also be used to create JAVA based SNMP agents. The Advent Net SNMP package provides a library that is to take care of the SNMP details and provide a graphical interface such that the user can concentrate on the logic of the particular application.

[0008] Advent Net also provides a product Advent Net agent builder which is a tool for creating SNMP MIBs and instrumenting agents for the MIBs. The agent builder product provides what can be viewed as a SNMP to any gateway where the any stands for any back-end protocol. The back-end protocol could include for example file read and write operations, performing system commands, executing JAVA code and proxying to other SNMP agents.

[0009] The agent builder provides a graphical way to build SNMP agents. To each variable OID (object identifier) in the SNMP MIB, it is possible to associate an “action” when a get or set operation is performed. The action may be to read or write a file, execute a system command, run JAVA code, or proxy the SNMP operation to some other agent. This is all defined graphically by choosing from a menu. The action is stored in the MIB file itself. The agent run time reads the MIB file and starts performing according to the actions that were defined at build-time.

[0010] The Advent Network Management, Inc. products currently provide the JAVA based SNMP library as noted above. However, this library is limited in functionality in that only single object identifiers (OIDs) can be retrieved and set via one SnmpRequest. This provides only limited capabilities. Unfortunately, the limits of the Advent library require a tremendous increase in network traffic to properly manage a network.

[0011] It is an object of the invention to provide an additional software library that allows the retrieval and setting of multiple SNMP variables in one request.

[0012] It is a further object of the invention to use the Advent SNMP library as a base and to provide further functionality, namely allowing the retrieval and setting of multiple SNMP variables in one request.

[0013] According to the invention, the problem of multiple variable retrievals and setting within one SnmpRequest has been solved.

[0014] According to the invention, a process or method is provided for providing multiple variable retrievals and setting within one SnmpRequest. The method forms packet data units with object identifiers (OIDs). The OIDs are packet specific for a particular request in an object management system using SNMP (simple network management protocol) attributes, the object management system including a plurality of objects and procedures for accessing the objects. The object management system is accessible over a network and associated with a network-attached device. The method includes providing the object management system with a plurality of classes providing descriptions of things that can be accessed. A SnmpSessions class establishing connection between the object management system and connected devices is also provided. Call back arguments are received at the network management station from the device. A SNMP application programmer interface (API) provides elements needed for connection. A SnmpRequest class is extended for extending the API to allow a plurality of objects to be sent or requested in a single packet data unit (PDU). The SNMP packet data unit (PDU) is formed comprised of one or more object identifiers (OIDs), the OIDs being packet specific for a particular request.

[0015] The process includes providing the Advent SNMP library as a base. The SnmpRequest Class is extended and the Advent SNMP.SNMP Client Class is implemented within the extended SnmpRequest Class. The authenticate (SNMP PDU, string) Advent SNMP client method is implemented. This method is used to validate the user authentication with an agent. The call-back (SnmpSession, SNMP PDU, Int) Advent SNMP client method is implemented. This is the method that will handle the response received. This method also handles cases of failures or miscommunications with an agent. The debug print (string) Advent client method is also implemented. This method is used to debug messages for the developer or enduser.

[0016] Within the extended SnmpRequest Class, the method of the invention provides following a sequence of steps to utilize the SnmpRequest Class. First the application programmer interface (API) (the library) is initialized by calling the INITAPI ( . . . ) method. The argument passed into this method is a reference to this class (e.g. the “this” pointer is handed-in as the argument).

[0017] Next, after calling the INITAPI ( . . . ) method, the packet data unit (PDU) is initialized by calling the INITPDU ( ) method. This method does not require any argument.

[0018] Next an SNMP agent object is instantiated (created). This is accomplished by handing in the agent name, internet protocol (IP) address, and a community string to the SNMP agent constructor (namely the agent builder referred to in the introduction). It should be noted that the SNMP agent can be created at several points within the construction of the extended SnmpRequest Class but it must be completed before the next call to INIT session ( ). Next, the INIT session ( ) method should be called. This will allow communications between the network management station and the end device.

[0019] Once the above steps are complete, one can then create object identifier (OID) variables to send to the device. To accomplish this the AddVar methods are used to add one (1) or more variables to the PDU. Once the variables are added the packet data unit is sent to the device using the “GET ( )” “GETNEXT ( )” or “SET ( )” methods (depending upon the request type). When the packet returns or the system detects a communication failure, the “call-back” method noted above would be called by the system and as noted above, the end user is responsible for how the response is handled.

[0020] According to another aspect of the invention, a software JAVA based SNMP library system is provided for use with a manager and connected devices. The system includes a plurality of classes providing descriptions of things that can be accessed. A SNMP application programmer interface (API) providing elements needed for connection is also provided. The system provides call-back arguments to be received at the manager from the devices. A SNMP packet data unit (PDU) comprised of one or more object identifiers (OIDs) is provided. The OIDs are packet specific for a particular request. The SnmpRequest class is provided for extending the API to allow a plurality of objects to be sent or requested in a PDU.

[0021] The system and method of the invention are based on the Advent SNMP library as a base and use this library. The Advent system is based on requesting one object identifier (OID) with the SnmpSession class with the GET function (for example to get information), the SET function (to set a certain attribute) and the GETNEXT function (to get information that is the next attribute associated with the referred to attribute). The system of the invention provides that the SnmpRequest Class implements the SnmpSession class and is associated with an SnmpSession Class. The SnmpSession Class is the device that will be communicated with for a request. The SnmpSession Class of the invention inherits (assumes the associated information) from the SnmpSession Class of the Advent system but also has a specialized extension which will be discussed further below.

[0022] The SnmpRequest Class of the invention provides GET, SET and GETNEXT functions as discussed above. However, the extension of the SnmpRequest Class extends the Advent library to provide GET and SET functions for one or more OIDs, thereby providing multiple variable retrievals and setting within one SnmpRequest. As this enhanced API (library) allows many objects to be sent or requested within the same PDU, network traffic is reduced considerably. As an example, a table of information may require 50 requests using the basic Advent package but the library according to the invention allows those 50 requests to be sent in one request thus reducing the network traffic. The SNMP library of the invention is implemented such that it is extensible and can be used as necessary by various different companies.

[0023] The various features of novelty which characterize the invention are pointed out with particularity in the claims annexed to and forming a part of this disclosure. For a better understanding of the invention, its operating advantages and specific objects attained by its uses, reference is made to the accompanying drawings and descriptive matter in which a preferred embodiment of the invention is illustrated.

[0024] In the drawings:

[0025] FIG. 1 is a diagram showing classes for use with the Advent SNMP library as a base as well as Advent SNMP library classes;

[0026] FIG. 2 is a diagram showing the Snmp API class and other classes (providing descriptions of things that can be accessed) all of which are directly or indirectly associated with the classes of FIG. 1;

[0027] FIG. 3 is a diagram showing the association of the SnmpSession class with respect to the SnmpSession class and associated JAVA.LANG.THREAD (JAVA language thread) in JAVA.LANG.OBJECT (JAVA language object);

[0028] FIG. 4 is a diagram showing the association of the SnmpRequest class with respect to the JAVA.LANG.OBJECT (JAVA language object); and

[0029] FIG. 5 is a diagram showing the association of the SnmpAgent class with respect to the associated JAVA.LANG.THREAD (JAVA language thread) in JAVA.LANG.OBJECT (JAVA language object).

[0030] Referring to the drawings in particular, the invention comprises a system and method for allowing many objects to be sent or requested within the same packet data unit, thus allowing network traffic to be considerably reduced. The library provided according to the invention uses the Advent SNMP library as a base but allows the sending and retrieval of multiple SNMP objects within the same SNMP request.

[0031] FIGS. 1 and 2 together form a diagram of the software system of the invention. The various boxes represent classes including Advent SNMP library classes as well as classes added to form the system of the invention. The solid lines connecting classes with closed triangle arrow indicate that the pointed to class is inherited by the connected class. The dash line connecting classes with closed triangle arrow indicate the pointed to class is implemented by the connected class. The solid lines connecting classes with open end arrow indicates an association between classes where the connected class is aware of (has knowledge of) the connected class.

[0032] The system of the invention provides a SnmpRequest Class designated 10 which is shown in FIG. 1. The SnmpRequest Class provides GET, SET and GETNEXT functions. The SnmpRequest Class 10 of the invention extends the Advent library to provide GET and SET for one or more object identifier (OID).

[0033] The various classes of FIGS. 1 and 2 can contain information such as specialized structures, tags to make information private such as access methods or can include routines that only certain parts can modify. The special classes used in the system are detailed below including the various constructors, methods, variables. The components of the Advent SNMP library are known themselves (The ADVENTNET SNMP PACKAGE VERSION 1.3 Documentation at site http://www.adventnet.com/products/snmpv1/help/index.html is hereby incorporated by reference).

[0034] In FIG. 2 the class SnmpOID 210 is shown as inheriting class SnmpVar 220 at 230. This is shown as a tree type link 230 between the various classes. The SnmpString class 212 also inherits class SnmpVar 220 at 230. The associated specialized string, SnmpIpAddress string 213, inherits SnmpString class 212 at 231. The classes SnmpInt 214, SnmpNull 215 and SnmpUnsignedInt 216 also inherit class SnmpVar 220 at 230. The classes SnmpCounter 217 and SnmpGauge 218 are shown inheriting SnmpUnsignedInt 216 at 232. SnmpVarBind 219 is shown as having SnmpVar 220 associated with it at 233 and having SnmpOID 210 associated with it at 234. The classes 212-218 are the description of the things that can be accessed through the system. These classes provide a way to categorize the data. They also provide methods to extract information about the various data types into a particular format.

[0035] The SnmpAPI 250 is an API or library, particularly that API class offered with the Advent Net SNMP package. SnmpAPI 250 helps create network management applications that can manage SNMP enabled devices and can also be used to create JAVA based SNMP agents. The agent takes care of the SNMP details. The SnmpAPI is created and then it is told which are the ports of the various devices. The SNMP is required for making connections such as requests to devices and get reports back from devices. At startup the SNMP is advised of the ports that the system is using and includes instructions such as if talking, waiting a certain number of milliseconds for further action.

[0036] The SnmpAPI 250 is associated with SnmpOID 210 as shown at 235. The SnmpAPI 250 is associated with a SnmpPDU class 100 as shown at 235. The SnmpAPI 250 is associated with a SnmpSession class 150 as shown at 235. The SnmpAPI 250 is associated with the SnmpRequest class 10 as shown at 235. Ah Interface SnmpClient class 160 is associated with the SnmpAPI 250 as shown at 238. The SnmpAPI 250 also implements the Interface SnmpClient class 160 as shown at 239.

[0037] The SNMP PDU 100 is the packet which is specific for particular requests. One or more object identifiers (OIDs) makeup a PDU. This can include specific information, name, address, telephone number, etc. The system of the invention sends a PDU to a device based on a request. As noted, the SnmpAPI 250 is associated with the SnmpPDU class 100 as shown at 235. The SnmpOID class 210 is associated with the SnmpPDU class 100 as shown at 130. The SnmpPDU class 100 is associated with SnmpRequest class 10 as shown at 131. The SnmpPDU class 100 is associated with CallbackArgs class 110 as shown at 132. The SnmpPDU class 100 is associated with PacketArgs class 180 as shown at 133.

[0038] The SnmpCallback class 120 is associated with the CallbackArgs class 110 as shown at 134. The SnmpSessions Class 150 is associated with the CallbackArgs class 110 as shown at 135. The interface SnmpClient 160 is also associated with the CallbackArgs class 110 as shown at 136.

[0039] The interface SnmpClient 160 is associated with the SnmpSessions Class 150 as shown at 137. The SnmpCallback class 120 is associated with the SnmpSessions Class 150 as shown at 138. The interface SnmpClient 160 is associated with SASClient class 170 as shown at 139.

[0040] The SnmpCallback class 120 and the SnmpSessions Class 150 are each associated with the PacketArgs class 180 as shown at 140 and 141 respectively.

[0041] The Callbacks 110 and 120 are called upon the receipt of a response at the network management station (manager) from a device. The SnmpSessions class 150 and associated SASClient class 170 establish the connection to the particular device based on the IP (internet protocol) and the community string.

[0042] The system uses the library 250 to go into the device and request one or more object identifiers with a Get, Set or GetNext method. The Get method gets information from a device, the Set method sets an attribute of the device and the GetNext method gets the next attributed associated with the identified information. These methods are associated with the SnmpSessions class 150.

[0043] The invention extends the SnmpRequest class 10 and implements the Advent SNMP SnmpClient class 160 within the extended class as shown at 30. The SnmpAPI 250 is associated with the SnmpRequest class 10 (at 237) and the SnmpPDU 100 is also associated with the SnmpRequest class 10 (at 131). The SnmpOID 210 is also associated with the SnmpRequest class 10 as shown at 31. An SnmpAgent class 20 is provided by the invention as detailed below. The SnmpAgent class 20 is associated with the SnmpRequest class 10 as shown at 32. An Interface SnmpConstants class 40 is implemented within SnmpRequest class 10 as shown at 33.

[0044] A further SnmpSession Class 50 is provided. The SnmpSession Class 50 of the invention inherits (assumes the associated information) from the SnmpSession Class 150 of the Advent system but also has a specialized extension which will be discussed further below. The SnmpSession Class 50 is associated with the SnmpRequest class 10 as shown at 34.

[0045] The SnmpRequest class 10 is associated with the SnmpSession class 20 which inherits the SnmpSession class 250 by the association represented as 120. The SnmpRequest class 10 is also associated with the SNMP agent 30. The interface SNMP constants class 40 is implemented within the SnmpRequest class 10 as indicated by the dash line. For example the interface SNMP client 260 is implemented within the SnmpAPI 350 as indicated by the dash line. The other various interconnections of classes indicate associations and particularly the inheritance of information associated with one class by the connected class (as described with regard to SnmpOID 310.

[0046] FIG. 3 shows the association of the SnmpSession class 50 with respect to the SnmpSession class 150 and associated JAVA.LANG.THREAD (JAVA language thread) 300 in JAVA.LANG.OBJECT (JAVA language object) 310. The public class SnmpSession( ) 50 extends the SnmpSession 150. The components include:

[0047] Constructor Index

[0048] SnmpSession (SnmpAPI) this is a constructor.

[0049] Method Index

[0050] run( ) this method should be called when running in a netscape browser.

[0051] Constructors

[0052] SnmpSession

[0053] public SnmpSession (SnmpAPI api)

[0054] This is the constructor.

[0055] Parameters: api-the Snmp.SnmpAPI for this session.

[0056] Methods

[0057] run

[0058] public void run ( )

[0059] this method should be called when running in a netscape browser. It provides a work around for security issues within netscape.

[0060] Overrides:

[0061] run in class SnmpSession.

[0062] FIG. 4 shows the association of the SnmpRequest class 10 with respect to the JAVA.LANG.OBJECT (JAVA language object) 310. Public class SnmpREQUEST extends the Object, implements SnmpClient and SnmpConstants. The components include:

[0063] Variable Index

[0064] agent The SNMP agent (device) for this device

[0065] api The SnmpAPI for this request.

[0066] applet The applet associated with this request (if any)

[0067] DEBUG_LEVEL The debug level for this request.

[0068] doomed Whether this request should be destroyed or not.

[0069] m_Retries The retry parameter for this request.

[0070] m_Timeout The timeout parameter (in milliseconds) for this request.

[0071] m_useNetscapeAPI Whether we are functioning in a Netscape browser or not.

[0072] oid The SnmpOID for this request.

[0073] pdu The packet data unit (PDU) for this request.

[0074] pduErrString An array of error strings

[0075] reqid The SnmpRequest ID sent

[0076] reguestsList A list containing all the requests sent via this object

[0077] session The session (device) that will be communicated with for this request.

[0078] Constructor Index

[0079] SnmpRequest( ) This is the default constructor.

[0080] SnmpRequest(SnmpAgent) This is a constructor for a stand alone based application

[0081] SnmpRequest(SnmpAgent, Applet) This is a constructor for a client (browser) based applet

[0082] SnmpRequest(SnmpAgent, Applet, int) This is a constructor for a client (browser) based applet

[0083] SnmpRequest(SnmpAgent, int) This is a constructor for a standalone based application

[0084] Method Index

[0085] addVar(Stringr[ ]This method adds one or more variables to the SnmpPDU.

[0086] addVar(String[ ], String[ ], int[ ]) This method adds 1 or more variables and 1 or more associated values to the SnmpPDU and sets 1 or more associated types of request.

[0087] apiStop( ) This method shutsdown the SnmpAPI.

[0088] authenticate(SnmpPDU, String) This debug print method is not currently used.

[0089] callback(SnmpSession, SnmpPDU, int) This method should be implemented by the user in the extended class.

[0090] cleanup( ) This cleanup method should be called periodically from a thread. Deprecated.

[0091] commitSnmpChanges( ) Commits the communication parameters for the session Deprecated.

[0092] debugPrint(String) This debug print method is not currently used.

[0093] exportMessage(String, int) Export user messages to a com.coms.S2.ISDUtils.SDLogger if available or to System.err.println otherwise.

[0094] get( ) This method provides asynchronous communications (non-blocking) to retrieve information from a device.

[0095] get(boolean) This method provides synchronous communications (blocking) to retrieve information from a device.

[0096] getNext( ) This method provides asynchronous communications (non-blocking) to retrieve information from a device.

[0097] initApi(SnmpClient) Initializes the SnmpAPI for this request

[0098] initPDU( ) Initializes the SnmpPDU for this request This method should be used when using the same SnmpRequest to make multiple requests

[0099] initRequest(SnmpAgent, Applet, int) Initializes the SnmpAgent, Applet and debug level of the request.

[0100] initSession( ) Initializes the SnmpSession parameters.

[0101] initSnmp( ) Initializes the SnmpRequest parameters.

[0102] isInSubTree(SnmpPDU, SnmpPDU) Check if first varbind oid has a root object identifier (OID) as an ancestor

[0103] sendPDU( ) Sends a PDU synchronously (blocking) to a device.

[0104] sendPDU(SnmpPDU) Sends a PDU asynchronously (non-blocking) to a device.

[0105] sessionStart( ) This method provides a workaround for security issues for the Netscape browser.

[0106] sessionStop( ) This method shutsdown the SnmpSession.

[0107] set( ) This method provides asynchronous communications (non-blocking) to set information on a device.

[0108] set(boolean) This method provides synchronous communications (blocking) to set information on a device.

[0109] setLogger(SDLogger) This method hooks the com.coms.S2.ISDUtils.SDLogger into the SnmpRequest

[0110] setSessionCommunity(String, String) Set the community string of the

[0111] agent setSessionPeername(String) Set the agent to communicate with

[0112] setSessionRetries(int) Set the number of retries to communicate with a device

[0113] setSessionTimeout(int) Set the amount of time to wait for a response from a device.

[0114] setSnmpApiName(String) This method sets the SnmpAPI name

[0115] setSnmpSessionName(String) This method sets the SnmpSession name

[0116] useNetscapeAPI(boolean) This method provides a workaround for security issues for the Netscape browser.

[0117] Variables

[0118] session

[0119] protected SnmpSession session

[0120] The session (device) that will be communicated with for this request.

[0121] api

[0122] protected SnmpAPI api

[0123] The SnmpAPI for this request.

[0124] m_Timeout

[0125] protected int m_Timeout

[0126] The timeout parameter (in milliseconds) for this request.

[0127] m_Retries

[0128] protected int m_Retries

[0129] The retry parameter for this request.

[0130] DEBUG_LEVEL

[0131] protected int DEBUG_LEVEL

[0132] The debug level for this request. The level can range from 0 to 3. A level of 0 provides no debug information and a level of 3 provides all the debug information available. Default is 0.

[0133] m_useNetscapeAPI

[0134] protected boolean m_useNetscapeAPI

[0135] Whether functioning in a Netscape browser or not.

[0136] doomed

[0137] protected boolean doomed

[0138] Whether this request should be destroyed or not.

[0139] agent

[0140] protected SnmpAgent agent

[0141] The SNMP agent (device) for this device.

[0142] applet

[0143] protected Applet applet

[0144] The applet associated with this request (if any)

[0145] pdu

[0146] public SnmpPDU pdu

[0147] The packet data unit (PDU for this request)

[0148] oid

[0149] public SnmpOID oid

[0150] The SNMP OID for this request.

[0151] reqid

[0152] public int reqid

[0153] The SnmpRequest ID sent.

[0154] requestsList

[0155] protected static Vector requestsList

[0156] A list containing all the requests sent via this object.

[0157] pduErrString

[0158] public static final String pduErrString[ ]

[0159] An array of error strings.

[0160] Constructors:

[0161] SnmpRequest

[0162] public SnmpRequest( )

[0163] This is the default constructor. The user MUST set the SnmpAgent by calling the initRequest method

[0164] SnmpRequest

[0165] public SnmpRequest(SnmpAgent agent)

[0166] This is a constructor for a standalone based application.

[0167] Parameters:

[0168] agent—the SnmpAgent to communicate with

[0169] SnmpRequest

[0170] public SnmpRequest(SnmpAgent agent, int DEBUG_LEVEL)

[0171] This is a constructor for a standalone based application.

[0172] Parameters:

[0173] agent—the SnmpAgent to communicate with DEBUG_LEVEL—the level of debug information desired. The level can range from 0 to 3. A level of 0 provides no debug information and a level of 3 provides all the debug information available. Default is 0.

[0174] SnmpRequest:

[0175] public SnmpRequest(SnmpAgent agent, Applet applet)

[0176] This is a constructor for a client (browser) based applet.

[0177] Parameters:

[0178] agent—the SnmpAgent to communicate with applet—the Applet associated with this request

[0179] SnmpRequest

[0180] public SnmpRequest(SnmpAgent agent, Applet applet, int DEBUG_LEVEL)

[0181] This is a constructor for a client (browser) based applet.

[0182] Parameters:

[0183] agent—the SnmpAgent to communicate with applet—the Applet associated with this request DEBUG_LEVEL—the level of debug information desired. The level can range from 0 to 3. A level of 0 provides no debug information and a level of 3 provides all the debug information available. Default is 0.

[0184] Methods

[0185] initRequest:

[0186] public void initRequest(SnmpAgent agent, Applet applet, int DEBUG_LEVEL) Initializes the SnmpAgent, Applet and debug level of the request. The Applet parameter may be null and the DEBUG_LEVEL parameter may be 0. This method is used with the default constructor SnmpRequest( ) which does not use arguments.

[0187] Parameters:

[0188] agent—the SnmpAgent to communicate with applet—the Applet associated with this request DEBUG_LEVEL—the level of debug information desired. The level can range from 0 to 3. A level of 0 provides no debug information and a level of 3 provides all the debug information available. Default is 0.

[0189] initApi

[0190] public void initApi(SnmpClient client)

[0191] Initializes the SnmpAPI for this request

[0192] Parameters:

[0193] client—the SnmpClient that will handle the SNMP communications

[0194] initSnmp

[0195] public void initSnmp( )

[0196] Initializes the SnmpRequest parameters. This method cleans up previous communications, initializes the SnmpAPI, handles the diagnostics, initializes the SnmpPDU, prints out the SnmpAgent information to the screen and initializes the SnmpSession.

[0197] initSession

[0198] protected void initSession( )

[0199] Initializes the SnmpSession parameters. This method uses the parameters set in for the SnmpAPI, SnmpAgent and Applet to establish communications with a remote device

[0200] initPDU

[0201] public boolean initPDU( )

[0202] Initializes the SnmpPDU for this request This method should be used when using the same SnmpRequest to make multiple requests Returns:

[0203] The boolean value indicating if the PDU was created properly.

[0204] cleanup

[0205] public void cleanup( )

[0206] Note: cleanup( ) is deprecated. This method is no longer required.

[0207] This cleanup method should be called periodically from a thread.

[0208] isInSubTree

[0209] protected boolean isInSubTree(SnmpPDU origPdu, SnmpPDU curPdu) Check if first varbind oid has a root object identifier (OID) as an ancestor

[0210] Parameters:

[0211] origPdu—The original SnmpPDU sent in the getNext sequence

[0212] curPdu—The current SnmpPDU of the getNext sequence

[0213] Returns:

[0214] the boolean value indicating whether this variable is part of the same tree

[0215] setSessionTimeout

[0216] public boolean setSessionTimeout(int timeout)

[0217] Set the amount of time to wait for a response from a device.

[0218] Parameters:

[0219] timeout—The timeout length in milliseconds

[0220] Returns:

[0221] the boolean value indicating whether this was successful

[0222] setSessionRetries

[0223] public boolean setSessionRetries(int retries)

[0224] Set the number of retries to communicate with a device.

[0225] Parameters:

[0226] retries—The number of times to attempt to communicate with a device.

[0227] Returns:

[0228] the boolean value indicating whether this was successful

[0229] setSessionPeername

[0230] public boolean setSessionPeername(String name)

[0231] Set the agent to communicate with.

[0232] Parameters:

[0233] name—The name of the device to communicate with (the IP address of the device).

[0234] Returns:

[0235] the boolean value indicating whether this was successful

[0236] setSessionCommunity

[0237] public boolean setSessionCommunity(String read Community, String write Community)

[0238] Set the community string of the agent.

[0239] Parameters:

[0240] read Community—The read community string of the agent.

[0241] writeCommunity—The write community string of the agent.

[0242] Returns:

[0243] the boolean value indicating whether this was successful

[0244] commitSnmpChanges

[0245] public void commitSnmpChanges( )

[0246] Note: commitSnmpChanges( ) is deprecated. This method is no longer used.

[0247] Commits the communication parameters for the session.

[0248] get

[0249] public int get( )

[0250] This method provides asynchronous communications (non-blocking) to retrieve information from a device. The user should load the SnmpPDU with 1 or more parameters before calling this method. This method will make one request for 1 or more objects.

[0251] Returns:

[0252] the int request ID

[0253] See Also:

[0254] addVar, addVar, addVar

[0255] getNext

[0256] public int getNext( )

[0257] This method provides asynchronous communications (non-blocking) to retrieve information from a device. The user should load the SnmpPDU with 1 or more parameters before calling this method. This method will make one request for the next 1 or more objects in a MIB tree (if any).

[0258] Returns:

[0259] the int request ID

[0260] See Also:

[0261] addVar, addVar, addVar

[0262] get

[0263] public SnmpPDU get(boolean blocking)

[0264] This method provides synchronous communications (blocking) to retrieve information from a device. The user should load the SnmpPDU with 1 or more parameters before calling this method. This method will make one request for 1 or more objects.

[0265] Returns:

[0266] the int request ID

[0267] See Also:

[0268] addVar, addVar, addVar

[0269] set

[0270] public int set( )

[0271] This method provides asynchronous communications (non-blocking) to set information on a device. The user should load the SnmpPDU with 1 or more parameters before calling this method. This method will make one request for 1 or more objects.

[0272] Returns:

[0273] the int request ID

[0274] See Also: addVar, addVar, addVar

[0275] set

[0276] public SnmpPDU set(boolean blocking)

[0277] This method provides synchronous communications (blocking) to set information on a device. The user should load the SnmpPDU with 1 or more parameters before calling this method. This method will make one request for 1 or more objects.

[0278] Returns:

[0279] the int request ID

[0280] See Also:

[0281] addVar, addVar, addVar

[0282] addVar

[0283] public boolean addVar(String oidArgs)

[0284] This method adds one variable to the SnmpPDU.

[0285] Returns:

[0286] the boolean success state

[0287] addVar

[0288] public boolean addVar(String oidArgs[ ])

[0289] This method adds one or more variables to the SnmpPDU.

[0290] Returns:

[0291] the boolean success state

[0292] addVar

[0293] public boolean addVar(String oidArgs, String value, int type)

[0294] This method adds one variable and one value to the SnmpPDU and sets the type of request. This is used to make SNMP sets to a device.

[0295] Returns:

[0296] the boolean success state

[0297] See Also:

[0298] STRING, IPADDRESS, OPAQUE, OBJID, INTEGER, TIMETICKS, COUNTER, GAUGE

[0299] addVar

[0300] public boolean addVar(String oidArgs[ ], String value[ ], int type[ ])

[0301] This method adds 1 or more variables and 1 or more associated values to the SnmpPDU and sets 1 or more associated types of request. This is used to make SNMP sets to a device.

[0302] Returns:

[0303] the boolean success state

[0304] See Also:

[0305] STRING, IPADDRESS, OPAQUE, OBJID, INTEGER, TIMETICKS, COUNTER, GAUGE

[0306] sendPDU

[0307] public SnmpPDU sendPDU( )

[0308] Sends a PDU synchronously (blocking) to a device.

[0309] Returns:

[0310] the Snmp.SnmpPDU variable sent

[0311] sendPDU

[0312] public int sendPDU(SnmpPDU pdu)

[0313] Sends a PDU asynchronously (non-blocking) to a device.

[0314] Returns:

[0315] the Snmp.SnmpPDU variable sent

[0316] exportMessage

[0317] protected void exportMessage(String message, int level)

[0318] Export user messages to a com.coms.S2.ISDUtils.SDLogger if available or to System.err.println otherwise

[0319] debugPrint

[0320] public void debugPrint(String s)

[0321] This debug print method is not currently used.

[0322] authenticate

[0323] public boolean authenticate(SnmpPDU pdu, String community)

[0324] This debug print method is not currently used.

[0325] callback

[0326] public boolean callback(SnmpSession session, SnmpPDU pdu, int reqid)

[0327] This method should be implemented by the user in the extended class. It should return true if the pdu is processed and false otherwise.

[0328] useNetscapeAPI

[0329] public void useNetscapeAPI(boolean useNetscapeAPI)

[0330] This method provides a workaround for security issues for the Netscape browser.

[0331] Parameters:

[0332] useNetscapeAPI—Should be set to true if working in a Netscape browser

[0333] sessionStart

[0334] public void sessionStart( )

[0335] This method provides a workaround for security issues for the Netscape browser. This method should be called after setting the SnmpSession parameters.

[0336] See Also:

[0337] initSession

[0338] sessionStop

[0339] public void sessionStop( )

[0340] This method shutsdown the SnmpSession.

[0341] See Also

[0342] initSession

[0343] apiStop

[0344] public void apiStop( )

[0345] This method shutsdown the SnmpAPI.

[0346] See Also:

[0347] initApi

[0348] setSnmpApiName

[0349] public void setSnmpApiName(String name)

[0350] This method sets the SnmpAPI name

[0351] setSnmpSessionName:

[0352] public void setSnmpSessionName(String name)

[0353] This method sets the SnmpSession name

[0354] setLogger

[0355] public void setLogger(SDLogger logger)

[0356] This method hooks the com.coms.S2.ISDUtils.SDLogger into the SnmpRequest.

[0357] FIG. 5 shows the association of the SnmpAgent class 20 with respect to the associated JAVA.LANG.OBJECT (JAVA language object) 310. The public class SnmpAgent 20 extends the Object. The components of class SnmpAgent 20 include:

[0358] Constructor

[0359] SnmpAgent(String, String, String) The constructor for this class.

[0360] SnmpAgent(String, String, String, String) The constructor for this class.

[0361] Method Index

[0362] getcommunity( ) Returns the write community string of the agent

[0363] getIpAddress( ) Returns the IP address of the agent

[0364] getName( ) Returns the name of the agent

[0365] getReadCommunity( ) Returns the read community string of the agent

[0366] getWriteCommunity( ) Returns the write community string of the agent

[0367] setCommunity(String) Sets the write community string of the agent

[0368] setIpAddress(String) Sets the IP address of the agent

[0369] setName(String) Sets the name of the agent

[0370] setReadCommunity(String) Sets the read community string of the agent

[0371] setWriteCommunity(String) Sets the write community string of the agent

[0372] Constructors

[0373] SnmpAgent

[0374] public SnmpAgent(String agentName, String ipAddress, String community)

[0375] The constructor for this class

[0376] Parameters:

[0377] agentName—The agent name for this agent

[0378] ipAddress—The IP address for this agent

[0379] community—The read/write community string for this agent

[0380] SnmpAgent

[0381] public SnmpAgent(String agentName, String ipAddress, String readCommunity, String writeCommunity)

[0382] The constructor for this class

[0383] Parameters:

[0384] agentName—The agent name for this agent

[0385] ipAddress—The IP address for this agent

[0386] readCommunity—The read community string for this agent

[0387] writeCommunity—The write community string for this agent

[0388] getName

[0389] public String getName( )

[0390] Returns the name of the agent

[0391] Returns:

[0392] the String name of this agent.

[0393] setName:

[0394] public void setName(String agentName)

[0395] Sets the name of the agent

[0396] getIpAddress:

[0397] public String getIpAddress( )

[0398] Returns the IP address of the agent

[0399] Returns:

[0400] The String IP address of this agent.

[0401] setIpAddress

[0402] public void setIpAddress(String ipAddress)

[0403] Sets the IP address of the agent

[0404] getCommunity

[0405] public String getcommunity( )

[0406] Returns the write community string of the agent

[0407] Returns:: the String community string of this agent.

[0408] setCommunity:

[0409] public void setCommunity(String writeCommunity)

[0410] Sets the write community string of the agent

[0411] getReadCommunity

[0412] public String getReadCommunity( )

[0413] Returns the read community string of the agent

[0414] Returns: the String read community string of this agent.

[0415] setReadCommunity

[0416] public void setReadCommunity(String readCommunity)

[0417] Sets the read community string of the agent

[0418] getWriteCommunity

[0419] public String getWriteCommunity( )

[0420] Returns the write community string of the agent

[0421] Returns:: the String write community string of this agent.

[0422] setWriteCommunity

[0423] public void setWriteCommunity(String writeCommunity)

[0424] Sets the write community string of the agent

[0425] The process of the invention relates to the use of the above classes and more particularly to the extension of the SnmpRequest class to provide multiple variable retrievals and settings within one SnmpRequest. The process includes extending the SnmpRequest class and implementing the Advent SNMP.SNMP client class within the extended class.

[0426] The system of the invention is a software JAVA based SNMP (simple network management protocol) library system for use with a management entity and connected devices. The system includes the plurality of classes 212 through 218 which provide descriptions of things that can be accessed. These are inherited by the SnmpVar class 220 which also inherits the SnmpOID class 210. The SNMP application programmer interface (API) or SnmpAPI class 250 provides elements needed for connection. The SnmpSessions class 150 establishes connection between the network management station and connected devices.

[0427] The system provides for call back arguments to be received at the network management station from the device. The relationship of the Callback Args class 110 and SnmpCallback 120 is shown in FIG. 1. The SNMP packet data units (PDUs) are formed comprised of one or more object identifiers (OIDs). The OIDs are each packet specific for a particular request. The system extends the SnmpRequest class for extending the API to allow a plurality of objects to be sent or requested in a single PDU. The extended SnmpSessions class 50 is an extension of the SnmpSessions class 150.

[0428] The process includes extending the SnmpRequest class and implementing the Advent Snmp.SnmpClient class within the extended class as shown in FIG. 1 at 110. In FIGS. 1 and 2 the dashed lines such as dashed line 110 indicate that the class pointed to (by the closed triangle arrow) is implemented within the attached class. The Advent SnmpClient methods requiring implementation are:

[0429] authenticate(SnmpPDU, String)

[0430] This method is used to validate the user authentication with an agent.

[0431] callback(SnmpSession, SnmpPDU, int)

[0432] This is the method that will handle the response received. This method should also handle cases of failures or miscommunications with an agent.

[0433] debugPrint(String)

[0434] This method is used to print debug messages for the developer or end user.

[0435] Within the extended SnmpRequest class 10, one is required to follow a sequence of steps to utilize the SnmpRequest class 10. The steps are as follows:

[0436] Initialize the application programmer interface (API) by calling the initApi( . . . ) method. The argument passed into this method is a reference to this class (e.g. the “this” pointer is handed-in as the argument. A section of code may call another section of code and pass in as arguments, one or more variables. This information can be anything defined by the programmer. In this case a reference to the class is something that tells the receiving class something about the calling class. When a reference of a class to another class is passed, the receiving class will know a lot about the calling class and could potentially change a lot of things in the calling class).

[0437] After calling the initApi( . . . ) method, one should initialize the packet data unit (PDU) by calling the initPDU( ) method. This method does not require any arguments.

[0438] At this point, one needs to instantiate (create) an SnmpAgent object. This is accomplished by handing in the agent name, Internet protocol (IP) address, and a community string to the SnmpAgent constructor of this package. It should be noted that the SnmpAgent can be created at several points within the construction of the extended SnmpRequest class but it must be completed before the call to initSession( ).

[0439] Next, the initSession( ) method should called. This will allow communications between the network management station and the end device.

[0440] Once the above steps are complete, one can then create object identifier (OID) variables to send to the device. To accomplish this, one would use the addVar methods to add one (1) or more variables to the PDU. Once the variables are added, the packet data unit is sent to the device using the “get( )”, “getNext( )” or “set( )” methods (depending upon the request type).

[0441] When the packet returns or the system detects a communication failure, the “callback” method noted above would be called by the system and as noted above, the end user is responsible for how the response is handled.

[0442] package Autodiscovery.classes;

[0443] import java.applet.Applet;

[0444] import java.util.*;

[0445] import Snmp.*; // Advent SNMP package

[0446] import com.coms.S2.ISDSnmp.*; // 3Com ISD SNMP package based on Advent API

[0447] /**

[0448] * SystemPoll class constructor.

[0449] */

[0450] public class SystemPoll

[0451] extends com.coms.S2.ISDSnmp.SnmpRequest

[0452] implements Snmp.SnmpClient

[0453] {

[0454] // Initialized data

[0455] private static String [ ] validSysObjectID =

[0456] {

[0457] “.1.3.6.1.4.1.114.2.1.1.1.1.9”, // BarracudA Rev. 1.1

[0458] “.1.3.6.1.4.1.43.1.16.1.1.1.1” // BarracudA Rev. 1.2+

[0459] };

[0460] // SNMP interface

[0461] private String m_SysObjectID = null;

[0462] private String m_SysObjectIdValue = null;

[0463] private boolean m_IsValidSystemId = false;

[0464] // SNMP data

[0465] public int m_basicStatus = 0;

[0466] public int m_numVars = 0;

[0467] private long m_requestType;

[0468] Snmp.SnmpPDU m_pdu = null;

[0469] Snmp.SnmpPDU m_pduOrig = null; // Keep a copy of the original PDU before it gets sent

[0470] // This is used for testing in the GETNEXT case

[0471] // This is a holder for all the PDUs associated with a getNext call.

[0472] java.util.Vector m_pduGN = new java.util.Vector( );

[0473] SystemPollCallback m_callback = null;

[0474] // Construction

[0475] public SystemPoll(SnmpAgent_agent, SystemPollCallback spc)

[0476] {

[0477] super( );

[0478] agent = _agent;

[0479] m_callback = spc;

[0480] // Use the Netscape security API when needed

[0481] if (System.getProperty(“java.vendor”).toLowerCase( ).indexOf(“netscape”) > = 0 )

[0482] {

[0483] useNetscapeAPI(true);

[0484] }

[0485] // Initialize the Advent SNMP API

[0486] super.initApi(this);

[0487] setSnmpApiName(“Hot System Poll SnmpAPI”);

[0488] // Initialize the packet data unit

[0489] initPDU ( );

[0490] }

[0491] public void Start( )

[0492] {

[0493] // Init the SnmpRequest

[0494] initSession( );

[0495] m_SysObjectID = new String(“.1.3.6.1.2.1.1.2.0”);

[0496] addVar(m_SysObjectID);

[0497] SetSnmpRequest(Snmp.SnmpAPI.GET_REQ_MSG, super.pdu.variables.size( ));

[0498] get( );

[0499] }

[0500] /**

[0501] * SetSnmpRequest

[0502] */

[0503] private void SetSnmpRequest(long requesttype, int numVars)

[0504] {

[0505] m_numVars = numVars;

[0506] m_requestType = requesttype;

[0507] m_pduOrig = super.pdu.copy( );

[0508] }

[0509] public boolean callback(com.coms.S2.ISDSnmp.SnmpSession session, SnmpPDU pdu, int reqid)

[0510] {

[0511] // If this is an SNMP GetNext request then we need to go retrieve more data boolean moreData = false;

[0512] if ( (pdu != null) && (pdu.errstat = = com.coms.S2.ISDSnmp.SnmpStatus.SnmpNoError)

[0513] )

[0514] {

[0515] // Make a copy of this pdu

[0516] m_pdu = pdu.copy( );

[0517] // Print out the contents of the PDU

[0518] if (DEBUG_LEVEL = = 1)

[0519] {

[0520] System. out. printIn(“start--------------------CFBSnmpSession callback----------------------- --start”);

[0521] System.out.printIn(“Request Id (“ +reqid + ”) Error index (“+pdu.errindex + ”) with

[0522] varbinds:”);

[0523] System.out.printIn(pdu.printVarBinds( ));

[0524] System.out.printIn(“stop---------------------CFBSnmpSession callback------------------------ --stop”);

[0525] }

[0526] // Check the PDU for proper sequencing boolean validPdu = this.isinSubTree(pdu);

[0527] // Process the PDU based upon the data returned and some preprocessing

[0528] if ( (pdu != null) && (pdu.errstat = =

[0529] com.coms.S2.ISDSnmp.SnmpStatus.SnmpNoError) )

[0530] {

[0531] m_basicStatus = pdu.errstat;

[0532] String string_val = null;

[0533] long long_val = 0;

[0534] long ticks = 0;

[0535] Snmp.SnmpVarBind varbindRx;

[0536] Snmp.SnmpVarBind varbindTx;

[0537] for (Enumeration vrx = pdu.variables.elements( ), // received PDU variables

[0538] vsx = m_pduOrig.variables.elements( ); // Original PDU variables sent in all cases

[0539] vrx.hasMoreElements( ) && vsx.hasMoreElements( ) ; )

[0540] {

[0541] Object obj = vrx.nextElement( );

[0542] varbindRx = (Snmp.SnmpVarBind)obj;

[0543] varbindTx = (Snmp.SnmpVarBind)vsx. nextElement( );

[0544] String oidStr = varbindRx.oid.toString( );

[0545] String oidSentStr = varbindTx.oid.toString( );

[0546] String oidStrStrip = “ ”;

[0547] if (oidStr.length( ) > = oidSentStr.length( ))

[0548] {

[0549] oidStrStrip = oidStr.substring(0, oidSentStr.length( ));

[0550] }

[0551] string_val = varbindRx.variable.toString( );

[0552] switch (varbindRx.variable.Type)

[0553] {

[0554] case SnmpAPI.INTEGER:

[0555] {

[0556] //System.out.printIn(“SystemPoll.callback( ): INTEGER = ” +string_val);

[0557] }

[0558] break;

[0559] case SnmpAPI.STRING:

[0560] {

[0561] //System.out.printIn(“SystemPoll.callback( ): STRING = ” +string_val);

[0562] }

[0563] break;

[0564] case SnmpAPI.OBJID:

[0565] {

[0566] m_SysObjectIdValue = string_val;

[0567] //System.out.printIn(“SystemPoll.callback: OBJID = ” +string_val);

[0568] }

[0569] break;

[0570] case SnmpAPI.NULLOBJ:

[0571] {

[0572] //System.out.printIn(“SystemPoll.callback: NULLOBJ = ” +string_val);

[0573] }

[0574] break;

[0575] case SnmpAPI.IPADDRESS:

[0576] {

[0577] //System.out.printIn(“SystemPoll.callback: IPADDRESS = ” +string_val);

[0578] }

[0579] break;

[0580] case SnmpAPI.COUNTER:

[0581] {

[0582] //System.out.printIn(“SystemPoll.callback: COUNTER = ” +string_val);

[0583] }

[0584] break;

[0585] case SnmpAPI.GAUGE:

[0586] {

[0587] //System.out.printIn(“SystemPoll.callback: GAUGE = ” +string_val);

[0588] }

[0589] break;

[0590] case SnmpAPI.TIMETICKS:

[0591] {

[0592] //System.out.printIn(“SystemPoll.callback: TIMETICKS = ” +string_val);

[0593] }

[0594] break;

[0595] case SnmpAPI.OPAQUE:

[0596] {

[0597] //System out.printIn(“SystemPoll.callback: OPAQUE = ” +string_val);

[0598] }

[0599] break;

[0600] default:

[0601] {

[0602] //System.out.printIn(“SystemPoll.callback: default = ” +string_val);

[0603] }

[0604] break;

[0605] } // end of switch statement

[0606] // Check to see if this is a GET or SET request. If it is then

[0607] // there is no further data to come so just shove the

[0608] // returned data into the data holder

[0609] if ( m_requestType = = Snmp.SnmpAPI.GET_REQ_MSG ¦ ¦

[0610] m_requestType = = Snmp.SnmpAPI.SET_REQ_MSG)

[0611] {

[0612] m_pduGN.addElement(obj); // Copy the data into the holder

[0613] }

[0614] // If this was a GETNEXT request and the data returned

[0615] // is still along the same branch (i.e. there is more

[0616] // data to retrieve) append the data and get the rest

[0617] else if ( m_requestType = = Snmp.SnmpAPl.GETNEXT_REQ_MSG && validPdu )

[0618] {

[0619] moreData = true; // this must be a GETNEXT with valid data

[0620] m_pduGN.addElement(obj); // Copy the data into the holder

[0621] }

[0622] else

[0623] {

[0624] moreData = false;

[0625] }

[0626] } // end of varbind for loop

[0627] if (moreData && (m_requestType = = Snmp.SnmpAPI.GETNEXT_REQ_MSG) )

[0628] {

[0629] // Clear the pdu

[0630] super.initPDU( );

[0631] for (Enumeration vrx = pdu.variables.elements( ); vrx.hasMoreElements( ); )

[0632] {

[0633] varbindRx = (Snmp.SnmpVarBind) vrx.nextElement( );

[0634] String oidStr = varbindRx.oid.toString( );

[0635] addVar(oidStr);

[0636] } // end of varbind for loop

[0637] // This was a GETNEXT so issue another request

[0638] // for the remaining information

[0639] getNext( );

[0640] }

[0641] else

[0642] {

[0643] m_pdu.variables = (Vector)m_pduGN.clone( );

[0644] // Clear the holder of getNext data

[0645] m_pduGN.removeAllElements( );

[0646] // Pass this through the state machine

[0647] if (m_callback != null)

[0648] {

[0649] m_IsValidSystemId = false;

[0650] for (int id = 0; id < validSysObjectID.length; id + +)

[0651] {

[0652] System.out.printIn(“Compare: ” +agent.getIpAddress( ) +“ ” +validSysObjectID[id]

[0653] + “ ” +m_SysObjectIdValue);

[0654] int val = validSysObjectID[id].compareTo(m_SysObjectIdValue);

[0655] if (val = = 0)

[0656] {

[0657] m_IsValidSystemId = true;

[0658] System.out.printIn(“Valid SysObjectID” +m_SysObjectIdValue);

[0659] break; // break out if we hit one before the end of the list

[0660] }

[0661] }

[0662] if (m_IsValidSystemId = = false)

[0663] {

[0664] System.out.printIn(“Invalid SysObjectID” +agent.getlpAddress( ) + “::”

[0665] +m_SysObjectIdValue);

[0666] }

[0667] m_callback.SysPollCallback(com.coms.S2.ISDSnmp.SnmpStatus.SnmpNoError,

[0668] m_IsValidSystemId, agent.getIpAddress( ));

[0669] }

[0670] }

[0671] } // end if

[0672] } // if

[0673] else if ( (pdu != null) && (pdu.errstat = = com.coms.S2.ISDSnmp.SnmpStatus.SnmpTimeOut))

[0674] {

[0675] m_basicStatus = com.coms.S2.ISDSnmp.SnmpStatus.SnmpTimeOut;

[0676] if (m_callback != null)

[0677] {

[0678] m_callback.SysPollCallback(m_basicStatus, false, (String)null);

[0679] }

[0680] }

[0681] else

[0682] {

[0683] if ((pdu != null) && (pdu.errstat != 0))

[0684] {

[0685] m_basicStatus = pdu.errstat;

[0686] if (DEBUG_LEVEL > = 1)

[0687] {

[0688] System.out.printIn(“CFBSnmpSession Error Indication in response: ”

[0689] +Snmp.SnmpException.exceptionString((byte)pdu.errstat) + “\nErrindex: ” +

[0690] pdu.errindex);

[0691] }

[0692] if (m_callback != null)

[0693] {

[0694] m_callback.SysPollCallback(m_basicStatus, false, (String)null);

[0695] }

[0696] }

[0697] else if (pdu = = null)

[0698] {

[0699] if (m_callback != null)

[0700] {

[0701] m_callback.SysPollCallback(com.coms.S2.ISDSnmp.SnmpStatus.SnmpGenErr,

[0702] false, (String)null);

[0703] }

[0704] }

[0705] }

[0706] FreeResources( );

[0707] return true;

[0708] }

[0709] void FreeResources( )

[0710] {

[0711] if ( System.getProperty(“java.vendor”).toLowerCase( ).indexOf(“netscape”) > = 0 )

[0712] {

[0713] // Attempt to enable required privileges

[0714] try

[0715] {

[0716] netscape.security.PrivilegeManager.enablePrivilege(“Netcaster”);

[0717] }

[0718] catch (netscape.security.ForbiddenTargetException e)

[0719] {

[0720] System.out.printIn(“Unable to set Netscape permissions!”);

[0721] }

[0722] catch (Exception e)

[0723] {

[0724] System.out.printIn(“Exception generated setting Netscape permissions!”);

[0725] }

[0726] }

[0727] // Purge the SnmpRequest PDU

[0728] super.initPDU( );

[0729] // Null out the copy of the returned PDU

[0730] m_pdu = null;

[0731] }

[0732] public void debugPrint(String s)

[0733] System.out.printIn(s);

[0734] }

[0735] public String GetSystemObjectID( )

[0736] {

[0737] return m_SysObjectIdValue;

[0738] }

[0739] public boolean GetValidity( )

[0740] {

[0741] return m_IsValidSystemId;

[0742] }

[0743] public void RegisterCallback(SystemPollCallback spc)

[0744] {

[0745] this.m_callback = spc;

[0746] }

[0747] }

[0748] Various other applications may be provided with the system of the invention and following the process of the invention. The system and process of the invention provide the significant advantage of allowing multiple object identifiers to be retrieved and set via on SNMP Request but still using a JAVA based SNMP Library and particularly using the Advent Net library as a base.

[0749] While specific embodiments of the invention have been shown and described in detail to illustrate the application of the principles of the invention, it will be understood that the invention may be embodied otherwise without departing from such principles.