TRACEROUTE

La commande Tracer route TCP/IP (TRCTCPRTE), également appelée TRACEROUTE, trace la route des paquets IP jusqu'à un système de destination indiqué par l'utilisateur. La route peut faire intervenir de nombreux systèmes différents. Chaque système situé sur la route est appelé un saut (hop). Vous pouvez tracer tous les sauts de la route ou indiquer les sauts de début et de fin à tracer. 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.

La route est tracée en envoyant des paquets (appelés sondes) au système de destination. Chaque sonde contient une limite supérieure (appelée durée de vie ou TTL, Time To Live) du nombre de systèmes de saut que la sonde peut traverser. 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.

Remarque : Dans IP version 6, la durée de vie (TTL) est appelée limite de sauts (hop limit). Note: In IP Version 6, Time To Live (TTL) is called the hop limit.

Une route est tracée en incrémentant successivement d'un saut le TTL des paquets de sonde. La trace prend fin lorsqu'une réponse de sonde est reçue du système de destination ou lorsque la valeur de durée de vie de la sonde est égale au maximum autorisé. 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.

Les réponses aux paquets de sonde sont envoyées sous forme de messages à l'historique du travail ou sous forme d'entrées de file d'attente à une file d'attente de données indiquée par l'utilisateur. Responses from the probe packets are sent as messages to the job log or as queue entries to a user-specified data queue.

Paramètres

Système éloigné (RMTSYS)

Indique le nom du système distant (255 caractères) ou l'adresse IP du système de destination. Specifies the remote system name (255 characters) or IP address of the destination system.

valeur-caractère

Indiquez le nom du système distant ou l'adresse IP. Une adresse IP version 4 ou IP version 6 valide est acceptée. Specify the remote system name or IP address. Either a valid IP Version 4 or IP Version 6 address will be accepted.

Plage de sauts à sonder (RANGE)Range of hops to probe (RANGE)

Indique la plage de systèmes de saut dont des réponses de sonde sont attendues. Chaque sonde indique une valeur entière de TTL (Time To Live). Cette valeur de TTL est le nombre maximal de sauts que la sonde peut traverser. Par exemple, un paquet de sonde dont le TTL est 3 peut traverser au plus 3 systèmes de saut avant que le système de saut n'abandonne la sonde et ne renvoie des informations au système d'origine de la sonde. Specifies the range of hop systems from which probe responses are expected. Each probe specifies a TTL (Time To Live) integer value. This TTL value is the maximum number of hops the probe can traverse. For example, a probe packet with a TTL of 3 can pass through at most 3 hop systems before the hop system discards the probe and sends information back to the system from which the probe originated.

Élément 1 indique la première valeur de TTL envoyée dans les paquets de sonde. Élément 2 indique la dernière valeur de TTL envoyée dans les paquets de sonde. Les informations de trace sont générées à partir de chaque système de saut qui abandonne un paquet de sonde parce que la valeur de TTL de la sonde est atteinte, ou lorsque le système de destination est atteint. Élément 1 specifies the first TTL value sent in probe packets. Élément 2 specifies the last TTL value sent in probe packets. Trace information is generated from each hop system which discards a probe packet because the TTL value in the probe is reached or when the destination system is reached.

Élément 1: Starting probe TTL (hop limit)

1

Le saut de départ par défaut est 1. The default starting hop is 1.

1-255

Indiquez le premier numéro de TTL (limite de sauts) utilisé pour les paquets de sonde. Specify the first hop limit TTL number used for probe packets.

Élément 2: Maximum probe TTL (hop limit)

30

Le saut de fin par défaut est 30. The default ending hop is 30.

1-255

Indiquez le nombre maximal de sauts qu'une sonde peut traverser pour atteindre le système de destination. Specify the maximum number of hops a probe can traverse to reach the destination system.

Sondes envoyées par saut (PROBES)Probes sent per hop (PROBES)

Indique le nombre de paquets de sonde envoyés à chaque système de saut pour chaque valeur de TTL (limite de sauts) de sonde de la plage indiquée par le paramètre RANGE. Specifies the number of probe packets sent to each hop system for each probe TTL (hop limit) value in the range specified by the RANGE parameter.

3

