Using the NETTOOL Tools

NOTE: You can use abbreviations for the NETTOOL commands. The abbreviations must uniquely identify the command at the current menu.

CONFIGURATION SUMMARY

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the CONFIGURATION SUMMARY tool from the main menu by entering the CONFIG command. A new menu will appear.

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

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

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

NOTE: GFLAGS is a toggle key. It could be "SET" or "NOT SET" by typing "GF". If GFLAGS is "SET" then global and local filters will be the same. If GFLAGS is "NOT SET" then only the local filter will change and local will take priority over the global filter.

IPCINT

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the IPCINT tool from the main menu.

3. Enter a NetIPC intrinsic abbreviation. You will be prompted for any parameters required by the intrinsic.

4. To exit the tool, type ex at the prompt.

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.

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the LOOPINIT tool from the main menu.

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

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

5. You will be prompted for the number of frames to be sent. Enter the number desired.

NAME-ADDRESS MANAGER

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the NAME-ADDRESS MANAGER tool from the main menu by entering the NAMEADDR command. A new menu will appear.

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

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.

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

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

3. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

4. Select the formatting tool from the main menu by entering the NMDUMP command. The NMDUMP menu will appear.

5. Select the menu options that will allow you to specify the type of records to format (log or trace).

6. Select additional menu options as required to specify the exact information you want to format.

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

8. To exit NMDUMP at any time, enter // at any prompt.

NSTEST

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the NSTEST tool from the main menu.

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

4. When prompted, enter the name of the destination node to which you want to connect.

5. When prompted, enter a logon string for the destination node. Enter other values as required. The tool will test the Network Service you selected.

6. Test other services as required.

NSLOGON

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the NSLOGON tool from the main menu.

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

4. Respond to additional prompts as required.

5. NSLOGON will produce a list of node names along with an indication of whether or not the logon to each node was successful.

PING

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the PING tool from the main menu by entering the PING command. A new menu will appear.

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

1. Make sure the network transport and Network Services are running on all nodes that are to be a part of this test.

2. Run the NETTOOL utility by entering the program name:

   NETTOOL.NET.SYS

   The root menu will appear.

3. Enter QVALNS to run the Network Services validation in batch mode.

4. 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.)

5. QVALNS will stream a job that tests the network services. The program will display any errors encountered on the system console.

RESOURCE MONITOR

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the RESOURCE MONITOR tool from the main menu by entering the RESOURCE command. A new menu will appear.

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

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

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

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

4. 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)

5. To return to NETTOOL, type E.

STATUS

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the STATUS tool from the main menu by entering the STATUS command. A new menu will appear.

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

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the X25CHECK tool from the main menu.

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

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

5. To terminate the server, use [BREAK] and ABORT or ABORTJOB.

X25STAT

1. Run NETTOOL by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the X25STAT tool from the main menu.

3. 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.)

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

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

2. The remote user should select the XPPERF tool from the main menu.

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

4. Run NETTOOL on the local system by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

5. Select the XPPERF tool from the main menu.

6. Respond to the prompts as required, or press [RETURN] to accept defaults. For the local system, you must specify master as the mode.

7. XPPERF will write the measured data to a file named XPERFD in the local group.

XPVAL

1. Run NETTOOL on the local system by entering the program name at the MPE prompt:

   NETTOOL.NET.SYS

   The root menu will appear.

2. Select the XPVAL tool from the main menu.

3. XPVAL will prompt you for information it needs to run the validation. Respond as required.

4. Make sure XPVAL is running on the remote node as well and have the remote user enter information about the remote node.

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