AMTrigger - SNMP Trap

Description

When a task is triggered, a pre-named (or fixed field) dataset called AMTrigger is created and populated with a collection of data related to the event or condition that initially triggered execution. AMTrigger is a standard Automate dataset which can be used within a task to examine particular characteristics about the initiated trigger, such as the type of event that activated the trigger, when it occurred and  what computer it occurred on.

Parameters

The total number of fields that AMTrigger creates during runtime and what they are named depends largely on the trigger that launched the task. Each trigger contains its own set of unique AMTrigger values. The table below lists the AMTrigger values related to the SNMP Trap trigger. For more details about an individual AMtrigger value, click the associated link.

Name

Data Type

Return Value

AMTrigger.Community

String

Returns the community specified in the SNMP trap when the task was triggered.

AMTrigger.EncryptionAlgorithm

String

Returns the encryption algorithm used by SNMPv3 (i.e. MD5, SHA).

AMTrigger.EngineID

String

Returns the SNMP Engine ID. An SNMP engine is a copy of SNMP that can reside on a local or remote device. To retrieve or manipulate management information using SNMP version three (SNMPv3) it is necessary to know the identifier of the SNMP protocol engine.

AMTrigger.Enterprise

String

Identifies the type of managed object that generates the trap.

AMTrigger.GenericType

String

Returns the generic type for the SNMP trap when the task was triggered.

AMTrigger.Host

String

Returns the host specified in the SNMP trap when the task was triggered.

AMTrigger.SNMPVersion

String

Returns the SNMP version (i.e. SNMPv1, SNMPv2c, SNMPv3).

AMTrigger.SpecificType

String

Returns the specific type for the SNMP trap that triggered the task.

AMTrigger.TimeStamp

String

Returns the timestamp specified in the SNMP trap when the task was triggered.

AMTrigger.User

String

Returns the SNMP user. An SNMP user is a remote user for which an SNMP management operation is performed. For example, inform operations can be sent to a user on a remote SNMP engine.

AMTrigger.VariableBindingCount

String

The number of variables requested by SNMP manager.

AMTrigger.VariableBindings

String

Returns the variable bindings. Variable Bindings represent a set of OID/Value pairs. Each value available through SNMP is identified by a unique object identifier. To enable mapping of object identifiers to their values a special sequence is required. That sequence is variable binding.