Le nombre de sondes par défaut est trois. The default number of probes is three.

1-64

Indiquez le nombre de sondes à envoyer. Specify the number of probes to send.

Délai d'attente de réponse (WAITTIME)Response wait time (WAITTIME)

Indique le délai maximal, en secondes, d'attente d'une réponse d'un système de saut à chaque sonde. Specifies the maximum time, in seconds, to wait for a response from a hop system to each probe.

3

Attend jusqu'à 3 secondes une réponse. Wait up to 3 seconds for a response.

1-120

Indiquez le nombre maximal de secondes d'attente d'une réponse. Specify the maximum number of seconds to wait for a response.

Longueur du paquet (en octets) (PKTLEN)Packet length (in bytes) (PKTLEN)

Indique la longueur totale, en octets, du paquet IP envoyé pour chaque sonde. Specifies the total length, in bytes, of the IP packet sent for each probe.

40

La longueur du paquet de sonde est de 40 octets. The probe packet length is 40 bytes.

40-65535

Indiquez le nombre d'octets du paquet IP de sonde. Specify the number of bytes in the probe IP packet.

Sortie (OUTPUT)

Indique où sont envoyés les résultats obtenus à l'envoi des paquets de sonde. Des informations sont envoyées pour chaque saut jusqu'à ce que le système de destination soit atteint, notamment le nombre de sauts, le temps moyen aller-retour, l'adresse IP du saut et le nom d'hôte du saut. Specifies where the results obtained from sending the probe packets is sent. Information is sent for each hop until the destination system is reached, including hop count, average round-trip time, IP address of the hop and host name of the hop.

*MSG

Les résultats sont produits sous forme de messages envoyés à l'historique du travail dans lequel la commande est émise. Results are output as messages sent to the job log of the job in which the command is issued.

*VERBOSE

Les résultats sont produits sous forme de messages envoyés à l'historique du travail dans lequel la commande est émise. Toutes les réponses reçues sont affichées. Les résultats ne sont pas limités aux réponses ICMP TIME_EXCEEDED et PORT_UNREACHABLE. Results are output as messages sent to the job log of the job in which the command is issued. All responses received are displayed. Results are not limited to ICMP TIME_EXCEEDED and PORT_UNREACHABLE responses.

*DTAQ

Les résultats des sondes sont placés dans la file d'attente de données indiquée par le paramètre File d'attente de données (DTAQ). Results from probes are placed on the data queue specified by the Data Queue (DTAQ) parameter.

File d'attente de données (DTAQ)

Indique la file d'attente de données dans laquelle les entrées sont placées. Lorsqu'une file d'attente de données est indiquée, les messages ne sont pas envoyés à l'historique du travail, sauf en cas d'erreur. Specifies the data queue on which entries are placed. When a data queue is specified, messages are not sent to the job log unless an error occurs.

Chaque entrée de file d'attente contient la réponse à une sonde si elle a été reçue, ou indique qu'aucune réponse de sonde n'a été reçue. La file d'attente de données indiquée doit avoir une longueur d'entrée d'au moins 32 caractères et doit exister au moment de l'émission de cette commande. Each queue entry contains the response to a probe if one was received or indicates that no probe response was received. The specified data queue must have a queue entry length of at least 32 characters and must exist when this command is issued.

Qualificatif 1: File d'attente de données

nom

Indiquez le nom de la file d'attente de données. Specify the name of the data queue.

Qualificatif 2: Biblio

*LIBL

Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues. All libraries in the job's library list are searched.

*CURLIB

La bibliothèque en cours du travail est recherchée. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à parcourir. Specify the name of the library to search.

Format de version d'adresse (ADRVERFMT)Address version format (ADRVERFMT)

Indique comment le nom d'hôte indiqué pour le paramètre Système éloigné (RMTSYS) doit être résolu. Specifies how the host name specified for the Système éloigné (RMTSYS) parameter is to be resolved.

*CALC

