Release Features 3.2 to 3.3

• Changes from release 3.2 to 3.3

• Low Level API (snmp2 package)

• MIB Support API (mibs package)

• High Level API (beans and ui package)

• SAS API (sas package)

• RMI API (rmi package)

Changes from release 3.2 to 3.3

New features added to this release

Internationalization support has been added. This allows applications and applets developed using the AdventNet SNMP API to be deployed in various languages without any change in the code.

Support for co-existence, Notification filtering, and Proxy forwarding has been added in the low-level API. These features confirm to the RFC specifications 2573 and 2576.

Logging feature has been added. This allows applications and applets to log the debug, error, and result messages.

The other new features and enhancements that are added in this release are:

Low-Level API (snmp2 package)

1. setCharacterEncoding(java.lang.String) and getCharacterEncoding() methods have been added to the SnmpAPI class for character encoding support.

2. New interface ConnectionListener has been added to the snmp2 package which contains two methods namely processConnectionDown() and processConnectionUp(). This interface lets the user know the status of the connection. If this interface is implemented, the processConnectionDown() method is invoked when the socket at the remote end is closed.

3. Package com.adventnet.snmp.snmp2.security.community is added for the co-existence support.

4. Methods related to co-existence support and notification filtering is added in the SnmpAPI and SnmpSession classes.

5. Method addSNMPClientWithID(SnmpClient client) is added in the SnmpSession class. The client ID returned by this method has to be set in the PDU while sending the request. SnmpSession class calls this client 's callback method when it receives response.

6. Method removeSNMPClientWithID(int clientid) is added to the SnmpSession class. This method is called when addSNMPClientWithID() method is used for registering client in SnmpSession class. As argument, client has to pass the client ID that it is received while registering addSNMPClientWithID() method.

7. Methods setClientID(int id) and getClientID() are added to the SnmpPDU class. These methods are useful for identifying the client which sends the PDU.

8. Method partialSet(SnmpPDU pdu) is added to the SnmpSession class. This method is used for performing SNMP SET for valid OIDs only, while doing a multi-varbind SNMP SET request.

9. The inter-packet delay feature has been added. To support this, two new methods have been added to the SnmpSession class.

• setTimeToWait(int) - Sets the inter-packet delay time. The timeout value to be set for the request should be taken care by the user. This method should be used only when the underlying protocol is UDP.

• getTimeToWait() - Gets the inter-packet delay time set on this SnmpSession object.

MIB Support API (mibs package)

1. The zeroDotZero OID is added as the standard node. If the MIB file contains the zeroDotZero OID in the DEFVAL field, it is added to the OID list.

2. Method getImports() is added to the MibModule class.

3. Method getTrapType() is added to the MibTrap class.

4. Methods isIndex() and getExternalIndices() are added to the MibNode class.

5. The setDatabaseName(byte) method is added to the MibOperations class.

6. While parsing the MIB files, the MACRO DEFINITION in the MIB file is ignored.

7. While parsing the MIB files, appropriate error messages are provided if an exception occurs.

High Level API (beans and ui package)

1. The getHoles() method is added to the SnmpTable bean. This is useful in handling the table data which are not-implemented by the agent.

2. In the TrapViewer bean, method setTrapAuthEnable(boolean isAuth) has been added for specifying whether traps should be authenticated while receiving SNMPv3 trap messages.

3. In the SnmpTablePanel bean, while displaying partial table columns, editing the columns are made possible for enumerated data types.

4. Internationalization support is added to the MibBrowser.

5. Method addLogClient(LogInterface client) is added to the SnmpTarget, SnmpRequestServer, and SnmpTrapReceiver beans to support the logging of messages.

6. In the SnmpTablePanel window of MibBrowser, option has been provided in the Settings panel for changing the table OID which avoids instantiating multiple tables from MibBrowser.

7. In the SnmpTablePanel bean, option has been provided in the Settings panel for setting the Max Repetitions value. By default, it is 5.

8. Support for external indices is provided in SnmpTablePanel for SMIv1 MIBs.

9. SasFileDialog has been enhanced to provide JFileChooser and filtering options. The methods are:

• setDirectory(String) - for current directory setting.

• setFileExtension(String) - for setting filter for file extensions.

• setFilterItems(Vector names, Vector extensions) - for setting the filter items in combo box of SasFileDialog has been added.

10. If there are multiple instances of SnmpRequestServer sharing single instance of SnmpSession, the callback of the respective client which sends the request is called. This improves the performance of the SnmpRequestServer.

11. Methods getAbsoluteCounters() and setAbsoluteCounters(boolean absoluteCounters) are added to the LineGraphBean. This is used to set the counter values to absolute or differ between the successive counters.

12. In the MibBrowser's MibTree, buttons are provided for expanding and collapsing the tree.

13. In the MibBrowser, MibNode description is enhanced to have more information about the MibNode.

14. The methods setTimeToWait(int millisecs) and getTimeToWait() have been added to the SnmpServer class to provide inter packet delay.

15. The setMibOperations(MibOperations mibOps) method has been added in the SnmpServer class. This can be used when the user wants to use local MibOperations instead of the static MibOperations shared by all beans. The same method has been added to the MibBrowser class also.

16. Method getErrorIndex() has been added to the SnmpTarget class. This method returns the error index corresponding to the error OID in the PDU.

SAS API (sas package)

1. A new method setPortFileName(String filename) has been added to the SAServer class. This method enables the user to configure the filename for storing the port value in which the SAServer has been added.

RMI API (rmi package)

1. Methods startPollingTable(), setObjectIDList(), and refreshTable() have been added to the SnmpTable interface.

2. Method addLogClient(LogInterface client) is added to the SnmpTarget interface to support the logging of messages.

3. Methods setAttemptComplete(), getAttemptComplete(), setVarBindCount(), getVarBindCount() has been added to the SnmpTarget interface.