Using the SNMP Utilities
4.2 Using the Trap Sender and Trap Receiver Programs
By default, these programs use UDP port 162. However, you can specify another
port with the
-p
flag or set up an SNMP-trap service that specifies the port you
want to use. Note, however, that the use of UDP port 162 is coded into standard
MIBs.
Both programs support the use of the UDP (default) and TCP transports.
However, the standard TCP/IP subagents and the Chess example use UDP
only. Therefore, if you specify the
-tcp
flag when you enter the
snmp_traprcv
command, the program uses TCP to process traps only from the trap sender
program or from a user application written to use TCP.
The following sections explain how to enter commands for both programs.
Because flags and data types are case sensitive, you should always enter them in
the case that is specified. If a letter or value is specified as uppercase, you must
enclose it in quotation marks. In general, if you use uppercase letters where
lowercase is specified, the results are unpredictable. For example, flag
"-v2C"
functions correctly but flag
"-V2c"
does not, because the flag character (
v
) must
be lowercase.
4.2.1 Entering Commands for the Trap Sender Program
The trap sender program lets you send SNMP Version 1 and SNMP Version 2
trap messages. You should use this program only when you want to test the
client or when significant state changes occur on the managed node.
The trap sender program encodes an SNMP Version 1 trap PDU (see RFCs 1155,
1156, 1157, and 1215) or an SNMP Version 2 trap PDU (see RFCs 1905 and 1908)
into an SNMP message and sends it to the specified hosts. You use parameters
and flags to specify the data fields in the trap PDU.
Traps are uniquely identified in the PDU:
•
SNMP Version 1 is identified by a combination of parameters.
•
SNMP Version 2 is identified by the value of
snmpTrapOID
.
To run the trap sender program, do the following:
1.
Define a foreign command for the program:
$ snmp_trapsnd == "$SYS$SYSTEM:TCPIP$SNMP_TRAPSND"
Alternatively, you can run the SYS$MANAGER:TCPIP$DEFINE_
COMMANDS.COM procedure to define all the foreign commands available
with TCP/IP Services.
2.
Enter a command using the following format:
snmp_trapsnd enterprise agent generic-trap specific-trap timeticks
[-v version] [-c community] [-d] [-h host] [-p port] [-tcp]
[variable_name [data-type value]]
4.2.1.1 Trap Sender Parameters
Table 4–4 describes the
snmp_trapsnd
parameters. Each parameter is required,
but you can specify zero, as appropriate.
Using the SNMP Utilities 4–9