Schedule Trigger

SNMP Trap Condition

Description

Launches task when a SNMP trap is received. Specify filters to watch for specific traps. An SNMP trap is a message sent by an agent to a management system indicating that an event has occurred on the host running the agent.

Practical Usage

Used to integrate tasks with other network systems management software.

Parameters

General Properties

Property

Description

Agent IP Address

Specifies whether the condition will start the task when an SNMP trap is received from any device or only devices within a specific IP range. The available options are:

  • any host:  The task will run when an SNMP Trap is received from any host with no IP address restrictions.

  • a specific host: The task will only run if an SNMP Trap is received from a host within the specified IP Address Range.

  • IP Range Start: Specifies the starting IP address of the range of acceptable IP addresses.

  • IP Range Ends: Specifies the ending IP address of the range of acceptable IP addresses.

Community

Specifies whether the condition will start the task when an SNMP trap is received from any community or only devices within a specific community. The available options are:

  • any community:The task will run when an SNMP Trap is received from any host with no community restrictions.

  • a specific host: The task will only run if an SNMP Trap is received from a host within the specified community.

  • Community: Specifies the community that the trap must originate from in order to condition the task.

Enterprise OID

Specifies whether the condition will start the task when an SNMP trap is received from any Enterprise OID or only devices within a specific Enterprise OID. The available options are:

  • any enterprise OID :The task will run when an SNMP Trap is received from any enterprise OID with no enterprise OID restrictions.

  • a specific enterprise OID: The task will only run if an SNMP Trap is received from a host within the specified enterprise OID.

  • Specific Enterprise OID: Specifies the enterprise OID that the trap must originate from in order to condition the task.

Trap Generic Type

Specifies whether the condition will filter out traps that are not intended for a specific generic type. The available options are:

  • Any Type

  • Enterprise Specific

  • Cold Start

  • Warm Start

  • Link Down

  • Link Up

  • Authentication Failure

  • Egp Neighbor Loss

Trap Specific Type

 

Causes the condition to capture the type of the condition if "Enterprise Specific" is selected for "Trap Generic Type". The available options are:

  • any code: The condition will listen to traps sent with any Code.

  • a specific code: The condition will only listen for traps sent with the code specified in the specific code parameter.

    • Trap specific code type: Specifies the trap specific code type.

 

Authentication Properties

Property

Description

Accept authenticated traps from these users

Specifies the users in which to accept authenticated traps. Click the Click here to add new item link to add a new item. The available values are:

  • User - Enter the username

  • Auth. Password - Enter the password

  • Encryption - Enter the encryption type. The available options are:

    • No encryption (default)

    • DES

    • AES

    • 3DES

  • Private Password - Enter the private password related to the encryption type.

Accept authenticated Version 3 traps

If enabled, Version 3 traps will be accepted (disabled by default).

 

Data Properties

Property

Description

Use String notation for OIDs

If enabled, IODs will be entered as string notations (disabled by default).

Use String notation for timetick values

If enabled, timetick values will be entered as string notations (disabled by default).

Behavior Properties

The Behavior tab properties dictate how the system should react upon the occurrence of a condition. These properties are significant in determining whether the AutoMate Condition should act as a trigger object (used to fire off workflow execution), wait object (used to suspend workflow execution) or conditional (decision making) object.

More about condition behavior

AMTrigger

When this trigger is activated, it automatically passes the "AMTrigger" object to the task. AMTrigger can be used within a task to determine whether or not the task was started by a trigger, which trigger started the task, when the trigger was activated and other trigger related properties. F

Exclusive AMTrigger Fields

The AMTrigger fields described in the table below are specific only to the SNMP Condition.

Name

Type

Return Value

AMTrigger.GenericType

 

Text

Returns the generic type for the SNMP trap when the task was triggered. The possible return values are:

  • enterprisespecific: an enterprise-specific event has occurred

  • coldstart: reinitialization of the agent with alteration of configuration

  • warmstart: reinitialization of the agent without alteration of configuration

  • linkdown: failure in one of the communication links

  • linkup: restoration of one of the communication links

  • authenticationfailure: reception of a protocol message not properly authenticated

  • egpneighborloss: loss of an EGP peer relationship of the EGP protocol

