incmon(8) CLIX incmon(8)
NAME
incmon - Runs the Intergraph Network Core (INC) XNS monitor
SYNOPSIS
incmon [node|[lan.]addr] [/option] [/ti[meout]=seconds] [/po[rt]=n]
[/re[peat]=n]
incmon [/no[dename]=node] [/option] [/ti[meout]=seconds] [/po[rt]=n]
[/re[peat]=n]
incmon [/ne[twork]=lan] /ad[dress]=addr] [/option] [/ti[meout]=seconds]
[/po[rt]=n] [/re[peat]=n]
FLAGS
/ti[meout]=seconds
Sets the request timeout in seconds. The timeout value has a
maximum limit of 1200 seconds (20 minutes). The minimum timeout is
one second and the default timeout is 20 seconds.
/po[rt]=n
Sets the port to be shown in General Statistics. For remote routers
The n parameter is x or t for the transceiver port, and 0-7 for one
of the other ports. For nodes with two Ethernet ports, the n
parameter is 0 or 1. By default, the General Statistics for a node
is for the port on which the router received the network request
for statistics.
/re[peat]=n
Sets the number of times (n) the display is written to the
redirected output file. This option is only valid with /ge[neral]
or /lo[opback] options on the command line when stdout is
redirected to a file. By default only the first occurrence of
these continuously updating displays are redirected to stdout.
/ne[twork]=lan
Specifies the network the machine to be monitored is on. The lan
parameter is specified in Ethernet format (xxxxx where x is a
hexadecimal number).
/no[dename]=node
Specifies the nodename of the machine to be monitored.
/ad[dress]=addr
Specifies the address of the machine to be monitored. The addr
parameter is specified in Ethernet format (xx-xx-xx-xx-xx-xx where
x is a hexadecimal number).
option Displays the specified incmon display. Valid choices for the
2/94 - Intergraph Corporation 1
incmon(8) CLIX incmon(8)
option parameter include the following:
/ge[neral] - General Statistics Display
This display provides statistics that tell how the specified
node is functioning on the network. Information displayed
includes error and status counters, software image name and
version, and the number of bytes and frames transmitted and
received and their effective rates. The information on this
display is updated continually.
/lo[opback] - Loopback Test Utility Display
This display allows the user to transmit and receive frames
through the XNS ECHO protocol. This display contains
options that control the test frame, change the frame buffer
size, alter the timeout and time delay between
transmissions, or perform a software checksum test on the
frame.
/se[arch] - Network Search Report Display
This display allows the user to view the contents of a
database on the network containing basic general information
on all nodes on the network.
/ro[uting] - Routing Information Display
This option shows information about the local network's XNS
routing topology. It shows the remote routers the specified
node can access and the LANs the node can access through the
remote routers. The menu also indicates the relative
distance between the specified node and a particular LAN and
can tell exactly what is connected to a particular remote
router's ports.
/to[pology] - XNS Network Topology Display
This display shows network topology using a tree structure
starting from the specified node's local LAN. The display
includes Remote Routers and LANs that can be reached from
the specified node.
DESCRIPTION
The incmon command, the Intergraph Network Core (INC) monitor, is a
network monitor utility that allows a machine's performance to be viewed
on a Xerox Network Systems (XNS) network. By viewing several machines on
the network, problems can be diagnosed and information relative to the
current network loading and performance can be accessed. The incmon
command is menu-driven and can be used only on VT52, VT100, VT200, VT220,
or VT300 compatible terminals.
If a node, an Ethernet address (addr), or a Local Area Network (LAN)
number (lan) and an Ethernet address is not specified, incmon defaults to
the local machine's network address. The network number, address, or
2 Intergraph Corporation - 2/94
incmon(8) CLIX incmon(8)
nodename can be changed from the incmon main menu.
EXAMPLES
1. To display the incmon main menu containing a list of several displays
that can be selected enter:
incmon
The default network timeout value of 20 seconds is used for the local
node.
2. To bypass the main menu and display General Statistics for the
Transceiver port of the remote router rout1_4 while specifying a
network timeout value of 8 seconds, enter:
incmon rout1_4 /ge /ti=8 /po=x
3. To write the General Statistics display for port 3 of the remote
router rout1_4 twice to the file rout1_4.data while specifying a
network timeout value of 30 seconds, enter:
incmon /no=rout1_4/ge/ti=30/po=3/re=2 >rout1_4.data
4. To bypass the main menu and display the Loopback Test Utility menu for
node 00013fea.08-00-36-6A-95-00, enter:
incmon /ne=13fea /lo /ad=08-00-36-6a-95-00
5. To bypass the main menu and display the Network Search Report for node
08-00-36-6A-95-00 on the local LAN, enter:
incmon /ad=08-00-36-6a-95-00 /se
6. To bypass the main menu and display the Routing Information Display
for node 00013fea.08-00-36-6A-95-00, enter:
incmon 13fea.8-0-36-6a-95-0 /ro
7. To bypass the main menu and display the XNS Network Topology starting
with the local node, enter:
incmon /to
8. To bypass the main menu and display General Statistics for port 1 for
2/94 - Intergraph Corporation 3
incmon(8) CLIX incmon(8)
node big6545, enter:
incmon /no=big6545 /po=1/ge
NOTES
An XNS socket is a physical Ethernet port and not a socket() function.
EXIT VALUES
The incmon command always exits with a value of 1.
RELATED INFORMATION
Commands: incmond(8)
4 Intergraph Corporation - 2/94