Use the Tracerte IP Address dialog to issue a z/OS Communications
Server TSO TRACERTE command to debug various network problems. The
TRACERTE command sends UDP requests with varying TTL (time-to-live)
or hop count values and then waits for the routers between the local
and remote hosts to send TTL-exceeded messages.
The remaining fields in this dialog box are prefilled with the
default values when the dialog is initialized. You can change the
value of any modifiable field prior to invoking the command. Field-level
validation is performed prior to command execution. You are prompted
by the dialog to correct invalid data.
- Hostname or IP Address: Specifies the destination
host. This must be an IP address, or a host name that can be resolved.
This may be an IPv4 address or an IPv6 address. IPv4-mapped IPv6 addresses
are not supported.
IPv4 addresses can take one of these formats:
- d.d.d.d: When a four-part address
is specified, each part is interpreted as a byte of data and is assigned,
from left to right, to the four bytes of an IPv4 address.
- d.d.d: When a three-part address
is specified, the last part is interpreted as a 16-bit quantity and
placed in the right-most two bytes of the network address.
This format makes the three-part address format convenient
for specifying Class B network addresses, such as "128.net.host."
- d.d: When a two-part address is supplied,
the last part is interpreted as a 24-bit quantity and placed in the
right-most three bytes of the network address. This makes the
two-part address format convenient for specifying Class A network
addresses, such as "net.host."
- d: When only one part is given, the value
is stored directly in the network address without any byte rearrangement
IPv6 addresses are expressed in colon hexidecimal notation.
IPv4 mapped IPv6 addresses will be converted to IPv4 addresses.
If
the Hostname value is specified as a host name (not an IP address),
the command invokes the resolver used by the Tivoli Enterprise Portal
to obtain an IP address for the host_name value. The command uses
the first IP address that is returned by the resolver.
You
can use the Addrtype option to determine whether the command requests
only IPv4 or only IPv6 IP addresses from the resolver used by the
Tivoli Enterprise Portal. If you do not specify the Addrtype option,
the Interface and Source IP Address options can also be used to determine
whether the command requests only IPv4 or only IPv6 IP addresses from
the resolver. If neither Addrtype, Interface, or Source IP Address
are specified, then the command does not request a specific type of
IP address from the resolver; IPv4 and IPv6 IP addresses can be returned
by the resolver used by the Tivoli Enterprise Portal.
When using
IPv6 link-local addresses, you can provide scope information with
the IP address or host name. To specify scope information, add a percent
character (%) after the Hostname or IP Address value, followed by
the scope information (usually an interface name). For a more complete
explanation about the use of scope information, see the support for
scope information in the IBM z/OS Communications Server: IPv6 Network and Application Design Guide.
- Packet Size Optional parameter that can
be used to change the size of a probe packet. The dialog accepts values
between 1 and 65515 inclusive in the Packet Size field. An error
message is returned in the command output if an IPv4 address is used
in the TRACERTE command with a packet size in excess of 65495.
- Interface: Specifies the local interface
over which the packets are sent. The interface is either a maximum
16-byte name from a LINK or INTERFACE profile statement, or the IP
address of a local interface. IPv4-mapped IPv6 addresses are not supported.
Local VIPA or LOOPBACK interfaces are not valid.
If the destination
host is specified as a host name and the Addrtype option is not specified,
the address type of the Interface value is used to determine whether
the host name should be resolved to an IPv4 or IPv6 IP address. When
this parameter is specified, the TRACERTE command establishes affinity
to either the default TCP/IP stack or to the stack that is specified
on the TCP parameter. The specified interface must be defined to the
stack to which the TRACERTE command establishes affinity.
You
must also ensure that a route exists to the destination using the
specified interface. This can be any kind of route, including a default
route. This parameter is independent of the Source IP Address parameter
used as the source IP address in the outbound packets.
Note:
As
a diagnostics aid in analyzing response times and path availability
using a particular route, this parameter routes packets over specified
interfaces regardless of the multipath settings in the IPCONFIG/IPCONFIG6
MULTIPATH profile statements by bypassing the outbound path selection
algorithm for the packets.
Restriction:
You cannot specify scope information for the Interface value.
- Source IP Address: Specifies the source
IP address. You must specify this as an IP address and not a host
name. IPv4-mapped IPv6 addresses are not supported. On hosts with
more than one IP address, you can set the source address to the IP
address for another one of the stack's interfaces. This can be a VIPA
address. If the destination host is specified as a host name and the
Addrtype option is not specified, the address type of the Source IP
Address value is used to determine whether the host name should be
resolved to an IPv4 or IPv6 IP address. For rules regarding the format
of IPv4 and IPv6 addresses, see the Hostname or IP
Address field in help.
Restriction: You
cannot specify scope information for the Source IP Address value.
- Max (hops): Specifies the maximum time to
live (TTL) or hop limit. The range for valid values is 1 -
255. The default is 30.
- TOS: Specifies the Type of Service value
(tos) in the probe packets. The range for valid values is 0 -
255. The default is 0. This parameter applies
only to IPv4 destinations and is ignored for IPv6 destinations.
- Debug: Specifies that extra messages are
to be printed. The default is nodebug.
- Verbose: Specifies that additional information
is to be displayed. The information currently displayed is the number
of bytes of the ICMP response and the IP address to which the response
was sent. The default is not to display Verbose information.
- LimDisp: Displays the hop limit value from
each received packet. This value can be used to help detect asymmetric
routing. The default is not to display the hop limit value.
- TCP Stack: Specifies the name of the TCP/IP
stack to be used. This field should be completed with the 8-byte
procedure name that is used to start the TCP/IP stack.
- Port: Specifies the source port number and
the starting destination port number. The range for valid values is
2048 - 60 000. The default is 33 434.
For
example, in the default case, the source port number is 33 434. The
destination port number in the first outbound probe packet is the
default port value of 33 434 plus one, or 33 435. The destination
port number is incremented by 1 for each subsequent outbound probe
packet.
- Try: Specifies the number of attempts. The
range for valid values is 1 - 20. The default is 3.
- Wait: Specifies how long to wait for a response.
The range for valid values is 1 - 255. The default is 5 seconds.
- NoName: Specifies to print the hop IP address
without resolving it to a host name. This address is numeric and saves
a name server address-to-name lookup for each gateway on the path.
The default is not to print the hope IP address without resolving
it to a host name.
- NoRoute: Sends information directly to a
host in an attached network. If the selected route indicates that
the host is not in an adjacent network, an error is returned. The
default is not to send information directly to a host in an attached
network.
- Addrtype: Specifies the IP address type
that the resolver used by the Tivoli Enterprise Portal should return
when resolving the host name to an IP address. The values for this
option are not case sensitive.
- IPv6: Specifies that only IPv6 IP addresses
should be returned from the resolver when resolving the host name
to an IP address.
- IPv4: Specifies that only IPv4 IP addresses
should be returned from the resolver when resolving the host name
to an IP address.
If the ADDRTYPE option is not specified, see the description
of the Hostname parameter for information on
how the host name value is resolved to an IP address.
When you have completed editing the fields in the Tracerte IP Address
dialog, click OK to issue the specified TRACERTE
command. Click Cancel to close the Tracerte
IP Address dialog.