HP 3000 Manuals HP 3000 Manuals
Using the NETTOOL Tools The sections below 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 follow the steps below. 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 below. 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. 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 set DATA FLAG: default set MENUS FLAG: default set NODE NAME FILTER: default @ IP address: default @ GFLAGS default set
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.
To Use IPCINT The IPCINT tool provides a command interface to IPC. To use this tool follow the steps below. 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. 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 follow the steps below. 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. 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 follow the steps below. 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 below. 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 described below: 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 described below: 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 described below: ROUTING Select to display routing information as specified by the networkfilter and gatewayfilter settings. DELROUTING Select to delete specified routing. 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.
Follow the steps below to format records from the current log file. 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. 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 follow the steps below. 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. 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 follow the steps below. 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. 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 follow the steps below. 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 below. 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 follow the steps below. 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. 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 follow the steps below. 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 below. 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. 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 below: ? 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. 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 follow the steps below. 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 below. 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 follow the steps below. 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. 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 follow the steps below. 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. 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 follow the steps below. 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. 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 follow the steps below. 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 for a list of XPVAL line test error messages.