XMON2CFG(1) — NEWS-OS Programmer’s Manual

NAME

xmon2cfg − graphical configuration application for snmpxmon2(1)

SYNOPSIS

xmon2cfg [configfile] [options]

DESCRIPTION

xmon2cfg is a configuration application based on X Windows Version 11 to ease the sometimes monumental task of creating and/or editing configuration files for the snmpxmon2(1) application. If invoked with a configuration file configfile on the command line, xmon2cfg will bring up a representation of the network topology defined in configfile and allow the user to edit that topology. Invoked without a configuration file, xmon2cfg will prompt the user for the name and type of the first network to be edited, and then display a blank window where the user may define the topology of the network. xmon2cfg uses Button1 of the pointing device for selection and placement, Button2 for moving within the application window, and Button3 for resizing within the application window. Please note that for the purposes of placing/moving/resizing the application window itself, the user’s normal button conventions (as defined in .Xdefaults) apply.

COMMAND LINE OPTIONS

-displayspecifies the display to be used by xmon2cfg for its application window. The default is the local display.

-font

-fnspecifies the font to be used in xmon2cfg. The default is an snmpxmon2(1) compile time constant.

-geometryspecifies the geometry (size and location) of the xmon2cfg application window. Note that if the size of the window is less than the minimum size needed by xmon2cfg, the application will ignore the size specified. The default is the minimum sized window needed by the application.

-borderwidth

-bwspecifies the width to be used for the border around the xmon2cfg application window. The default is an snmpxmon2(1) compile time constant.

-name

-titlespecifies the name under which the xmon2cfg application is to be run. The default is xmon2cfg.

-rv

-reversespecifies that xmon2cfg is to be run in reverse video.

-nocolorspecifies that the xmon2cfg is to be run in monochrome mode, even on a color display. On a monochrome display, this option has no effect. By default, xmon2cfg will run in color on a color display.

-bg

-background
specifies the color of the background in xmon2cfg. The default is an snmpxmon2(1) compile constant. On a monochrome display, this option has no effect.

-fg

-foreground
specifies the color of the foreground in xmon2cfg. The default is an snmpxmon2(1) compile constant. On a monochrome display, this option has no effect.

-bd

-borderspecifies the color of the window border in xmon2cfg. The default is an snmpxmon2(1) compile constant. On a monochrome display, this option has no effect.

Using X Resources

Xmon2cfg reads the command line arguments, then passes through the users $HOME/.Xdefaults file and creates a local resource database. Any command line option will take precedence over the .Xdefaults parameter. Here are a list of all settable xmon2cfg parameters in .Xdefaults format, the values given are the default values if nothing is specified:

xmon2cfg.display:1:0.0
xmon2cfg.font:6x10
xmon2cfg.geometry:NULL (as big as font dictates)
xmon2cfg.borderwidth:2
xmon2cfg.name:xmon2cfg
xmon2cfg.reverseVideo:off
xmon2cfg.color:on
xmon2cfg.background:NavyBlue
xmon2cfg.foreground:white
xmon2cfg.bordercolor:red

MENUS

xmon2cfg has three menus that allow various application wide manipulations. the Application Menu provides the user to perform operations pertaining to the application itself. It has the following selections available:

Quitcauses xmon2cfg to quit.

Savesaves the current configuration as reflected internally in xmon2cfg to the same file as xmon2cfg was invoked with. The existing contents of the configuration file are overwritten. This selection has the same effect as Save As below if xmon2cfg was invoked without a configuration file.

Save Assaves the current configuration as reflected internally in xmon2cfg to a named file. The user is prompted for the name of the file. Note that the contents of the file named will be overwritten if the file already exists and is nonempty.

Readreads the contents of the named file into the application. It is assumed that the file named is an snmpxmon2(1) configuration file. The user is prompted for the name of the file to be read. The Configuration Menu provides the user with the ability to set application-wide configuration options. It has the following selections available:

Intervalallows the specification of the snmpxmon2(1) polling interval.

Min Pollallows the specification of the snmpxmon2(1) minimum polling interval.

Max SNMP Poll
allows the specification of the maximum number of SNMP polls to be sent out on retries.

Logallows the specification of a log file and a log level for logging purposes.

