Content-type: text/html Man page of TRAPSEND

TRAPSEND

Section: Misc. Reference Manual Pages (SR_CMDMAN)
Updated: 23 July 1993
Index Return to Main Contents
 

NAME

trapsend - send SNMP traps to monitoring station  

SYNOPSIS

SNMPv1: trapsend addr community gen-trap [v1e-trap]
SNMPv2: trapsend addr clustername trapOID [v2e-trap]
 

DESCRIPTION

The trapsend utility demonstrates how to send trap messages to trap monitoring stations. This utility can send SNMPv1 and SNMPv2 traps and only works on UNIX machines. The arguments to trapsend depend on whether SNMPv1 traps or SNMPv2 traps are being sent.

For SNMPv1 traps:

addr:
the IP address of the monitoring station.
community:
a SNMPv1 community string.
gen-trap:
the generic trap number.
[v1e-trap]:
is optional information, especially for enterprise specific traps. The format of the v1e-trap entries are:

spec-trap enterprise sysUpTime [variable_name type value]...

where spec-trap is the specific trap number,

enterprise is the enterprise ,

sysUpTime is the actual value of the variable sysUpTime,

[variable_name type value]... is zero or more variable triplets, ala setany(SR_CMDMAN).

For SNMPv2 traps:

addr:
the IP address of the monitoring station.
clustername:
a SNMPv2 clustername.
trapOID
is the trap OID to become the value of snmpTrapOID.0. Name forms, such as coldstart or myWonderfulEntTrap are permitted.
[v2e-trap]
is optional information, especially for enterprise specific traps. The format of the v2e-trap entries are:

sysUpTime [variable_name type value]...

where sysUpTime is the actual value of the variable sysUpTime,

[variable_name type value]... is zero or more variable triplets, ala setany(SR_CMDMAN).

 

EXAMPLES

 

Generic traps:

SNMPv1:
trapsend myagent woof 0
would send an SNMPv1 cold-start trap to the machine myagent, and

SNMPv2:

trapsend myagent Mgr1Agt1 snmpTraps.2
would send an SNMPv2 warm-start trap to the machine myagent.
 

Enterprise-specific traps:

SNMPv1: trapsend myagent TopSecret 6 2 myCompany.0 4974123 \ sysDescr.0 -D "Our Agent" sysLocation.0 \ -D "1st Floor"

would send an enterprise-specific trap, myCompany.0 and include the trailing variable information.

SNMPv2: trapsend myagent Mgr1Agt1 myTrap 4974123 sysDescr.0 \ -D "Our Agent" sysLocation.0 -D "1st Floor"

would send an enterprise-specific trap, myTrap and include the trailing variable information. Note: myTrap must be a name form of an OID.  

FILES


 /etc/srconf/agt/acl.pty
 /etc/srconf/agt/agt.pty
 /etc/srconf/agt/context.pty
 /etc/srconf/agt/view.pty
 /etc/srconf/agt/mgr.cnf
 /etc/srconf/agt/snmpinfo.dat  

SEE ALSO

inform(SR_CMDMAN), traprcv(SR_CMDMAN), SNMP RFCs (RFC1155 RFC1157 RFC1212 RFC1213 RFC1215, RFCs 1441-1452)  

KNOWN BUGS

If using the command-line utilities trapsend(SR_CMDMAN) or inform(SR_CMDMAN) in either SNMPv2 mode or bilingual mode, the mgr.cnf and snmpinfo.dat files must be in the agent's configuration directory, and the environment variable SR_MGR_CONF_DIR for trapsend(SR_CMDMAN) and inform(SR_CMDMAN) must point to the agent's configuration directory. This is because the utilities trapsend(SR_CMDMAN) and inform(SR_CMDMAN) perform agent functions as well as being manager utilities.  

LIMITATIONS

Only works on UNIX machines.


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
Generic traps:
Enterprise-specific traps:
FILES
SEE ALSO
KNOWN BUGS
LIMITATIONS

This document was created by man2html, using the manual pages.
Time: 02:43:01 GMT, October 02, 2010