NAME

xmon2cfg − snmpxmon2 configuration file editing tool

SYNOPSIS

xmon2cfg [ configfile ] [options]

DESCRIPTION

xmon2cfg is a tool for creating and editing configuration files for snmpxmon2.  An existing configuration file can be edited by specifying it on the command line as configfile.  If the configfile specification does not already exist, or if no specification is made, a new configuration file is created. 

configfile
Specifies the snmpxmon2 configuration file.  Menu bar in the xmon2cfg window permits the user to create and delete primitive entities or display the online manual.  The options available from the menu bar are as listed below.  Information on actually creating configuration files appears later.  File

Control...
This item is used to pop up the control panel to change the polling interval, minimum polling interval, maximum number of retries, log file name, log level, trap log file name, snmpxrtmetric and ripxrtmetric configuration files, toplevel network, bell and status display settings.  All of these settings are reflected in the snmpxmon2configuration file that is created. 

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. Also, the currently open configuration file changes to the file saved under the new name.

Close(X)
Closes the window. Note that the toplevel network window cannot be closed from the menu bar.

Exit
Exits xmon2cfg

Object

Create Primitive...
Creates a primitive entity.

Create Network...
Creates a network.

Primitive list...(L)
Displays a list of primitive entities.

Network list...(K)
Displays a list of networks.

Information...
Displays information on the selected networks and primitive entities.

Delete
Deletes the selected networks and primitive entities. Note that it is not possible to delete items from the “Primitive list” or “Network list”.

Link

Connect...
Connects a pair of selected primitive entities or networks.

Disconnect...
Disconnects a pair of selected primitive entities or networks.

Setting

Grid...
Specifies a grid.

Help

Legend...
Displays an explanation of the primitive entities and networks.

Version...
Displays version information.

Manual...
Displays the online manual.

OPTIONS

In addition to the standard X Toolkit options, xmon2cfg also supports the following.  −noPrimIcon

Specifies that primitive entities should be represented as labels only, with no bitmap displayed. 

−noPeerIcon

Specifies that networks should be represented as labels only, with no bitmap displayed. 

−bell on/off
−b on/off

Specifies whether or not a bell should sound when an invalid operation is performed while editing a configuration file.  The bell default setting is “on”. 

−linkColor color

Specifies the color of lines representing serial links.  The default is “Yellow”. 

−lanColor color

Specifies the color of lines representing local area networks.  The default is “Orange”. 

−ringColor color

Specifies the color of lines representing ring type local area networks.  The default is “SkyBlue”. 

−linkLineWidth width

Specifies the thickness of of lines representing serial links.  The default is 2. 

−lanLineWidth width

Specifies the thickness of of lines representing local area networks.  The default is 3. 

−ringLineWidth width

Specifies the thickness of of lines representing ring type local area networks.  The default is 1. 

−help

Displays a description of the options unique to xmon2cfg. 

RESOURCES

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

Snmpxmon2.interval: 60
Snmpxmon2.maxInterval: 600
Snmpxmon2.minpoll: 5
Snmpxmon2.maxsnmppoll: 3
Snmpxmon2.maxMaxsnmppoll: 10
Snmpxmon2.bell: on
Snmpxmon2.upColor: Green
Snmpxmon2.downColor: Red
Snmpxmon2.unknownColor: Yellow
Snmpxmon2.icmpColor: Gray
Snmpxmon2.linkColor: Yellow
Snmpxmon2.lanColor: Orange
Snmpxmon2.ringColor: SkyBlue
Snmpxmon2.peerIcon: on
Snmpxmon2.primIcon: on
Snmpxmon2.doGrid: False
Snmpxmon2.showGrid: False
Snmpxmon2.gridSpacing: 10
Snmpxmon2.gridColor: White
Snmpxmon2.linkLineWidth: 2
Snmpxmon2.lanLineWidth: 3
Snmpxmon2.ringLineWidth: 1

CONFIGURATION FILE EDITING

In the default configuration, xmon2cfg allows users to select and move primitive entities and networks using Button1 (normally the left mouse button).  Primitive entities and networks are selected by clicking on them and are moved by dragging them.  Multiple primitive entities and networks are selected by clicking while holding down a shift key.  The xmon2cfg window appears different depending on the type of network being displayed.  In the default configuration, “LAN” type networks are represented using straight “Orange” lines and “RING” type networks with “SkyBlue” circles.  The positions and sizes of these straight lines and circles can be changed.  For example, the position of straight line representations can be moved by dragging the center of the line to the desired location.  It is also possible to change the length and direction of straight lines by dragging their ends.  The position of a circle be moved by dragging the center to the desired location, and the size changed by dragging the border. 

(1) Creating primitive entities
Selecting “Create Primitive...” from the “Object” menu pops up a window for creating primitive entities. To create a new primitive entity, input a primitive name. Also, if it is possible to create an already defined primitive entity on a network being edited, the primitive entity to be created may be selected from a list of hosts in this window. When a new primitive entity is to be created, a window pops up for making the necessary settings. Refer to (3) below for information on these settings.