La méthode de résolution du nom d'hôte est 'calculée' (déterminée) en fonction du nom d'hôte entré dans le paramètre RMTSYS. TRCTCPRTE (TRACEROUTE) utilise d'abord la résolution de nom d'hôte IP version 4 pour déterminer l'adresse IP. En cas d'échec, la résolution de nom d'hôte IP version 6 est utilisée pour déterminer l'adresse IP. The host name resolution method will be 'calculated' (determined) based on the host name entered in the RMTSYS parameter. TRCTCPRTE (TRACEROUTE) will first use IP Version 4 host name resolution in determining the IP address. If that fails, IP Version 6 host name resolution is used in determining the IP address.

*IP4

Utilisez la méthode de résolution de nom d'hôte IP version 4. Use the IP Version 4 host name resolution method.

*IP6

Utilisez la méthode de résolution de nom d'hôte IP version 6. Use the IP Version 6 host name resolution method.

Adresse IP source (LCLINTNETA)Source IP address (LCLINTNETA)

Indique comment est choisie l'adresse IP source du paquet de sonde. Specifies how the source IP address in the probe packet is chosen.

*ANY

L'adresse IP source des paquets de sonde est choisie par le système. Le système peut utiliser n'importe quelle interface locale active permettant d'atteindre le système distant. The source IP address in the probe packets is chosen by the system. The system may use any active local interface which can reach the remote system.

valeur-caractère

Indiquez l'interface locale à utiliser comme adresse IP source. Specify the local interface to use as the source IP address.

Port distant de base (RMTPORT)Base remote port (RMTPORT)

Indique le numéro de port UDP de base utilisé dans les sondes. Specifies the base UDP port number used in probes.

33434

Utilise le numéro de port UDP de base par défaut, 33434. Use the default base UDP port number of 33434.

1-65535

Indiquez le numéro de port UDP de base à utiliser dans les sondes. Specify the base UDP port number to be used in probes.

Recherche des noms d'hôte (NAMELOOKUP)Lookup host names (NAMELOOKUP)

Indique si les adresses IP sont résolues en noms d'hôte. Specifies whether IP addresses will be resolved to the host name.

*YES

L'adresse est résolue en nom d'hôte. The address will be resolved to the host name.

*NO

L'adresse n'est pas résolue en nom d'hôte. The address will not be resolved to the host name.

Protocole de sondage (PROBEPCL)Probing protocol (PROBEPCL)

Indique le protocole utilisé pour l'envoi des paquets de sonde. Specifies the protocol used when sending probe packets.

*ICMP

Les sondes envoyées au système de destination sont des paquets ICMP (Internet Control Message Protocol) Echo Request. The probes sent to the destination system are ICMP (Internet Control Message Protocol) Echo Request packets.

*UDP

Les sondes envoyées au système de destination sont des paquets UDP (User Datagram Protocol). The probes sent to the destination system are UDP (User Datagram Protocol) packets.

Autoriser la fragmentation (FRAGMENT)Allow fragmentation (FRAGMENT)

Indique comment est déterminé le paramétrage de l'option "Do Not Fragment" (ne pas fragmenter) dans l'en-tête IP du paquet de sonde. Specifies how the setting of the "Do Not Fragment" option in the IP header of the probe packet is determined.

*TCPA

The system sets the option based on the setting of the IP Path MTU Discovery TCP/IP attribute.

Remarque : Utilisez la commande Modifier attributs TCP/IP (CHGTCPA) pour modifier la valeur de cet attribut. Remarque :Use the Change TCP/IP Attributes (CHGTCPA) command to change the value of this attribute.

*NO

L'option "Do Not Fragment" est toujours indiquée. The "Do Not Fragment" option is always specified.

*YES

L'option "Do Not Fragment" n'est jamais indiquée. The "Do Not Fragment" option is never specified.

Exemples

Exemple 1 : Tracer la route complète Example 1: Trace Entire Route

TRCTCPRTE   RMTSYS('130.14.3.5')

Cette commande trace la route complète entre le système local et le système de destination dont l'adresse IP est '130.14.3.5'. Trois paquets de sonde sont envoyés à chaque système de saut. Chaque paquet de sonde IP a une longueur de 40 octets et contient un paquet ICMP Echo Request. Les résultats reçus sont envoyés sous forme de messages à l'historique du travail. 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.

Exemple 2 : Tracer une partie de la route Example 2: Trace Partial Route