Trap Fileallows the specification of a location for logging SNMP traps received.

Route Fileallows the specification of a location for the snmpxrtmetric(1) configuration file.

Top Levelallows the specification of the top level network in the configuration. In the above menu selections, the user is prompted for input with dialog boxes. The Help menu exists to provide access to the xmon2cfg and snmpxmon2(1) manual pages. The Man Xmon2 selection provides access to the snmpxmon2(1) man page, while the Man Appl. selection provides access to the xmon2cfg man page.

EDITING SNMPXMON2 CONFIGURATIONS

Facilities exist within xmon2cfg to create, delete and move individual network entities and links within the current network (the network currently being displayed in the application window). It is also possible to move and resize the representations of rings and lans within a network of type LAN or RING. An instruction bar exists at the bottom of the application window to assist in the editing process by informing the user what the application expects next. Primitive entities (intermediate systems, end systems) are created by the user by selecting on the “PRIMENT” (“ISENT”, “ESENT”) button box. The user is prompted for all the information needed to create a new entity, with the process culminating in the user placing the newly created entity within the application window. Serial links within WANs are created when the user selects on the “SLINK” button box. The user will be prompted to identify the two entities that are the endpoints of the link, and the interfaces on the two entity endpoints. Interface specifications may be entered in any one of the three formats legal for the specification of entity interfaces in snmpxmon2(1): an ip address, an interface number preceded by a ’#’ (#interface-number), or as both an ip address and an interface number (#interface-number=ip-address). The “SLINK” button box will not work unless the current network is a WAN. A peer to the current network is created by selecting on the “PEER NET” button box. The user will be prompted for the name of the peer network, to place the peer network in the application window, to identify the entity that is the gateway to the peer network, and the interface on the gateway that is the link to the peer network. In the event that an already existing peer net to the current network is named by the user, the user will only be prompted to identify the new gateway to the peer network, and the interface on the new gateway (snmpxmon2(1) and xmon2cfg allow the specification of multiple gateways to a peer network). The interface may be specified in any of the three formats above. In the event that the current network is of type LAN (RING), the snmpxmon2(1) representation of a lan (ring) will be automatically displayed in the application window. This lan (ring) representation may be moved and resized as described below. If a new entity is created in a network of type LAN or RING, the interface on the new entity corresponding to the entity’s connection to the LAN (RING) will be automatically prompted for. The interface may be specified in any of the three formats above. An entity, peer network or network link in the current network can be deleted by selecting on the delete box, then selecting the item to be deleted. It is not possible to delete the link from an entity to the network (only of relevance if the network is of type LAN or RING). To move an entity or a peer net, select on the object to be moved with Button 2, then drag the pointing device to the desired new location with Button 2 depressed, then release Button 2. It is possible to move lans and rings in an analagous fashion. Lans and rings (in the appropriate typed networks) may be resized. Depress Button 3 and drag the pointing device to indicate the desired new size with Button 3 depressed, then release Button 3. In addition to the ability to specify the configuration of an entity during the creation process, it is possible to change any part of an entity configuration (except its name) by use of the Entity Menu, which will pop up when an existing entity is selected with Button 1. The following selections are available from the Entity Menu:

Show Configuration
Show current configuration of the entity.

Toggle Entity Type
Toggle the current type of the entity. A primitive entity or intermediate system is changed to an end system, while an end system is changed to an intermediate system.

Toggle ICMP
Toggle whether the entity is polled with ICMP only, or with SNMP as well. If the entity is currently being polled with both SNMP and ICMP, it will be changed to be polled with ICMP only. Conversely, if the entity is currently being polled with ICMP only, it will be changed to be polled with both SNMP and ICMP (SNMP community information will be prompted for).

Polling community
Specify a new polling community for the entity. This selection will only work if the entity is currently being polled with SNMP as well as ICMP.

Trap community
Specify a new trap community for the entity. This selection will only work if the entity is currently being polled with SNMP as well as ICMP.

Change IfChange the specification of an already existing interface on the entity. The old specification of the interface is entered, followed by the new, with the two separated by a ’/’. The new interface specification may be in any of the three interface specification formats used in snmpxmon2(1), as described above.

Museum