(2) Creating networks
Selecting “Create Network...” from the “Object” menu pops up a window for creating networks. To create a new network, input a network name. Also, if it is possible to create an already defined network on a network being edited, the network to be created may be selected from a list of networks in this window. When a new network is to be created, a window pops up for making the necessary settings. Refer to (4) below for information on these settings.

(3) Primitive entity settings
Once an already defined primitive entity has been selected, selecting “Information...” from the “Object” menu pops up a window for making primitive entity settings. This window also pops up if a new primitive entity is being created or if the user double clicks on a primitive entity. This window is used to set the primitive entity name, type, interface, connection interface, management protocol, community name and trap community name. For type, select either “End system” or “Intermediate system”. Top add or delete an interface, click on either the “New” or “Delete” button in the window, as appropriate. Clicking on the “New” button pops up a window for entering information on the interface. An interface may be specified by inputting either its IP address or interface number. (To input an interface number, enter the character # followed by the number.  For example, “#1” indicates interface 1.)  An interface can be deleted by clicking the “Delete” button.  This causes a window containing a list of the available interfaces to appear, from which the interface to be deleted can be selected.  The connection interface is the interface linking the primitive entity to a “LAN” or “RING”. Select the connection interface from the window containing a list of the available interfaces and click the “Connect” button. Select either “SNMP” or “ICMP” as the management protocol.

Limitations
Names may not contain any space characters and they may not begin with the character #. 
“icmponly” may not be used as the community name.

(4) Network settings 1
Once an already defined network has been selected, selecting “Information...” from the “Object” menu pops up a window for making network settings. This window also pops up if a new network is being created or if the user double clicks on a network. This window is used to set the network name and type. Select “WAN”, “LAN” or “RING” as the network type. The information in the window which appears differs depending on the type selected.

Limitations
Names may not contain any space characters and they may not begin with the character #. 

(5) Network settings 2
Clicking on the network name displayed under the menu bar pops up a new window for setting the network name and type for the network currently being edited. Select “WAN”, “LAN” or “RING” as the network type. The information in the window which appears differs depending on the type selected.

Limitations
Names may not contain any space characters and they may not begin with the character #. 

(6) Deleting primitive entities and networks
Primitive entities and networks can be deleted by selecting “Delete” from the “Object” menu. It is necessary to select the primitive entity or network to be deleted before choosing this item. This delete function only removes the selected primitive entity or network from the network currently being edited. It has no effect on other networks. See (7) and (8) below for instructions for removing a primitive entity or network from all networks.

(7) Listing primitive entities
Selecting “Primitive list...(L)” from the “Object” menu pops up a window containing a listing of primitive entities. Primitive entities can be searched and deleted from this window. To do either of these things, first select the select the primitive entity to be searched or deleted from the list. This delete function removes the selected primitive entity from all the networks being edited.

(8) Listing networks
Selecting “Network list...(K)” from the “Object” menu pops up a window containing a listing of networks. Networks can be moved and deleted from this window. To do either of these things, first select the select the network to be moved or deleted from the list. This delete function removes the selected network from all the networks being edited.

(9) Connecting networks and primitive entities
Selecting the network and primitive entity to be connected and then selecting “Connect...” from the “Link” menu pops up a window for making connections. Simply select the interface to be used to connect the primitive entity to the network and click the “OK” button.

(10) Connecting primitive entities
Selecting the two primitive entities to be connected and then selecting “Connect...” from the “Link” menu pops up a window for making connections. Simply select the interfaces to be used to connect the primitive entities and click the “OK” button.

(11) Breaking connections
Selecting the two networks or primitive entities to be disconnected and then selecting “Disconnect...” from the “Link” menu pops up a window for breaking connections. Simply select the interfaces to be disconnected and click the “OK” button.

(12) Operation settings
Selecting “Control...” from the “File” menu pops up a window for making operation settings for snmpxmon2.  This window is used to set or change the polling interval, minimum polling interval, maximum polling interval, log file name, log level, trap log file name, snmpxrtmetric configuration file, toplevel network, bell and status display.  If no log file name or trap log file name is specified, the log in question will not be made. The toplevel network is the network that is first displayed when snmpxmon2 is started. 

BUGS

If the network type is “LAN” or “RING” and “Disconnect...” is selected from the “Link” menu, it is not possible to break connections between networks displayed as straight lines or circles and primitive entities.  To get around this problem, delete the primitive entity using “Delete” from the “Object” menu and then create it by selecting “Create Primitive...” from the “Object” menu.  The xmon2cfg interface settings are rather tedious, and they allow conflicting IP addresses to be assigned to primitive entities with different names even within the same network.  Since each network is edited in a separate window, there may be cases where the relationships between networks become unclear.  There may be cases in which changes to the display may not be clear on monochrome dislays.  The use of a color display is recommended. 

FILES

/usr/sony/doc/SNMP
/usr/lib/X11/app-defaults/Snmpxmon2
/usr/lib/X11/ja_JP.SJIS/app-defaults/Snmpxmon2
/usr/lib/X11/ja_JP.EUC/app-defaults/Snmpxmon2

SEE ALSO

snmpxmon2(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