Agent Technology Commands › awtrap-Send an SNMP Trap PDU from one Node to Another

awtrap-Send an SNMP Trap PDU from one Node to Another

Valid on UNIX/Linux, Windows, z/OS

awtrap sends an SNMP trap protocol data unit (PDU) from the node you are on to another node. Use the awtrap utility to test the ability of a manager to process traps for an agent without running the agent.

Windows

install-path\services\bin

UNIX/Linux, z/OS

install-path/services/bin

z/OS JCL

&CAI.MFNSM.CAW0JCL(AWTRAP)

Syntax

awtrap [-f from_addr] [-h dest_addr] [-p service] [-c community] enterprise type [subtype] [OID oidtype value]

-f from_addr

Host name or IP address of the node sending the trap. If you want the trap to originate from another node, specify that node name or IP address.

Default: Local node

-h dest_addr

Host name or IP address of the node that is the destination of the trap.

Default: Local node

-p service

Name in the /etc/services file that translates to a port number, or the number of the UDP port where the application listens for traps. The SNMP standard port for traps is number 162.

Default: 162

-c community

Name of any valid community in the management application configuration. The community string can be any string that satisfies the community string syntax. This value is used without modification or validation. If the receiver of the trap is validating the community string when analyzing the trap, specify a complete community string that the corresponding agent, which you are simulating, typically sends.

Default: Public

enterprise

Top-level OID in the MIB supported by the agent reporting the trap condition.

type

Generic trap type, as specified in the SNMP standard. Specify type 6 to send an enterprise-specific type.

subtype

Trap subtype for enterprise-specific traps.

OID oidtype value

Specifies the following values:

OID

oidtype

The object identifier of a specific instance of any attribute in the MIB for the agent.

-i integer value

-o octet value

-s string value

-d object identifier (OID)

-a IP address

-c counter

-g gauge

-t time ticks

value

A value relevant to the trap condition. You can use up to 256 bytes. The combination of OID and value creates a unique OID/value pair for the variable bindings list in the trap PDU. You can specify only one OID/value pair using the awtrap utility.