You can inquire on the route being used to reach a remote node in your TCP/IP network using the NW TCPIP TRACERT command. This command enables you to interrogate your TCP/IP network to determine whether the remote node is reachable, and the path used to try to reach it.
The TCPIP TRACERT command specifies a target system in the IP network, either by IP address or domain name. A sequence of ICMP Echo messages are sent to the target system with gradually increasing Time-To-Live values, starting at 1. This continues until a successful Echo response is received or the Time-To-Live value exceeds the MAXHOPS value you specify. When all Echoes are complete, one or more trace reports are returned containing the consolidated Echo results.
The success or failure of the TCPIP TRACERT command is reported in either the TCPIP TRACERT REPORT FOR NODE report (41010) or the TCPIP REPORT TRACERT NO TRACE TO report (41011). To redisplay these reports on the system console, enter MSG NW at the system console. In addition, if the TRACERT command was initiated from the system console, then the TRACERT report is also displayed in a manner similar to a response on the system console. Refer to the Networking Reports and Log Messages Help for complete syntax on these reports.
To inquire on a route, enter the following command:
NW TCPIP TRACERT IPADDRESS <ip address> HOSTNAME <domain name> TIMEOUT <timeout value> MAXHOPS <hop limit> REPORTLINES <number of lines> RESOLVEADDRESS <+/->
The variables are described as follows.
|
Variable |
Description |
|---|---|
|
IPADDRESS <ip address> |
IP address of the target system; can be either an IPv4 address or an IPv6 address. |
|
HOSTNAME <domain name> |
Domain name of the target system. |
|
TIMEOUT <timeout value> |
Specifies how long TCP/IP will wait for a response to each Echo message or a time exceeded report before regarding the Echo as lost. The value is in the range of 1 to 2000 milliseconds, with a default value of 1 second (1000 milliseconds). |
|
MAXHOPS <hop limit> |
The maximum Time-To-Live value for this trace execution. The value is in the range of 1 to 255 network hops, with a default value of 30. |
|
REPORTLINES <number of lines> |
A formatting instruction for the TRACERT REPORT. One line in the report is used for all the results for a particular Time-To-Live value. This variable specifies the limit of the number of lines to be included in each TRACERT REPORT. If the actual length of the Echo sequence is larger than <number of lines>, the report is divided into one or more PARTIAL TRACERT REPORTs, followed by a FINAL TRACERT REPORT. The value is in the range of 1 to 255 lines, with a default value of 255. |
|
RESOLVEADDRESS <+/-> |
A formatting instruction for the TRACERT REPORT. If set, the report attempts to convert the IP addresses responding to the Echo commands to domain names. RESOLVEADDRESS is reset by default. |
IPv4 Examples
NW TCPIP TRACERT 210.31.64.202 TIMEOUT 1000 MAXHOPS 20
This command interrogates for the path used to reach the system at IP address 210.31.64.202, with the limitation that it should be reached in no more than 1 second (1000 milliseconds) and in no more than 20 network hops.
NW TCPIP TRACERT abc.def.ghi.net REPORTLINES 12 RESOLVEADDRESS +
This command interrogates for the path used to reach the system named abc.def.ghi.net, with the result broken into report segments of 12 routing hops each, and with available node names of all the nodes in the path listed in the reports.
IPv6 Example
NW TCPIP TRACERT 090F:0:0:0:9F:FF:89:98 TIMEOUT 1000 MAXHOPS 20
This command interrogates for the path used to reach the system at IP address 090F:0:0:0:9F:FF:89:98, with the limitation that it should be reached in no more than 1 second (1000 milliseconds) and in no more than 20 network hops.