TRCTCPRTE   RMTSYS('AAA.BBBB.COM')  RANGE(3 7)
            PROBES(5)  PROBEPCL(*UDP)
            OUTPUT(*DTAQ)  DTAQ(MYLIB/MYDATAQ)

Cette commande trace la route entre le système local et le système de destination dont le nom d'hôte est 'AAA.BBBB.COM'. Cinq paquets de sonde sont envoyés pour la valeur de début de plage 3. Chaque sonde est un paquet UDP contenu dans un paquet IP de 40 octets de long. Chacune de ces 5 sondes indique un TTL de 3. Si le système AAA.BBB.COM peut être atteint en traversant au plus 2 systèmes de saut, la trace se termine à ce stade. 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.

Si le système AAA.BBB.COM est situé à plus de 2 sauts, un autre ensemble de 5 paquets de sonde est envoyé à la destination AAA.BBB.COM. Chacune de ces 5 sondes indique un TTL de 4. Cette opération est répétée jusqu'à ce que le système AAA.BBB.COM réponde à une sonde ou que 5 sondes avec un TTL de 7, la valeur de fin de plage, soient envoyées. Tous les résultats reçus sont placés sous forme d'entrées de file d'attente dans la file d'attente de données MYDATAQ de la bibliothèque MYLIB. 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.

Exemple 3 : Tracer une route avec une adresse IP version 6 Example 3: Trace Route with an IP Version 6 Address

TRCTCPRTE   RMTSYS('1:2:3:4:5:6:7:8')

Cette commande trace la route complète entre le système local et le système de destination dont l'adresse IP est 1:2:3:4:5:6:7:8. Trois paquets de sonde sont envoyés à chaque système de saut. Chaque paquet de sonde IP a une longueur de 40 octets et contient un paquet ICMP6 Echo Request. Les résultats reçus sont envoyés sous forme de messages à l'historique du travail. 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.

Remarque : Un signe deux-points ( : ) dans la valeur du paramètre indique une adresse IP version 6 et provoque la génération d'un paquet de demande d'écho ICMP6. Remarque :A colon character ( : ) found in the parameter value signifies an IP Version 6 address and will cause an ICMP6 echo request packet to be generated.

Exemple 4 : Tracer une route avec un nom d'hôte IP version 6 Example 4: Trace Route with an IP Version 6 Host Name

TRCTCPRTE   RMTSYS('IP6HOST')

Cette commande trace la route complète entre le système local et le système de destination dont le nom d'hôte est 'IP6HOST'. Trois paquets de sonde sont envoyés à chaque système de saut. Chaque paquet de sonde IP a une longueur de 40 octets et contient un paquet ICMP6 Echo Request. Les résultats reçus sont envoyés sous forme de messages à l'historique du travail. 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.

Le "format de version d'adresse" par défaut est *CALC. La résolution du nom d'hôte peut renvoyer plusieurs adresses IP pour un nom d'hôte donné. Mais dans le cas de *CALC, la première adresse IP (IP version 4 ou IP version 6) résolue est l'adresse utilisée lors de la tentative de trace de la route. 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.

Exemple 5 : Tracer une route avec un nom d'hôte IP version 6 en utilisant explicitement la résolution de nom d'hôte IP version 6 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)

Cette commande trace la route complète entre le système local et le système de destination dont le nom d'hôte est 'IP6HOST'. Trois paquets de sonde sont envoyés à chaque système de saut. Chaque paquet de sonde IP a une longueur de 40 octets et contient un paquet ICMP6 Echo Request. Les résultats reçus sont envoyés sous forme de messages à l'historique du travail. 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.

Cet exemple diffère de l'exemple 4 en ce que seule une adresse résolue IP version 6 valide, pour IP6HOST, est utilisée lors de la tentative de trace de la route. 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.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP3250

La valeur du paramètre DTAQ est obligatoire avec OUTPUT(*DTAQ). DTAQ parameter value required with OUTPUT(*DTAQ).

TCP3251

Le paramètre DTAQ n'est pas valide lorsque OUTPUT(*MSG) est indiqué. DTAQ parameter not valid when OUTPUT(*MSG) specified.

TCP3252

La valeur de début de plage est supérieure à la limite de plage. Starting range value greater than range limit.