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 a manager's ability to process an agent's traps without running the agent.

Windows

install-path\services\bin

UNIX/Linux, z/OS

install-path/services/bin

z/OS JCL

&CAI.MFNSM.CAW0JCL(AWTRAP)

This command has the following format:

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

-f from_addr

Specifies the 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

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

Default: Local node

-p service

Specifies the 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

Specifies the 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, then you must specify a complete community string that the corresponding agent, which you are simulating, would normally send.

Default: Public

enterprise

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

type

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

subtype

Specifies the 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 agent's MIB.

Can be one of the following:

-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.