CA Automation Point Keywords › Keywords for CA NSM Event Traffic Controller › SNMPTRAP Keyword

SNMPTRAP Keyword

SNMPTRAP keyword sends an SNMP trap to the specified host.

This keyword has the following format:

SNMPTRAP(HOST(HostName|*) [COMMUNITY(CommunityName) ]
  GTRAP (GenericTrapNum) STRAP (SpecificTrapNum)
  DATA(OID, type, value)[ DATA(OID, type, value)]...)

HOST

Specifies the name of the host to which to send the trap.

Note: Specifying an asterisk (*) sends an SNMP trap to all host names designated for message forwarding in the Configuration Manager.

COMMUNITY

Specifies the SNMP community to which to send the trap. This option may be used to override the default of PUBLIC.

GTRAP

Defines the class of generic trap being sent. This value is a single digit, in the range of 0 to 6. Under most circumstances, use code 6 to indicate that a system-specific SNMP trap code is being used.

The following codes numeric codes have specific industry standard meanings as predefined by the Internet Activities Board (IAB):

0

Indicates a coldstart.

1

Indicates a warmstart.

2

Indicates a link down.

3

Indicates a link up.

4

Indicates an authentification failure.

5

Indicates EGP neighbor loss.

STRAP

Specifies a system-specific trap number up to a 32-bit integer.

DATA

Specifies the type and value of the data:

type

Specifies the type of the trap

value

Specifies the value of the data

You can repeat this operand up to 20 occurrences.

Example:

The following example sends the enterprise-specific trap number 1 to the host named UNIHOSTA. The trap information is related to an SNMP MIB (management information base) object whose OID (object identifier) is 999.2.1.3. The integer data value being reported for the OID is 777.

SNMPTRAP(HOST(UNIHOSTA) GTRAP(6) STRAP(1) DATA(999.2.1.3,INTEGER,777))