ipworksssnmp
Class SnmpmgrTrapEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--ipworksssnmp.SnmpmgrTrapEvent

All Implemented Interfaces:

java.io.Serializable

public class SnmpmgrTrapEvent

extends java.util.EventObject

Fired when a SNMP trap packet is received.

The TRAPMGR bean should normally be used to receive traps, since it was designed and contains functionality specifically for that purpose. The SNMPMgr component can only receive traps from the agent that it is has most recently discovered with the Discover method.

The TrapOID and TimeStamp parameters contain the Trap OID and TimeStamp. In the case of an SNMPv1 trap, these values are retrieved from the PDU header, and TrapOID will be a concatenation of the values for TrapEnterprise, GenericTrap, and SpecificTrap, separated by '.'. For SNMPv2 and above, they are read from the variable-value list (if available).

For SNMPv3, the User parameter shows the user that was supplied with the packet. This parameter MUST be used together with the SecurityLevel parameter which shows the level of security in the message.

The SecurityLevel parameter shows whether the request has been authenticated. If SecurityLevel is 0, the request has NOT been authenticated (i.e. the packet signature has not been verified). For an authenticated, non encrypted request, SecurityLevel is 1. For an authenticated and encrypted request, SecurityLevel is 2.

The SNMPMgr bean is limited to accepting authenticated traps only for the user specified in User and Password and from the engine specified in RemoteEngineId with time parameters in RemoteEngineBoots and RemoteEngineTime (usually this is the SNMP engine discovered through the last call to Discover ). If authenticated traps come from a different engine, or for a different user, they are ignored, and a BadPacket event is fired instead.

The list of variables in the SNMP packet, including optional values and types, is provided through the ObjId , ObjType , and ObjValue properties. The ObjCount property displays the number of variables. These variables must be copied to another location before the event has completed executing, or they may be overridden by other events.

The SourceAddress and SourcePort parameters show the address and port of the sender as reported by the TCP/IP stack.

See Also:

Snmpmgr, Snmpmgr.TrapEvent, Serialized Form

Field Summary

java.lang.String	community
int	requestId
int	securityLevel
int	SNMPVersion
java.lang.String	sourceAddress
int	sourcePort
int	timeStamp
java.lang.String	trapOID
java.lang.String	user

Fields inherited from class java.util.EventObject

source

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

requestId

public int requestId

SNMPVersion

public int SNMPVersion

community

public java.lang.String community

user

public java.lang.String user

securityLevel

public int securityLevel

trapOID

public java.lang.String trapOID

timeStamp

public int timeStamp

sourceAddress

public java.lang.String sourceAddress

sourcePort

public int sourcePort