NAME

ntx_traps − configure the MVME339 SNMP TRAPs

SYNOPSIS

ntx_traps [ −d device ] [−f file ] | [ −h ] | [[ −p port ] [ −rs ] trap-type community host ]

DESCRIPTION

Ntx_traps configures the MVME339 SNMP traps, that is, which trap PDUs the SNMP agent sends to which NMS(s).  A trap is an unsolicited SNMP message that the agent transmits when certain events occur.  The MVME339 supports the standard SNMP generic traps as well as some enterprise-specific traps, which are specific to the MVME339 product line. 

If the host does not issue ntx_traps, the agent will not transmit trap PDUs. 

Note that is possible (and simple) for the host to configure for more than one NMS to receive the same trap-type. 

Community is the community name.  It is normally an ASCII string which serves to identify a set of NMSs which have access to the MVME339 SNMP agent.  The MVME339 SNMP agent uses community in the PDU when generating the specified trap to the specified NMS. 

Traptype is a decimal number or symbol which specifies the SNMP trap type, generic or specific.  If the −s flag is specified, trap-type is interpreted as a specific trap.  Otherwise it is a generic trap.  Valid values for trap types are integers or the corresponding symbolic names.  Valid generic trap types are: 0 (coldstart), 1 (warmstart), 2 (linkdown), 3 (linkup), 4 (authfail), and 5 (egploss).  The MVME339 SNMP agent does not generate warmstart, linkdown, linkup, or egploss traps. 

Specific traps identify the MVME339’s enterprise-specific traps.  Please refer to st.snmp.h for the current list of MVME339 enterprise-specific traps.  As of this writing, the following are defined: 0 (hostrej - connection attempt rejected by host computer), 1 (termrej - connection attempt rejected by terminal), 2 (neterr - an unrecoverable network error occured on the session). 

Host is the Internet address (or host name) of the NMS which is to receive the specified trap PDU. 

If none of the trap configuration parameters are given on the command line, ntx_traps retrieves the trap configuration from the MVME339 and displays it on the standard output.  The output is the same format as file (given below). 

OPTIONS

−dSet the MVME339 raw device file name.  This option will override the default MVME339 device name of /dev/xedt/mvme338_c0.  standard output. 

−f
Read the trap configuration from a file and send it to the MVME339.  If file is − read from the standard input.  The input file is a list of tuples, one per line.  The first item in a tuple is a UDP port number, the second a generic trap type.  If the second item is specific then the third item is a specific trap type.  The next item is a community name and the last item is an Internet address (or host name).  The items are separated by white space.  Characters to the right of ’#’ on input lines are ignored. 

−h
Get help on symbolic names for traps.

−s
Interpret trap-type as a specific trap (see above). 

−r
Disable the MVME339 SNMP agent from generating the specified trap to the specified NMS. 

−p
Port specifies the UDP port number which the specified NMS uses to receive the trap.  If this option is not specified it defaults to 162. 

EXAMPLES

Configure cold start traps to be sent to hosts 192.6.153.6 and 192.6.153.2. 

 ntx_traps 0 public 192.6.153.6
ntx_traps 0 public 192.6.153.2
 Configure authentication failure traps to be sent to host 192.6.153.6.
 ntx_traps authfail private 192.6.153.6
 Configure session network error traps to be sent to host 192.6.153.20.
 ntx_traps −s neterr public 192.6.153.20
 

FILES

/dev/xedt/mvme338_c∗

SEE ALSO

mvme338 (7), ntx_snmp (1)