Description
Simulates an SNMP trap message being sent from an SNMP agent.
Used to notify an SNMP network management system of an event or condition in an SNMP agent.
Declaration
<AMSNMPSENDTRAP HOST="text" COMMUNITY="text" REMOTEPORT="number" SNMPVERSION="text [options]" ENTERPRISE="text" GENERICTYPE="text [options]" SPECIFICTYPE="number" TIMESTAMP="number" TIMESTAMPMEASURE="text [options]" VARBINDNAMES="text" VARBINDVALUES="text" VARBINDSYNTAXES="text [options]" />
Example
<AMSNMPSENDTRAP HOST="127.0.0.1" COMMUNITY="CommunityName" REMOTEPORT="178" SNMPVERSION="snmpv2c" ENTERPRISE="1.3.16.1.5.1.311.1.1.3" SPECIFICTYPE="60" TIMESTAMP="20" TIMESTAMPMEASURE="milliseconds" VARBINDNAMES="1.3.16.1.5.1.311.1.1.3.1.1" VARBINDVALUES="450" VARBINDSYNTAXES="integer" />
General Tab Parameters
Agent IP address: Specifies the IP Address or host name of the agent.
Text, Required
MARKUP: HOST="127.0.0.1"
Community: Specifies the SNMP community.
Text, Required
MARKUP: COMMUNITY="communityname"
Enterprise OID: Specifies the OID for the network management system. This can be entered in either numeric or string notation format.
Text, Required
MARKUP:
a) NAME="system.sysDescr.0"
b) NAME="1.3.6.1.2.1.1.1.0"
Trap generic type: Specifies the generic type of the trap message.
(Default) enterprisespecific: the type is specified by the trap specific code in the Trap Specific Number [SPECIFICTYPE] parameter
coldstart: agent is booting
warmstart: agent is rebooting
linkdown: an interface has gone down
linkup: an interface has come up
authenticationfailure: an invalid community was received in a message
egpneighborloss: an egp peer has gone down
Text [Options], Optional, Default: "enterprisespecific"
MARKUP: GENERICTYPE="coldstart"
Trap specific number: Specifies the specific trap code. Valid only when Trap Generic Type [GENERICTYPE] is set to the default, enterprise specific.
Number, Optional
MARKUP: SPECIFICTYPE="60"
Advanced Tab Parameters
Remote port:
Specifies the TCP/IP port that should be used for the message. The default
is 162. Click the Expression Builder icon 
to build and insert an expression or variable.
Text, Optional, Default: 162
MARKUP: REMOTEPORT="170"
Use Custom time for time stamp: Select the check box, then specify a custom time stamp.
Number, Optional, Default: 0
MARKUP: TIMESTAMP="2"
Specify the increment to use for the custom time stamp: milliseconds, seconds, minutes, or hours.
Text [options], Optional, Default:
Seconds
MARKUP: TIMESTAMPMEASURE="minutes"
SNMP version: Specifies the version of the SNMP protocol to use. The default is SNMP version 1.
Options, Optional, Default: SNMPv1
MARKUP: SNMPVERSION="snmpv2c"
Data Bindings Tab Parameters
Click Add to define a variable binding.
After you click OK, the variable binding is added to the list.
Variable name: Specifies the name/OID for a variable to be associated with a value in order to further define the trap notification. This can be entered in either numeric or string notation format.
Text, Optional
MARKUP:
a) VARBINDNAMES="system.sysDescr.0"
b) VARBINDNAMES="1.3.6.1.2.1.1.1.0"
Variable value: Specifies the value to assign to the variable.
Text, Optional
MARKUP: VARBINDVALUES="the data"
Variable syntax: Specifies the data type.
integer: an integer
octetstring: an octet string
objectid: an object identifier
null: a null value
ipaddress: an IP Address
counter32: a 32-bit counter
gauge32: a 32-bit gauge
timeticks: a time tick
opaque: opaque
counter64: a 64-but counter
unsignedinteger32: a 32-bit unsigned integer
Options, Optional, Default: integer
MARKUP: VARBINDSYNTAXES="ipaddress"
See Also