User guide

Setting Up Fault Management Configuring Trap Parsers
916
AlliedView NMS Administration Guide
9.3.1 Using Trap Values in the PDU
To help define the values for the event output, tokens are available in the incoming trap PDU. These can be used when
defining the output values for the trap parser. These are listed in the following table.
TABLE 9-3 Tokens to Access the Properties of the Trap PDU
Token Description
$Agent SNMP V1 Traps: If the device corresponding to the agent address returned by the trap has already
been discovered by Web NMS, then this token will fetch the name of the parent Managed Object,
corresponding to the interface object matching the agent address of the trap received. If the device
corresponding to the agent address of the trap has not been discovered, then this token will return
the corresponding IP address of the agent address from which the trap has been received.
For example, if a trap is received from an agent and if the corresponding device has already
been discovered by AlliedView NMS, then the interface object will be IF-web server and the
name of the parent managed object will be web server. In this scenario, $Agentwill return
webserver. In case the device is not yet discovered, then $Agent will return the IP address
(192.168.1.30.).
SNMP V2c & v3 Traps: If the device corresponding to the source address contained by the
trap received has already being discovered by AlliedView NMS, then this token will fetch
the name of the parent Managed Object, corresponding to the interface object matching
the source address of the received trap. If the device corresponding to the source address
of the trap has not yet been discovered, then this token will return the IPaddress of the
Source of the Trap.
$Community This token will be replaced by the community string of the received trap.
$Enterprise This token will be replaced by the enterprise id of the received trap. Applicable only in the case of
SNMP traps, or else replaced with a blank.
$GenericTyp
e
This token will be replaced by the generic type of the received trap. Applicable only in the case of
SNMP v1 traps, or else replaced with a blank.
$Source If the device corresponding to the source address contained by the trap received, has already been
discovered by AlliedView NMS, then this token will fetch the name of the parentManaged object,
corresponding to the interface object matching the source address of the received trap. If the device
corresponding to the source address of the trap received has not yet been discovered then the
corresponding IP address of the source address will be returned.
$SpecificType This token will be replaced by the specific type of the received trap. Applicable only in the case of
SNMP v1 traps, or else replaced with a blank.
$Uptime This token will be replaced by the uptime value in the received trap.
$TrapOID This token will be replaced by the trap OID of the received trap. Applicable only in the case of SNMP
v2C traps, or else replaced with a blank.
$* This token will be replaced by all the variable bindings (both OID and variable values) of the received
trap. for example, for the following varbinds,
2.2.1.1.221 INTEGER 30 .1.3.6.1.2.1.1.1 STRING abc 2.2.1.1.1 INTEGER 10
the result will be: ifIndex: 30, sysDescr: abc, ifIndex: 10
$# This token will be replaced by all the variable binding values (only variable values and not OIDs) of the
received trap. For example, for the following varbinds,
2.2.1.1.221 INTEGER 30 .1.3.6.1.2.1.1.1 STRING abc 2.2.1.1.1 INTEGER 10
the result will be: 30, abc, 10