NAME

snmpxrtmetric − SNMP application for route metric monitoring

SYNOPSIS

snmpxrtmetric agent configfile [options]

DESCRIPTION

snmpxrtmetric is a tool that displays route metrics in graphical form.  Data is displayed as bar graphs.  The agent queried route metrics, agent, and the configuration file, configfile, are specified on the command line.  snmpxrtmetric uses SNMP to query route metrics.  If the agent does not have a route metric for a particular network, the route metric is displayed as 16.  Also, if a value of 16 or greater is returned for the route metric of a network, the route metric is displayed as 16. 

agentThe gateway should be specified as an address in dot notation, such as 133.138.1.1, or as a hostname. 

configfile
This specifies a file containing data on the network that is to be the subject of route metrics query. Menu bar in the snmpxrtmetric window permits the user to change the operating conditions, display the online manual, etc.  The options available from the menu bar are as follows.  File

Control...
This item is used to pop up the control panel to change the polling interval or bell settings. The polling interval specifies the number of seconds which must elapse between the sending of SNMP requests to the agent. The default value for the polling interval is 60 seconds. Also, if bell is set to “on”, the bell sounds whenever the route metric value becomes 16.

Exit
Exits snmpxrtmetric. 

Help

Version...
Displays version information.

Manual...
Displays the online manual.

OPTIONS

In addition to the standard X Toolkit options, snmpxrtmetric also supports the following.  −interval seconds
−i seconds

The integer value seconds is used as the polling interval.  This value specifies the number of seconds which must elapse between the sending of SNMP requests to the agent by snmpxrtmetric.  The default value for the polling interval is 60 seconds. 

−community name
−c name

The community name used when snmpxrtmetric accesses the agent is specified using name.  The default community name is “public”. 

−bell on/off
−b on/off

Specifies whether or not a bell will sound whenever the route metric value becomes 16 or greater.  The default is “on”. 

−help

Displays a description of the options unique to snmpxrtmetric. 

RESOURCES

snmpxrtmetric supports all of the standard resource names and class names included in X Toolkit.  In addition, the following application resources may be used.  The default values are shown below. 

Snmpxrtmetric.interval: 60
Snmpxrtmetric.maxInterval: 600
Snmpxrtmetric.community: public
Snmpxrtmetric.bell: on

CONFIGURATION FILE

The snmpxrtmetric configuration file contains information on the networks which are queried for route metric information.  Each network should have an entry on a separate line in the format shown in the example below. 

sm-net        133.138.1.0

The different items are delimited by tabs or spaces. Lines beginning with the # character are interpreted as comments.  The maximum number of networks that can be defined in the configuration file is 255. 

BUGS

snmpxrtmetric displays route metric values equivalent to those obtained using RIP.  Consequently, the maximum route metric value is 16, which is considered unreachable.  There may be cases in which changes to the display may not be clear on monochrome displays.  The use of a color display is recommended. 

FILES

/etc/snmp.variables
/usr/sony/doc/SNMP
/usr/lib/X11/app-defaults/Snmpxrtmetric
/usr/lib/X11/ja_JP.SJIS/app-defaults/Snmpxrtmetric
/usr/lib/X11/ja_JP.EUC/app-defaults/Snmpxrtmetric

SEE ALSO

ripxrtmetric(1), snmprtmetric(1). 

REFERENCES

J.D. Case, J.R. Davin, M.S. Fedor, M.L. Schoffstall, Simple Network Management Protocol, Request for Comments 1157, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, K. McCloghrie, Structure of Management Information, Request for Comments 1155, Network Information Center, SRI International, Menlo Park, California, May, 1990.  K. McCloghrie, M.T. Rose, Management Information Base, Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, Editor Management Information Base: MIB-II, Request for Comments 1158, Network Information Center, SRI International, Menlo Park, California, May, 1990. 

NEWS-OSRelease 4.2.1R