SNMP Set Action

Description

Issues a SNMP Set message to a SNMP agent in order to alter the value of a variable..

This action can be used to set the value of an SNMP Variable on an SNMP capable agent such as a router.

Declaration

<AMSNMPSETREQUEST HOST="text" NAME="text" COMMUNITY="text" REMOTEPORT="text" TIMEOUT="text" BROADCASTDELAY="text" SNMPVERSION="options" VALUE="text" SYNTAX="options" RESULTDATASET="text">

Example

<AMSNMPSETREQUEST HOST="localhost" NAME="1.3.6.1.2.1.1.6.0" COMMUNITY="public" VALUE="Main Building Floor 3 suite 302" />

General Tab Parameters

Agent IP address: Specifies the IP address or host name of the agent to communicate with.

Text, Required
MARKUP: HOST="c:\file.xls"

Variable name: Specifies the SNMP Variable to set. This value can be an OID either numeric or human-readable format.  (This is not an Automated Workflow variable)

Text, Required
MARKUP: NAME="system.sysDescr.0"
or NAME="1.3.6.1.2.1.1.1.0"

Community: Specifies the SNMP community.

Text, Required
MARKUP: COMMUNITY="communityname"

Variable syntax: Specifies the type of data that will be set in the variable value parameter.

  • integer: Specifies that value is an integer (number)

  • octetstring: Specifies that value is an octet string

  • objectid: Specifies that the value is an object identifier

  • null: Specifies that the value is a null value

  • ipaddress: Specifies that the value is an IP Address

  • counter32: Specifies that the value is a 32-bit counter

  • gauge32: Specifies that the value is a 32-bit guage

  • timeticks: Specifies that the value is a time tick

  • opaque: Specifies that the value is opaque

  • counter64: Specifies that the value is a 64-but counter

  • unsignedinteger32: Specifies that the value is a 32-bit unsigned integer

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

Variable value: Specifies the value to set.

Text, Required
MARKUP: VALUE="the data"

Advanced Tab Parameters

Remote port: Specifies the TCP/IP port that should be used for the SNMP Get request. The default is 161.

Text, Optional Default 161
MARKUP: REMOTEPORT="5555"

Time out: Specifies the amount of time in milliseconds, seconds, minutes, or hours that the action should wait for a response before generating an error. The default is 30.

Text, Optional Default 30
MARKUP: TIMEOUT="999"

Broadcast delay: Only valid when IP address is set to a broadcast address. Specifies the amount of time in milliseconds, seconds, minutes, or hours that the action should wait for a response when broadcasting. The default is 3 seconds.

Text, Optional Default 3
MARKUP: BROADCASTDELAY="10"

SNMP version: Specifies the version of the SNMP protocol to use. The default is SNMP version 1 as it is the most prevalent.

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

Data Tab Parameters

Create and populate dataset: Specifies the name of the dataset that will be created and populated with the results of the request.

Yes/No, Optional - Default NO
MARKUP:
a) VISIBLE="no"

See Also

SNMP Get, SNMP Get Next, SNMP Set, SNMP Walk, SNMP Send Trap