 |
» |
|
|
|
The following sections describe each of the available tools
and provide information on their use. You can access additional
information from within NETTOOL
by asking for help on the tool from the main menu.  |  |  |  |  | NOTE: You can use abbreviations for the NETTOOL
commands. The abbreviations must uniquely identify the command at
the current menu. |  |  |  |  |
To Use CONFIGURATION SUMMARY |  |
The CONFIGURATION SUMMARY
tool provides options that let you display information from the
network configuration and network directory files. To use this tool,
perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the CONFIGURATION SUMMARY
tool from the main menu by entering the CONFIG
command. A new menu will appear. Select the menu item or items needed to display
the information you want to see. The available choices are described
as follows.
- SUMMARY
Select this command to generate a summary of the
configuration file, NMCONFIG.PUB.SYS.
Optionally, you can specify a different configuration file using
the syntax: SUMMARY confilename You can also specify a different file using the conffile
command. - NETDIR
Select this command to generate a summary of the
network directory file, NSDIR.NET.SYS. - COMPARE
Select this command to compare the contents of two
configuration files. You can specify the files to use in the command,
using the syntax: COMPARE altfile conffile If you do not specify an altfile,
the program will prompt you for one. If you do not specify a conffile,
the program will use NMCONFIG.PUB.SYS. You can limit the comparison to just a subset of records using
the subtree option. - filters
This option displays the current values of the global
filters, conffile,
altfile, and
subtree, as well
as the current settings of the global filters. - conffile
Use this option to select a configuration file for
the SUMMARY and
COMPARE options. - altfile
Use this option to select an alternate file for
the COMPARE option. - subtree
Allows you to specify a subset of records to be
compared by the COMPARE
option. For example, if you specify NETXPORT.NI.LAN1,
the program will check only those screens in the file whose name
starts with NETXPORT.NI.LAN1. To set this value back to the default (root), press [RETURN]
at the subtree
prompt.
To Use filters |  |
The filters tool displays global filter setup. Run NETTOOL by entering the
program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the filters tool from the main menu by entering
the filters command. Filter options will be displayed as follows: INFILE: default none OUTFILE: default none MESSAGES FLAG: default set DATA FLAG: default set MENUS FLAG: default set NODE NAME FILTER: default @ IP address: default @ GFLAGS default set
To Use IPCINT |  |
The IPCINT
tool provides a command interface to IPC. To use this tool, perform
the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the IPCINT
tool from the main menu. Enter a NetIPC intrinsic abbreviation. You will
be prompted for any parameters required by the intrinsic. To exit the tool, type ex
at the prompt.
IPCINT
creates a log file, IPCLOG,
to track its actions. To Use LOOPINIT |  |
The LOOPINIT
tool sends a series of packets to a specific remote node and monitors
the round-trip response time. It displays the minimum time, maximum
time, and the average time. To use this tool, perform the following
steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the LOOPINIT
tool from the main menu. You will be prompted for a remote node name. Enter
the name of the node that you want the test packets sent to. If
you wish, you may enter the local node name. You will be prompted to specify information on frame
text or for frame length, if you do not specify frame text. Enter
values as required. You will be prompted for the number of frames to
be sent. Enter the number desired.
LOOPINIT
will display the minimum, maximum, and average times, in milliseconds,
required for the frames to make the round trip. It will also allow
you to display a histogram which graphically represents the times.
If you choose not to display the histogram, simply enter an N
at the prompt. To Use NAME-ADDRESS MANAGER |  |
The NAME-ADDRESS MANAGER
tool provides options that let you display the local cache of node
names and addresses. This tool is useful in detecting duplicate
IP addresses and permits you to clear entries in the name cache
if necessary. To use this tool, perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the NAME-ADDRESS MANAGER
tool from the main menu by entering the NAMEADDR
command. A new menu will appear. Select the menu item or items needed to display
the information you want to see. The available choices are described
as follows.
- CACHE
Select this item to display or delete information
stored in the name and address cache. A new menu will appear presenting
you with the choices as described: - NAME
Select to display name cache entries as specified
by nodefilter.
If looking for duplicate IP addresses, set nodefilter
to @. (If the
filter is not set, it displays all names.) - DELNAME
Select to delete a name entry from cache. Syntax
is DELPATH nodename.
This is useful in case of a duplicate name in the name cache. - DELPATH
Select to delete a name entry from cache plus IP
address mapping. Syntax is DELPATH nodename. - LOCAL
Select to display local node name. - TOTALS
Select to display total number of names in cache
and total number of names in directory. - filters
Select to see current filter settings for this menu.
Also displays the global settings (INFILE,
OUTFILE, messages
flag, data flag, and menus flag). - nodefilter
Select to set the name filter (@,
#, and ?
wildcards are allowed). - ipfilter
Select to set the IP address filter. Enter a single
address or @
for all. Enter the IP address as four positive integers between
0 and 255 separated by periods or blanks (for example, 15.123.44.98).
- MAPPINGS
Select this item to obtain information about the
correspondence between IP addresses and link addresses or to delete
mappings from the table. A new menu will appear presenting you with
the choices as described: - MAPPING
Select to display all mappings between IP address
and link address for those entries selected by subnetfilter
and addrfilter. - DELMAPPING
Select to delete mapping information of IP address
to network address. Syntax is DELMAPPING ipaddress.
For example, DELMAPPING 15.13.128.1 - TOTALS
Select to display total number of mappings. - filters
Select to see current filter settings for this menu.
Also displays the global settings (INFILE,
OUTFILE, messages
flag, data flag, and menus flag) - subnetfilter
Select to set the subnet filter. Specify the name
used in the NETCONTROL
command. - addrfilter
Select to set the address filter. You will be prompted
for the address type. Enter IP,
ETHER802, X25,
or NONE as required. - sorting
Select to specify the sorting method for the output
of the MAPPING
option. You will be prompted for the sort type. Enter IP
or LINKADDR as
desired.
- ROUTING
Select this item to obtain information about the
gateways used to access different subnets. A new menu will appear
presenting you with the choices as described: - ROUTING
Select to display routing information as specified
by the networkfilter
and gatewayfilter
settings. - DELROUTING
Select to delete specified routing. - GATELIST
??????? - GATE UP
?????? - GATE DOWN
?????? - STATISTICS
?????? - TOTALS
Select to display total number of routings. - filters
Select to see current filter settings for this menu.
Also displays the global settings (INFILE,
OUTFILE, messages
flag, data flag, and menus flag). - networkfilter
Select to set the networkfilter.
Enter a single IP address or @
for all. Enter the IP address as four positive integers between
0 and 255 separated by periods (for example, 15.123.44.98). - gatewayfilter
Select to set the gatewayfilter.
Enter a single gateway IP address or @
for all. Enter the IP address as four positive integers between
0 and 255 separated by periods (for example, 15.123.44.98).
- PATH
Select to obtain information about the different
addresses or names used at different layers in order to access a
remote destination. You will be prompted to specify the type of
information you need. Enter NAME
or ADDRESS as
desired. - NAME
Select to display addresses at different levels.
- ADDRESS
Select IP address to get corresponding path information
for that IP address.
- filters
Select to see current global filter settings. Displays
the settings of INFILE, OUTFILE,
messages flag, data flag, and menus flag.
To Use NMDUMP |  |
NMDUMP
is one of the node management services (NMS) utilities. You use
this tool to decode and format log records or trace messages so
that they can be more easily read and analyzed.  |  |  |  |  | NOTE: You cannot use NMDUMP
to format X.25 log or trace files. For information on X.25 logging
and tracing, refer to Using the OpenView DTC Manager
for PC-based systems or to Configuring and Managing Host-Based
X.25 Links for host-based systems. |  |  |  |  |
Perform the following steps to format records from the current
log file. At the MPE prompt, enter the SHOWNMLOG
command to obtain the name of the current log file. Record this
name. You will need to enter the name of the file you want to format
when you run NMDUMP. At the MPE prompt, enter the SWITCHNMLOG
command to close the current log file and begin recording log and
trace information to a new log file. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the formatting tool from the main menu by
entering the NMDUMP command.
The NMDUMP menu
will appear. Select the menu options that will allow you to specify
the type of records to format (log or trace). Select additional menu options as required to specify
the exact information you want to format. When prompted for the name of a file to format,
enter the file name you recorded in step 1. You will also be prompted
to enter a name for the output file. The default output file is
$STDLIST. To exit NMDUMP
at any time, enter //
at any prompt.
See Using the Node Management Services (NMS) Utilities
for more information on the options available in NMDUMP. To Use NSTEST |  |
The NSTEST
tool allows you to test the Network Services interactively. To use
this tool, perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the NSTEST
tool from the main menu. When prompted, enter the name of the service you
want to test. You should always test VT first so that NSTEST
can set up a remote session. When prompted, enter the name of the destination
node to which you want to connect. When prompted, enter a logon string for the destination
node. Enter other values as required. The tool will test the Network
Service you selected. Test other services as required.
To Use NSLOGON |  |
The NSLOGON
tool allows you quickly verify that the network transport is operating
correctly. It uses the NetIPC intrinsics to establish a connection
to a well-known server on a remote node. Therefore, both the network
transport and the Network Services must be started on all nodes
before you use this tool. You can choose whether to contact all
nodes or selected nodes by responding to the NSLOGON
prompts. To use this tool, perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the NSLOGON
tool from the main menu. You will be prompted to specify whether or not you
want to logon to all nodes in the directory. Answer yes (or press
[RETURN]) to logon to all nodes, otherwise answer
no. Respond to additional prompts as required. NSLOGON
will produce a list of node names along with an indication of whether
or not the logon to each node was successful.
To Use PING |  |
The PING
tool allows you to test remote connections by sending messages to
one or more remote nodes and examining their response. To use this
tool, perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the PING
tool from the main menu by entering the PING
command. A new menu will appear. Select the menu item or items needed to perform
the PING requests
you want to perform. The available choices are described here.
- PING
This option sends ICMP echo requests to remote systems.
On receiving the ICMP echo replies, the program displays the number
of packets sent and received and the time that it took each packet
to complete the round trip. You can specify the destination by name or by IP address.
If you specify by name, you can choose a single node or a set of
nodes by using wildcards (@,
#, and ?).
If you specify by address, the ping will go to that specific address.
Enter the IP address as four positive integers between 0 and 255
separated by periods or blanks (for example, 15.123.44.98). - RANGEPING
Use to send ping messages to a range of IP addresses.
The syntax is RANGEPING lowerip higherip.
Enter the IP address as four positive integers between 0 and 255
separated by periods (for example, 15.123.44.98).
If you do not enter the boundary IP addresses the program will prompt
for them. - GATEPING
Use to send ping messages to each of the existing
gateways in the nodes routing table. - filters
Select to see current filter settings for this menu.
Also displays the global settings (INFILE,
OUTFILE, messages
flag, data flag, and menus flag). - number
Use to specify the number of packets the program
sends for each request. The range is from 1 to 1,000,000. The default
is 5. - size
Use to specify the size of the packets the program
sends for each request. The range is from 8 to 2,048 bytes. The
default is 64. - nodefilter
Use to select multiple nodes to be acted on by subsequent
PING requests
(@, #,
and ? wildcards
are allowed). - ipfilter
Use to select a remote IP address to be acted on
by subsequent PING
requests. Enter the IP address as four positive integers between
0 and 255 separated by periods or blanks (for example, 15.123.44.98).
Standalone PING
requires periods.
To Use QVALNS |  |
The QVALNS
tool allows you to test the Network Services in program mode. To
use this tool, perform the following steps. Make sure the network transport and Network Services are running
on all nodes that are to be a part of this test. Run the NETTOOL
utility by entering the program name: NETTOOL.NET.SYS The root menu will appear. Enter QVALNS
to run the Network Services validation in batch mode. When prompted, enter the name of the destination
node to which you want to connect. (This is the same as entering
the command RUN QVALNS.NET.SYS;INFO=nodename
outside of NETTOOL.) QVALNS
will stream a job that tests the network services. The program will
display any errors encountered on the system console.
To Use RESOURCE MONITOR |  |
The RESOURCE MONITOR
tool provides options that let you display resource usage according
to the current settings of the resource filters. To use this tool,
perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the RESOURCE MONITOR
tool from the main menu by entering the RESOURCE
command. A new menu will appear. Select the menu item or items needed to display
the resource information you want to see. The available choices
are described here.
- DISPLAY
Use to display resource usage for the resources
specified by the type
parameter. - CLEAR
Use to set the high-water mark values for a chosen
item to zero. - RESET
Use to reset all resource filter values to their
defaults. - filters
Select to see current filter settings for this menu.
Also displays the global settings (INFILE,
OUTFILE, messages
flag, data flag, and menus flag). - detail
Use to toggle between detailed (verbose) and one-line
(non-verbose) modes. Verbose mode displays information about a particular
item detailing interpretation of resource usage and pointing to
possible relationships with configurable parameters. Non-verbose
mode displays current, maximum experienced (high-water mark), and
maximum allowable usage for the resources specified. Default is
non-verbose. - item
Use to select a particular item from the one-line
display so that you can obtain detailed information on that item. - refresh
Use to set the number of times the program will
display resource usage before returning control to you. Default
is one cycle. ([CONTROL]-Y will also return control.) - type
Use to select which resource types the program will
display in the one-line (non-verbose) mode. Default is to display
all resource types. - used
Use to suppress display of entries that are currently
unused. Default is to display resources regardless of usage. - delay
Use to select the interval (in seconds) between
displays of resource usage. Use this option in conjunction with
refresh in order
to monitor the activity of resource usage. Default is a delay of
1 second.
To Use SOCKINFO |  |
The SOCKINFO
tool displays sockets information. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the SOCKINFO
tool from the main menu by entering the following SOCKINFO
syntax: SOCKINFO [filter][,pin] - filter
program name in the form: file.group.account;
or user name in the form: user.account. - pin
display for the specified PIN instead of starting
out in Global Display.
If filters are not used, SOCKINFO
will print a Global Display like the following: GLOBAL DISPLAY Host=sampsys Gsxds=$a.d5690000 10:30 am |
Pin User Program Job Pri Skts |
------------------------------------------------------------------------- |
59 (system process) snmp.net.sys cq152 2 |
61 (system process) sockreg.net.sys lq149 1 |
63 (system process) dsdad.net.sys lq149 14 |
69 joe.mpe vtserver.net.sys s538 lq100 1 |
70 bob.mpeix vtserver.net.sys s546 lq100 1 |
79 spool,unispool.sys system3.unispool.sys j138 de208 2 |
80 spool,unispool.sys system6.unispool.sys j138 de202 0 |
81 spool,unispool.sys system6.unispool.sys j138 de202 1 |
82 spool,unispool.sys system3.unispool.sys j138 de206 0 |
: etc... 447 veruser.nmpascal vtserver.net.sys s570 lq152 1 |
--------------------------------------------------------------------------- |
Totals: 153 processes, including 1 locked semaphore; 177 sockets. |
Select the options needed to display the information
you want to see by typing one of the single characters as shown
here: - ?
Print help text. - :
Enter MPE command mode. - A
For an interpreted and raw dump of a socket data
structure. (PM capability required, must be in Process Display mode) - C
List all open call sockets and datagram sockets. - D
Call HPDEBUG. (PM capability required) - E
Exit this program. - F
Define Global Display filters. - G
Enter Global Display mode. - H
Print a history of processes displayed. - I
List configured IP addresses. - L
Display locked LSI semaphore entries. (PM capability
required) - M
Toggle display of internet address/host name in
Socket Display. - O
Toggle display of object addresses, enter Global
Display. - P
Enter Process Display mode. - Q
Enable/disable semaphore queuing. (Default is to
not queue) - R
Enter Destination Display mode. (Must be in Process
mode) - S
For an interpreted dump of a socket data structure.
(Must be in Process Display mode) - T
Enable/disable tracing. - V
Print the SOCKINFO
version number. - Y
Define new timeout value, in seconds. (Default is
0 : disabled)
To return to NETTOOL,
type E.
To Use STATUS |  |
The STATUS
tool provides options that let you display the status of the network
interfaces and their associated links. To use this tool, perform
the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the STATUS
tool from the main menu by entering the STATUS
command. A new menu will appear. Select the menu item or items needed to display
the information you want to see. The available choices are described
here.
- NODE
Select to display the local node name, the domain
name if one is configured, the CPU type, the MPE version, the transport
version, and the transport start time. The display information is
from the configuration file (not the name cache displayed when you
use the NAME-ADDRESS
tool). - INTERFACES
Use to obtain a list of all the network interfaces
and the links configured for those NIs. (You can obtain additional
information about the links using the LINKCONTROL
command or the X25STAT
tool. You can obtain additional information about NIs using the
NETCONTROL command.) - TCPSTAT
Use to display TCP global statistics and connection
table information. Available commands for the TCPSTAT
menu are TCPGLOBAL, CONNTABLE,
and CONNINFORMATION.  |  |  |  |  | NOTE: CONNINFORMATION—function
not available at this time. |  |  |  |  |
- IPSTAT
Use to display IP statistics for the network specified
by niname. If
you have not set niname,
you will see statistics for all NIs. - LKSTAT
Use to display statistics for the link whose name
has been set by lkname.
If you have not set lkname
you will see statistics for all links. (The statistics shown will
be the same as those displayed by the LINKCONTROL
command.) - PROBESTAT
Use to display probe statistics for inbound and
outbound packets for the network specified by niname.
If you have not set niname,
you will see statistics for all NIs. - ARPSTAT
Use to display ARP statistics for the network specified
by the niname command. If you
have not set niname,
you will see statistics for all NIs. - UDPSTAT
Use to display global UDP statistics or to report
UDP sockets statistics information for the network specified by
niname. If you
have not set niname,
you will see statistics for all NIs. - filters
Select to see current filter settings for this menu.
Also displays the global settings (INFILE,
OUTFILE, messages
flag, data flag, and menus flag) - niname
Use to set the name of the network interface for
the ARPSTAT, IPSTAT,
PROBESTAT, TCPSTAT,
and UDPSTAT commands to act
upon. The default is @ (display
statistics for all NIs). - lkname
Use to set the name of the link for the LKSTAT
command to act upon. - detail
Use this toggle to specify the level of detail that
the program will display. If this filter is set, the program will
display full statistics for the link. If it is not set, the program
will display only summary statistics. - refresh
Use to set the number of times the program will
display statistics before returning control to you. Default is one
cycle. ([CONTROL]-Y will also return control.) - delay
Use to set the number of seconds which will be inserted
as a delay after each statistics display. If the refresh
filter is set to a value of 1, the delay
filter has no effect. If you enter the delay
command and press [RETURN], the default value
of 1 second is set. Note that the delay time is in addition to any processing
time for the program. That is, setting a delay of 1 does not guarantee
that the statistics measurements will occur at one second intervals.
You should view this parameter as a means of causing successive
measurements to be space by at least the delay
time. - recent
Use this filter to select whether the displayed
statistics will be adjusted to show only the data which occurred
recently. If the flag is not set (the default), the program will
display all statistics totals.
To Use X25CHECK |  |
The X25CHECK
tool creates connections to remote X.25 nodes and verifies their
response. It also provides information that allows estimation of
the performance of the network and its load. The remote node runs
a background program, X25SERVR,
that responds to X25CHECK.
To use this tool, perform the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the X25CHECK
tool from the main menu. You will be prompted for a remote node name and
network name. Enter the name of the node and network that you want
the test packets sent to. If you wish, you may enter the local node
name. X25CHECK
will set up a VC to the remote node and send ten messages. The remote
node will echo the messages back. At the end of the test, the program
clears the connection but keeps the server running so that you can
set up a connection to if different node if you desire. To terminate the server, use [BREAK] and
ABORT or ABORTJOB.
To Use X25STAT |  |
The X25STAT
tool monitors the status and statistics for X.25 network interfaces
It displays internal data structures. To use this tool, perform
the following steps. Run NETTOOL
by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the X25STAT
tool from the main menu. You will be prompted to enter either a table specification
or a counter specification; both cannot be entered on the same command
line. (If an NI name is not entered on the command line, X25STAT
will display only the started X.25 NI.) The program will display the contents of the internal
X.25 tables. The information prints only once. To get new, updated
information, you will need to run X25STAT
again.
To Use XPPERF |  |
The XPPERF
tool measures the performance of the TCP/IP protocol stack, the
UDP/IP stack, or X.25 level 3 direct access. The program interfaces
to the transport through the IPC intrinsics. You must run XPPERF
on both the local system and a remote system for the test to work,
with the program on the remote system started first. To use this
tool, perform the following steps. Have someone at the remote location run NETTOOL
on the remote system by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. The remote user should select the XPPERF
tool from the main menu. The remote user will be prompted for the protocol,
the mode (master/slave), and other test values. The user must specify
slave as the
mode. The remote user should set other values as agreed upon. Run NETTOOL
on the local system by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the XPPERF
tool from the main menu. Respond to the prompts as required (or press [RETURN]
to accept defaults). For the local system, you must specify master
as the mode. XPPERF
will write the measured data to a file named XPERFD
in the local group.
To Use XPVAL |  |
The XPVAL
tool provides a quick validation of the transport by setting up
a connection between two nodes. You must run XPVAL
on both the local system and a remote system for the test to work,
with the program on the local system started first. To use this
tool, perform the following steps. Run NETTOOL
on the local system by entering the program name at the MPE prompt: NETTOOL.NET.SYS The root menu will appear. Select the XPVAL
tool from the main menu. XPVAL
will prompt you for information it needs to run the validation.
Respond as required. Make sure XPVAL
is running on the remote node as well and have the remote user enter
information about the remote node. XPVAL
will run a one minute connection test to verify the operation of
the transport and report any errors it encounters. See Chapter 2 “Operating Your Network ” for
a list of XPVAL
line test error messages.
|