 |
» |
|
|
|
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. | | | | |
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.
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 none - DATA FLAG:
default none - MENUS FLAG:
default none - NODE NAME FILTER:
default none - IP address:
default none - GFLAGS
default none
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. 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. 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
List all started DCNs, (gateways). - GATE UP
A specific gateway (Active). - GATE DOWN
A specific gateway (Not Active). - STATISTICS
Display the statistics; IP Route statistics, IP
update routing table etc. - 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.
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. 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.
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.
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.
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.
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. Selecting [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.
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.
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.
Selecting [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.
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.
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.
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.
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.
|
Printable version
