 |
» |
|
|
|
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 “Using NETTOOL” for instructions
on running this tool using the NETTOOL interface. 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. 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. This example shows using an INFO string containing all three parameters. |
:RUN PING.NET.SYS;INFO="15.13.131.59,10,100"
---- PING/iX (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 |
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/iX (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 |
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/iX (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 MessagesIn 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)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. |
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. |
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)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. |
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. |
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. |
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. |
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. |
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/iX process.) |
MESSAGE: Cannot contact local ICMP
Server. Shutting down... | CAUSE: PING/iX was not able to contact the local ICMP
Server. ACTION: Check if the transport is active. If not, start
the transport. |
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. |
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. |
MESSAGE: Arithmetic trap Parm. Program
Quitting. | CAUSE: This is an internal error. ACTION: Submit an CR with the Parm value, a description of what you were trying to
do, and any other abort output that is printed on the terminal. |
The following messages are all internal errors, and should
not happen under normal circumstances. In each case, submit an CR. 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...
|
Printable version