AMTrigger.SpecificType

Text

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

AMTrigger.ObjectType

Text

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

AMTrigger.Host

Text

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

AMTrigger.Community

Text

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

AMTrigger.TimeStamp

Text

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

AMTrigger.BindingVarNumber

Text

Returns the total number of variables that were sent with the SNMP trap.

AMTrigger.VarName[i]

Text

Returns the associated variable name that was sent with the SNMP trap. Use AMTrigger.BindingVarNumber to find the total number of available variables. To use this property, simply append the number to the end if the property name - it is not an array.  Example %AMTrigger.VarName2%

AMTrigger.VarValue[i]

Text

Returns the associated variable value that was sent with the SNMP trap. Use AMTrigger.BindingVarNumber to find the total number of available variables. To use this property, simply append the number to the end if the property name - it is not an array.  Example %AMTrigger.VarValue2%.

AMTrigger.VarSyntax[i]

Text

Returns the associated variable syntax (such as integer) that was sent with the SNMP trap. Use AMTrigger.BindingVarNumber to find the total number of available variables. To use this property, simply append the number to the end if the property name - it is not an array.  Example %AMTrigger.VarSyntax2%.

AMCondition

When this condition is used in the middle of a workflow (as opposed to triggering condition) it automatically passes the AMCondition object to the task.

Exclusive AMCondition Fields

The AMCondition fields described in the table below are specific only to the SNMP Condition.

Name

Data Type

Return Value

AMCondition.GenericType

Text

Returns the generic type for the SNMP trap when the condition was activated. The possible return values are:

  • enterprisespecific: an enterprise-specific event has occurred

  • coldstart: reinitialization of the agent with alteration of configuration

  • warmstart: reinitialization of the agent without alteration of configuration

  • linkdown: failure in one of the communication links

  • linkup: restoration of one of the communication links

  • authenticationfailure: reception of a protocol message not properly authenticated

  • egpneighborloss: loss of an EGP peer relationship of the EGP protocol

AMCondition.SpecificType

Text

Returns the specific type for the SNMP trap when the condition was activated.

AMCondition.ObjectType

Text

Returns the object type for the SNMP trap when the condition was activated.

AMCondition.Host

Text

Returns the host specified in the SNMP trap when the condition was activated.

AMCondition.Community

Text

Returns the community specified in the SNMP trap when the condition was activated.

AMCondition.TimeStamp

Text

Returns the timestamp specified in the SNMP trap when the condition was activated.

AMCondition.BindingVarNumber

Text

Returns the total number of variables that were sent with the SNMP trap when the condition was activated.

AMCondition.VarName[i]

Text

Returns the associated variable name that was sent with the SNMP trap when the condition was activated. Use AMCondition.BindingVarNumber to find the total number of available variables. To use this property, simply append the number to the end if the property name - it is not an array.  Example %AMCondition.VarSyntax2%.

AMCondition.VarValue[i]

Text

Returns the associated variable value that was sent with the SNMP trap when the condition was activated. Use AMCondition.BindingVarNumber to find the total number of available variables. To use this property, simply append the number to the end if the property name - it is not an array.  Example %AMCondition.VarSyntax2%.

AMCondition.VarSyntax[i]

Text

Returns the associated variable syntax (such as integer) that was sent with the SNMP trap when the condition was activated. Use AMCondition.BindingVarNumber to find the total number of available variables. To use this property, simply append the number to the end if the property name - it is not an array.  Example %AMCondition.VarSyntax2%.

 

NOTE: A full list of AMCondition and AMTrigger objects exclusive to each Event/Condition can be viewed from the Expression Builder by expanding the Objects folder and selecting the desired object from either the Triggers or Conditions folder.

See Also


About Events & Conditions | Condition Behavior | Event Log Condition | File Condition | Idle Condition | Key Event | Logon Condition | Performance Condition | Process Condition | SNMP Trap Condition | Window Condition | WMI Condition