SNMP Send Trap Action

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]" />

See Also

SNMP Get, SNMP Get Next, SNMP Set, SNMP Walk,

Description

Simulates an SNMP trap message being sent from an SNMP agent.

Practical Usage

Used to notify an SNMP network management system of an event or condition in an SNMP agent.

Parameters

General Tab

Agent IP Address

Text, Required
MARKUP: HOST="127.0.0.1"

Specifies the IP Address or host name of the agent.

Community

Text, Required
MARKUP: COMMUNITY="communityname"

Specifies the SNMP community.

Enterprise OID

Text, Required
MARKUP:
a) NAME="system.sysDescr.0"
b) NAME="1.3.6.1.2.1.1.1.0"

Specifies the OID for the network management system. This can be entered in either numeric or string notation format.

Trap Generic Type

Text [Options], Optional, Default: "enterprisespecific"
MARKUP: GENERICTYPE="coldstart"

Specifies the generic type of the trap message.

The available options are:

Trap Specific Number

Number, Optional
MARKUP: SPECIFICTYPE="60"

Specifies the specific trap code. Valid only when Trap Generic Type [GENERICTYPE] is set to the default, enterprise specific.

Advanced Tab

Remote Port

Text, Optional, Default: 162
MARKUP: REMOTEPORT="170"

Specifies the TCP/IP port that should be used for the message. The default is 162.

Time Stamp

Number, Optional, Default: 0
MARKUP: TIMESTAMP="2"

Specifies a custom time stamp. (An expression or variable can be used; press F2 to open the Expression Builder.)

Time Stamp Measure

Text [options], Optional, Default: Seconds
MARKUP: TIMESTAMPMEASURE="minutes"

Specifies the increment to use for the custom time stamp.

SNMP Version

Options, Optional, Default: SNMPv1
MARKUP: SNMPVERSION="snmpv2c"

Specifies the version of the SNMP protocol to use. The default is SNMP version 1.

Data Bindings Tab

Variable Name

Text, Optional
MARKUP:
a) VARBINDNAMES="system.sysDescr.0"
b) VARBINDNAMES="1.3.6.1.2.1.1.1.0"

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.

Variable Value

Text, Optional
MARKUP: VARBINDVALUES="the data"

Specifies the value to assign to the variable.

Variable Syntax

Options, Optional, Default: integer
MARKUP: VARBINDSYNTAXES="ipaddress"

Specifies the data type.

The available options are:

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<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" />