How to Use PING/XL [ Installing and Managing HP ARPA File Transfer Protocol Network Manager's Guide ] MPE/iX 5.0 Documentation
Installing and Managing HP ARPA File Transfer Protocol Network Manager's Guide
How to Use PING/XL
To use PING/XL, you need the internet protocol (IP) address of the remote
node. If you do not wish to use the default values, you can optionally
specify the number of packets to send, and number of data bytes per
packet. The defaults are 64 bytes per packet, with an infinite number of
packets. Use CTRL-Y to stop sending packets.
You must have NA and NM capabilities to use PING/XL.
PING/XL can be run from a menu by entering:
:RUN PING.NET.SYS
or, from the command line using an INFO string in the form:
:RUN PING.NET.SYS;INFO=" ipaddress [, packets ][, bytes ]"
Examples of both the menu-driven and the command-line interface are
provided in the following sections.
NOTE If you have active PING/XL processes while bringing up or shutting
down the network, the processes will exit to the menu display and
IP address prompt after printing error messages. It is highly
recommended that you run PING/XL after bringing up the networks,
and have no active PING/XL processes when you shut the network
down.
Using Menu-Driven PING/XL
When you run PING/XL without parameters, the display shows the input
parameters available. For example, enter: :RUN PING.NET.SYS
The following menu is displayed:
-------- PING/XL (ICMP Echo Requestor)
: Version B0300003 --------
**************************************************************
| Information on Input Parameters: |
| |
|(CONTROL-Y at any point to exit to main level) |
| |
| IP address - In decimal form; (e.g) 15.13.131.55; |
| RETURN to quit program. |
| |
| # packets - Between 1 and 65544; RETURN for the |
| default of infinite packets, and |
| CONTROL-Y to stop sending. |
| |
| data bytes - Between 0 and 2048; should be 4 or |
| per packet more to get round trip times; RETURN |
| for the default of 64 bytes. |
**************************************************************
IP address [RETURN to quit program.] ?
Enter the IP Address.
This is a required parameter. Enter the IP address of the remote node in
decimal notation at the IP address prompt. For example:
IP address [RETURN to quit program.] ? 15.13.131.55
Enter the Number of Packets.
This is an optional parameter. Once a valid IP address has been entered,
you are prompted for the number of packets. For example, 20 packets has
been entered below:
# of packets [1 to 65534] ? 20
The number of packets entered must be between 1 and 65534. The default
is to send a continuous stream of packets which can be selected by
pressing the Return key at the prompt. If you use the default (a
continuous stream), you must enter CTRL-Y to stop sending packets.
Enter the Number of Bytes.
This is an optional parameter. Once a valid number has been entered for
the number of packets to be sent, you are prompted for the number of
bytes to be sent per packet. For example, 1000 has been selected below:
# of bytes of data [0 to 2048] ? 1000
The number of data bytes entered must be between 0 and 2048. The default
is to send 64 bytes of data with each packet, which can be selected by
pressing the Return key at the prompt.
If four or more bytes of data is sent, the round trip time for each
request-reply is displayed.
Stopping PING/XL.
From the menu displaying the IP address prompt, you can exit from PING/XL
by pressing the Return key. Note that you cannot use the Break key to
exit.
You can exit to the menu display by entering CTRL-Y at any point while
entering parameters. You can also enter CTRL-Y to stop sending packets.
If you choose to send a continuous stream of packets, you must use CTRL-Y
to stop sending packets.
PING/XL times out after two minutes if it does not get any response to
its requests. This can occur if there is a problem with the local node
or the remote node.
If you do not want to wait for the two minute limit to be reached, you
can enter CTRL-Y to exit to the menu display and IP address prompt, then
press the Return key to exit from PING/XL.
Sample Session.
The following example illustrates using menu-driven PING/XL.
:RUN PING.NET.SYS
-------- PING/XL (ICMP Echo Requestor) : Version B0300003 --------
******************************************************************
| Information on Input Parameters: |
| |
|(CONTROL-Y at any point to exit to main level) |
| |
| IP address - In decimal form; (e.g) 15.13.131.55; |
| RETURN to quit program. |
| |
| # packets - Between 1 and 65544; RETURN for the |
| default of infinite packets, and |
| CONTROL-Y to stop sending. |
| |
| data bytes - Between 0 and 2048; should be 4 or |
| per packet more to get round trip times; RETURN |
| for the default of 64 bytes. |
******************************************************************
IP address [RETURN to quit program.] ? 15.13.131.59
------------------------------------
Remote IP address in hex : $0F0D833B
------------------------------------
# of packets [1 to 65534] ? 10
# of bytes of data [0 to 2048] ? 10
---- PING $0F0D833B : 10 byte packet(s), 10 packet(s) ----
10 byte(s) from $0F0D833B : icmp_seq = 1, time = 23 ms
10 byte(s) from $0F0D833B : icmp_seq = 2, time = 35 ms
10 byte(s) from $0F0D833B : icmp_seq = 3, time = 26 ms
10 byte(s) from $0F0D833B : icmp_seq = 4, time = 22 ms
10 byte(s) from $0F0D833B : icmp_seq = 5, time = 23 ms
10 byte(s) from $0F0D833B : icmp_seq = 6, time = 22 ms
10 byte(s) from $0F0D833B : icmp_seq = 7, time = 24 ms
10 byte(s) from $0F0D833B : icmp_seq = 8, time = 24 ms
10 byte(s) from $0F0D833B : icmp_seq = 9, time = 23 ms
10 byte(s) from $0F0D833B : icmp_seq = 10, time = 23 ms
---- $0F0D833B PING Statistics ----
10 packet(s) transmitted, 10 packet(s) received, 0 % packet loss
round trip (ms) min/avg/max = 22 / 24 / 35
Using PING/XL From the Command Line
You can run PING/XL from the command line by using an INFO string. The
INFO string must contain the IP address of the remote node, and
optionally, the number of packets and number of bytes: :RUN
PING.NET.SYS;INFO=" ipaddress [, packets][, bytes]"
Within the INFO string, commas are required to separate parameters.
The number of packets and bytes that can be sent are the same as using
the menu-driven option. The default number of packets is a continuous
stream, and the default number of bytes is 64.
Stopping PING/XL.
You can enter CTRL-Y at any time to exit from PING/XL. If you send a
continuous stream of packets, you must enter CTRL-Y to stop sending
packets. The program exits without displaying the menu.
Example.
This example shows an INFO string containing the IP address, and
specifying five packets. The number of data bytes defaults to 64. The
statistics displayed by PING/XL are also included.
:run ping.net.sys;info="15.13.131.59,5"
-------- PING/XL (ICMP Echo Requestor) : Version B0300003 --------
PARAMETERS INPUT:
----------------
Remote IP address in hex : $0F0D833B
Number of packets : 5
Number of data bytes : Default of 64 bytes
---- PING $0F0D833B : 64 byte packet(s), 5 packet(s) ----
64 byte(s) from $0F0D833B : icmp_seq = 1, time = 26 ms
64 byte(s) from $0F0D833B : icmp_seq = 2, time = 24 ms
64 byte(s) from $0F0D833B : icmp_seq = 3, time = 23 ms
64 byte(s) from $0F0D833B : icmp_seq = 4, time = 23 ms
64 byte(s) from $0F0D833B : icmp_seq = 5, time = 24 ms
---- $0F0D833B PING Statistics ----
5 packet(s) transmitted, 5 packet(s) received, 0 % packet loss
round trip (ms) min/avg/max = 23 / 24 / 26
END OF PROGRAM
MPE/iX 5.0 Documentation