CL Command Reference - TRACEROUTE
CL Command List > TRACEROUTE Reference
Description:
The Trace TCP/IP Route (TRCTCPRTE) command, also known as TRACEROUTE, traces the route of IP packets to a user-specified destination system. The route can involve many different systems along the way. Each system along the route is referred to as a hop. You can trace all hops along the route or specify the starting and ending hops to be traced.
The route is traced by sending packets (called probes) to the destination system. Each probe contains an upper limit (called Time To Live or TTL) on the number of hop systems the probe can pass through.
Note: In IP Version 6, Time To Live (TTL) is called the hop limit.
A route is traced by successively incrementing the TTL of the probe packets by one hop. The trace ends when either a probe response is received from the destination system or when the probe Time To Live value equals the maximum allowed.
Responses from the probe packets are sent as messages to the job log or as queue entries to a user-specified data queue.
Examples:
Example 1: Trace Entire Route
TRCTCPRTE RMTSYS(¡¯130.14.3.5¡¯)
This command traces the entire route between the local system and the destination system whose IP address is ¡¯130.14.3.5¡¯. Three probe packets will be sent to each hop system. Each IP probe packet will be 40 bytes long and will contain an ICMP Echo Request packet. Results received are sent as messages to the job log.
Example 2: Trace Partial Route
TRCTCPRTE RMTSYS(¡¯AAA.BBBB.COM¡¯) RANGE(3 7) PROBES(5)
PROBEPCL(*UDP) OUTPUT(*DTAQ) DTAQ(MYLIB/MYDATAQ)
This command traces the route between the local system and the destination system whose host name is ¡¯AAA.BBBB.COM¡¯. Five probe packets will be sent for the starting range value of 3. Each probe will be a UDP packet inside an IP packet that is 40 bytes long. Each of these 5 probes will specify a TTL of 3. If system AAA.BBB.COM can be reached by passing through at most 2 hop systems then the trace will terminate at this point.
If system AAA.BBB.COM is futher than 2 hops, another set of 5 probe packets will be sent to the destination AAA.BBB.COM. Each of these 5 probes will specify a TTL of 4. This is repeated until either system AAA.BBB.COM responds to a probe or 5 probes with a TTL of 7, the ending range value, are sent. Any results received are placed as queue entries on data queue MYDATAQ in library MYLIB.
Example 3: Trace Route with an IP Version 6 Address
TRCTCPRTE RMTSYS(¡¯1:2:3:4:5:6:7:8¡¯)
This command traces the entire route between the local system and the destination system whose IP address is 1:2:3:4:5:6:7:8. Three probe packets will be sent to each hop system. Each IP probe packet will be 40 bytes long and will contain an ICMP6 Echo Request packet. Results received are sent as messages to the job log.
Example 4: Trace Route with an IP Version 6 Host Name
TRCTCPRTE RMTSYS(¡¯IP6HOST¡¯)
This command traces the entire route between the local system and the destination system whose host name is ¡¯IP6HOST¡¯. Three probe packets will be sent to each hop system. Each IP probe packet will be 40 bytes long and will contain an ICMP6 Echo Request packet. Results received are sent as messages to the job log.
The default ¡åAddress version format¡å is *CALC. Host name resolution may return multiple IP addresses for a given host name. But, in the case (*CALC), the first IP address (IP Version 4 or IP Version 6) resolved will be the address used when attempting to trace the route.
Example 5: Trace Route with an IP Version 6 Host Name and Explicitly Use IP Version 6 Host Name Resolution
TRCTCPRTE RMTSYS(¡¯IP6HOST¡¯) ADRVERFMT(*IP6)
This command traces the entire route between the local system and the destination system whose host name is ¡¯IP6HOST¡¯. Three probe packets will be sent to each hop system. Each IP probe packet will be 40 bytes long and will contain an ICMP6 Echo Request packet. Results received are sent as messages to the job log.
This example differs from example 4 in that only a valid IP version 6 resolved address, for IP6HOST, will be used when attempting to trace the route.