NAME

snmpxconn − SNMP application for monitoring TCP connections

SYNOPSIS

snmpxconn configfile [options]

DESCRIPTION

snmpxconn is a tool for displaying in graphical form the number of TCP connections (in ESTABLISHED or CLOSE_WAIT state) between end systems (hosts, terminal servers, etc.)  and intermediate systems (routers, etc.).  Two types of TCP connections are displayed, direct and indirect (passing through monitored intermediate systems).  Direct connections are displayed (when the default settings are in effect) as solid orange lines between an intermediate system and an end system or between one end system and another end system.  Through (indirect) connections are represented by dotted red lines (when the default settings are in effect) between an intermediate system and an end system.  When the default settings are used, double clicking on a network entity (end system or intermediate system) with Button1 (normally the left mouse button) pops up a new window displaying information about the selected network entity.  If the network entity is an end system, the information displayed includes agent, address, community, number of input packets, number of output packets and number of TCP connections.  If the network entity is an intermediate system, the agent, address, community and number of TCP connections is displayed.  The arrangement of the display can be altered by dragging network entities using mouse Button1.  And if more than one network entity is selected they can all be moved at once.  To do this, select the network entities to be moved by clicking on them while holding down the shift key, then drag then with Button1 while keeping the shift key held down. 

configfile
This specifies a configuration file containing data on the network entities to be monitored. Menu bar in the snmpxconn 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 setting. 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.

Save
Saves the currently open configuration file. Note that the current arrangement of network entities is reflected in the file when it is saved.

Save As...
Saves the currently open configuration file under a new name. Note that the current arrangement of network entities is reflected in the file when it is saved. Also, the currently open configuration file changes to the file saved under the new name.

Exit
Exits snmpxconn. 

Help

Legend...
Displays the legends of the network entity and connection display.

Version...
Displays version information.

Manual...
Displays the online manual.

OPTIONS

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

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

−help

Displays a description of the options unique to snmpxconn. 

RESOURCES

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

Snmpxconn.interval: 60
Snmpxconn.maxInterval: 600
Snmpxconn.isesLinkColor: Red
Snmpxconn.isesLinkStyle: on
Snmpxconn.esesLinkColor: Orange
Snmpxconn.esesLinkStyle: off
Snmpxconn.linkWidth: 4
Snmpxconn.noIcon: False

CONFIGURATION FILE

The snmpxconn configuration file lists the following information. 

(1) ES name address community xcoord ycoord
The end system name of the IP address (address) and community name (community) are monitored.  This end system is displayed within the window at the position specified by (xcoord, ycoord).  Example: ES sm1 133.138.1.2 public 320 160

(2) IS name address community xcoord ycoord
The intermediate system name of the IP address (address) and community name (community) are monitored.  This intermediate system is displayed within the window at the position specified by (xcoord, ycoord).  Example: IS sm-gw 133.138.1.1 public 120 200

(3) LABEL label
The character string label is displayed in the window as a title for the item being monitored.  Example: LABEL SuperMicro-Network The different items are delimited by tabs or spaces.  Lines beginning with the # character are interpreted as comments. 

BUGS

snmpxconn has a very simplistic view of Internet routing.  As a result, there may be cases where TCP connections are displayed incorrectly if the routing is extremely complicated.  For example, in cases where incoming traffic is passing through a intermediate system to a monitored end system, and outgoing traffic is passing through another intermediate system, the TCP connection will be shown as only passing through the second intermediate system.  snmpxconn will only indicate a path from a monitored end system through a monitored intermediate system if the intermediate system is the next hop in the route from the end system to the other end of the TCP connection.  Therefore, the use of snmpxconn is recommended only for end systems and intermediate systems on the same LAN.  There may be cases in which changes to the display may not be clear on monochrome display. The use of a color display is recommended.

FILES

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

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