HP 3000 Manuals HP 3000 Manuals
Displaying Connection Information
The PING tool allows you to confirm the reachability of a remote node
that supports the internet protocol.
You can also use PING to estimate the round trip times before proceeding
with lengthy transactions. If you send four or more bytes of data with
the echo request, PING displays the round trip times in milliseconds.
However, since the echo is performed at layer 3, PING is not
the appropriate tool to use when attempting to find out if a
particular application is available on the remote node or to estimate
application-level round trip times.
You can run PING by itself or as one of the NETTOOL tools. See chapter 6
for instructions on running this tool using the NETTOOL interface.
To Run PING from the Command Line
You can run PING 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]"
The default number of packets is a continuous stream and the default
number of bytes is 64.
Stopping PING.
You can enter [CONTROL]-Y at any time to exit. The program exits without
displaying the menu when run from the command line.
The following examples illustrate using PING with the INFO string. In
each case, the parameters echoed by PING are also given.
Within the INFO string, commas are required to separate parameters.
Example 1.
This example shows using an INFO string containing all three parameters.
:RUN PING.NET.SYS;INFO="15.13.131.59,10,100"
---- PING/XL (ICMP Echo Requestor) : Version X0100003 ----
PARAMETERS INPUT:
----------------
Remote IP address in hex :$0F0D833B
Number of packets : 10
Number of data bytes : 100
---- PING $0F0D833B : 100 byte packet(s), 10 packet(s) ----
100 byte(s) from $0F0D833B : icmp_seq = 1, time = 25 ms
100 byte(s) from $0F0D833B : icmp_seq = 2, time = 23 ms
100 byte(s) from $0F0D833B : icmp_seq = 3, time = 24 ms
100 byte(s) from $0F0D833B : icmp_seq = 4, time = 24 ms
100 byte(s) from $0F0D833B : icmp_seq = 5, time = 25 ms
100 byte(s) from $0F0D833B : icmp_seq = 6, time = 24 ms
100 byte(s) from $0F0D833B : icmp_seq = 7, time = 25 ms
100 byte(s) from $0F0D833B : icmp_seq = 8, time = 24 ms
100 byte(s) from $0F0D833B : icmp_seq = 9, time = 26 ms
100 byte(s) from $0F0D833B : icmp_seq = 10, time = 25 ms
---- $0F0D833B PING Statistics ----
10 packet(s) transmitted, 10 packet(s) received, 0 % packet loss
round trip (ms) min/avg/max = 23 / 25 / 26
Example 2.
This example shows an INFO string containing the IP address, and five
packets. Note that the number of bytes has been defaulted by omitting it
in the info string.
:RUN PING.NET.SYS;INFO="15.13.131.59,5"
---- PING/XL (ICMP Echo Requestor) : Version X0100003 ----
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
Example 3.
This example shows an INFO string using the default for number of
packets, a continuous stream, of five bytes each. Output is not shown.
PING will continue to send data until [CONTROL]-Y is entered.
:RUN PING.NET.SYS;INFO="15.13.131.59,,5"
---- PING/XL (ICMP Echo Requestor) : Version X0100003 ----
PARAMETERS INPUT:
----------------
Remote IP address in hex : $0F0D833B
Number of packets : Default of continuous stream
Number of data bytes : 5
Error and Information Messages.
In addition to the normal reply message details and statistics, PING can
display informational and/or error messages. These messages are given
below, with an explanation and action to be taken for each message.
User Input Errors (Menu-Driven).
Error Message Invalid IP address. Press RETURN to quit.
Cause An IP address with invalid syntax has been entered
for the IP address prompt. The correct syntax for an
IP address is A.B.C.D - where A, B, C, and D are
decimal numbers in the range 0 - 255.
Action Enter an IP address with valid syntax or press
[RETURN] to quit.
Error Message Invalid number of packets. Press RETURN for default
of infinite packets.
Cause An invalid number of packets value has been entered
for the number of packets prompt. A valid input is a
decimal number in the range 1 - 65534.
Action Enter a valid number of packets value or press
[RETURN] to choose the default of sending a
continuous stream of packets.
Error Message Invalid number of bytes. Press RETURN for default of
64 bytes.
Cause An invalid number of bytes value has been entered for
the number of bytes prompt. A valid input is a
decimal number in the range 0 - 2048.
Action Enter a valid number of bytes value or press [RETURN]
to choose the default of sending 64 data bytes per
packet.
User Input Errors (Command-Line).
Error Message Parameter input error. Quitting...
Cause An irrecoverable error occurred while trying to read
the user parameter, either interactively or from the
INFO string. This normally happens only when one of
the input parameters was out of bounds by an extreme
amount.
Action Check the parameters to find the incorrect one and
input a valid value.
Error Message Remote IP address is a required parameter.
Cause An IP address was not passed in the INFO string.
Action Pass an IP address as the first parameter within the
INFO string.
Error Message Invalid IP address.
Cause An IP address with invalid syntax has been entered in
the INFO string. The correct syntax for an IP
address is A.B.C.D - where A, B, C, and D are decimal
numbers in the range 0 - 255.
Action Pass a valid IP address within the INFO string.
Error Message Invalid number of packets. Valid range: 1 - 65534
Cause An invalid number of packets value has been passed in
the INFO string. A valid input is a decimal number
in the range 1 - 65534.
Action Pass a valid value for the number of packets within
the INFO string, or omit it to choose the default of
sending a continuous stream of packets.
Error Message Invalid number of bytes. Valid range: 0 - 2048
Cause An invalid number of bytes value has been passed in
the INFO string. A valid input is a decimal number
in the range 0 - 2048.
Action Pass a valid value for the number of bytes within the
INFO string, or omit it to choose the default of 64
bytes.
Networking Errors.
Error Message Receive timeout occurred. Shutting Down...
Cause The PING process has not received any response to its
requests for two minutes. It shuts itself down,
assuming that the local or the remote side is
inactive.
Action This could indicate that the remote node is
unreachable. Also check if the local node is
congested or hung causing the local ICMP Server not
to respond. (The local ICMP Server interacts with
PING to send ICMP Echo Requests to the remote and
passes incoming replies to the right PING/XL
process.)
Error Message Cannot contact local ICMP Server. Shutting down...
Cause PING/XL was not able to contact the local ICMP
Server.
Action Check if the transport is active. If not, start the
transport.
Error Message Server not accepting requests, as it is busy. Please
try later.
Cause Only 15 PING processes can be active at any time.
That is, only 15 users can run PING at the same time.
Additional users trying to run PING will get this
error message.
Action Wait and try later. One of the other PING processes
might have completed, allowing you to run the
program.
Error Message Cannot resolve path to remote. Path Error, Parm =
#Parm_Value. Refer PATH RESULT CODES table in NS
3000/iX Error Messages Manual.
Cause A suitable path out of the local node to reach the
remote node could not be found.
Action Look up the table mentioned in the message, under the
Parm_Value code, and take the action recommended
therein.
Error Message Arithmetic trap Parm. Program Quitting.
Cause This is an internal error.
Action Submit an SR with the Parm value, a description of
what you were trying to do, and any other abort
output that is printed on the terminal.
Internal Errors.
The following messages are all internal errors, and should not happen
under normal circumstances. In each case, submit an SR.
* Error opening $STDIN. Program quitting.
* Error opening $STDLIST. Program quitting.
* Cannot create port. Program quitting.
* Internal Error in server. Shutting Down...
* Buffer Error in server. Shutting Down...