VFYTCPCNN
Vérifier connexion TCP/IP
Verify TCP/IP Connection
En bref
La commande Vérifier la connexion TCP/IP (VFYTCPCNN), également appelée PING, teste la connectivité entre un système et le système éloigné indiqué par le paramètre de système éloigné. The Verify TCP/IP Connection (VFYTCPCNN) command, also known as PING, tests the connectivity between a system and the remote system specified by the remote system parameter.
VFYTCPCNN se lit VFY
(Vérifier) + TCPCNN.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
VFYTCPCNN RMTSYS(…)
Paramètres
-
RMTSYSSystème éloigné obligatoire -
INTNETADRAdresse internet éloignée -
ADRVERFMTFormat de version d'adresse Address version format -
MSGMODEMode de message Message mode -
PKTLENLongueur du paquet (en octets) Packet length (in bytes) -
NBRPKTNombre de paquets Number of packets -
WAITTIMEDélai d'attente (en secondes) Wait time (in seconds) -
LCLINTNETAAdresse internet locale -
TOSType de service Type of service -
IPTTLDurée de vie IP (limite de sauts) IP time to live (hop limit)
Astuce : dans une session 5250, tapez VFYTCPCNN puis F4 pour
l'invite de saisie, et F1 sur un paramètre pour son aide.
Aide IBM i de la commande
Texte du F1, IBM i 7.5 en français
(bibliothèque QSYS)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande Vérifier la connexion TCP/IP (VFYTCPCNN), également appelée PING, teste la connectivité entre un système et le système éloigné indiqué par le paramètre de système éloigné. The Verify TCP/IP Connection (VFYTCPCNN) command, also known as PING, tests the connectivity between a system and the remote system specified by the remote system parameter.
Remarques : Notes:
- La commande VFYTCPCNN (PING) ne peut pas être utilisée pour vérifier les connexions IP over SNA. The VFYTCPCNN (PING) command cannot be used to verify IP over SNA connections.
- Le nom de domaine local est utilisé par de nombreuses applications, dont PING. PING ajoute le domaine local à un nom d'hôte si aucun domaine n'est indiqué ou si un point (.) n'apparaît pas à la fin du nom d'hôte indiqué. The local domain name is used by many applications including PING. PING appends the local domain to a host name if a domain is not specified or if a period (.) does not appear at the end of the specified host name.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| RMTSYS | Système éloigné | Valeur caractère, *INTNETADR | Obligatoire, positionnel 1 |
| INTNETADR | Adresse internet éloignée | Valeur caractère | Facultatif |
| ADRVERFMT | Format de version d'adresseAddress version format | *CALC, *IP4, *IP6 | Facultatif |
| MSGMODE | Mode de messageMessage mode | Liste d'éléments | Facultatif |
| Élément 1: Response message detail | *VERBOSE, *QUIET | ||
| Élément 2: Summary, if response errors | *COMP, *ESCAPE | ||
| PKTLEN | Longueur du paquet (en octets)Packet length (in bytes) | 8-65500, 256 | Facultatif |
| NBRPKT | Nombre de paquetsNumber of packets | 1-999, 5 | Facultatif |
| WAITTIME | Délai d'attente (en secondes)Wait time (in seconds) | 1-120, 1 | Facultatif |
| LCLINTNETA | Adresse internet locale | Valeur caractère, *ANY | Facultatif |
| TOS | Type de serviceType of service | *MINDELAY, *MAXTHRPUT, *MAXRLB, *MINCOST, *NORMAL | Facultatif |
| IPTTL | Durée de vie IP (limite de sauts)IP time to live (hop limit) | 1-255, *DFT | Facultatif |
Système éloigné (RMTSYS)
Indique le nom du système éloigné de l'hôte avec lequel l'opération de vérification TCP/IP a lieu. Pour que l'opération réussisse, le nom doit être valide et le système éloigné doit pouvoir communiquer avec le système local. Vous pouvez affecter des noms à une adresse Internet en utilisant l'une des méthodes suivantes : Specifies the remote system name of the host with which the Verify TCP/IP operation takes place. To be successful, the name must be valid, and the remote system must be able to communicate with the local system. You can assign names to an internet address by using either of the following:
- Le menu Gestion de la table des hôtes, qui est une option du menu Configuration de TCP/IP. Work with Host Table menu, which is an option on the Configure TCP/IP menu.
- Un serveur de noms éloigné pour faire correspondre un nom de système éloigné à une adresse Internet. Remote name server to map a remote system name to an internet address.
La résolution du nom d'hôte dépendra de la valeur indiquée pour le paramètre Format de version d'adresse (ADRVERFMT). Host name resolution will depend on the value specified for the Address version format (ADRVERFMT) parameter.
- *INTNETADR
- Le système éloigné est identifié par la valeur indiquée pour le paramètre Adresse Internet éloignée (INTNETADR). The remote system is identified by the value specified for the Adresse internet éloignée (INTNETADR) parameter.
- valeur-caractère
- Indiquez le nom du système éloigné à vérifier. Specify the remote system name to be verified.
Adresse internet éloignée (INTNETADR)
Indique l'adresse Internet éloignée. Une adresse IP version 4 ou IP version 6 valide est acceptée. Une adresse Internet IP version 4 n'est pas valide si la partie identificateur de réseau ou la partie identificateur d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. Specifies the remote internet address. Either a valid IP Version 4 or IP Version 6 address will be accepted. An IP Version 4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address.
- valeur-caractère
- Indiquez l'adresse Internet du système distant. Si l'adresse Internet est entrée depuis une ligne de commande, elle doit être placée entre apostrophes. Specify the internet address of the remote system. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
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 sera « calculée » (déterminée) d'après le nom d'hôte saisi dans le paramètre RMTSYS. La résolution de nom d'hôte IP version 6 sera effectuée si le système a au moins une adresse IP version 6 configurée. Si aucune adresse IP version 6 n'est trouvée, la résolution de nom d'hôte IP version 4 sera effectuée si le système a au moins une adresse IP version 4 configurée. L'adresse de bouclage n'est pas considérée dans ce cas comme une adresse configurée. The host name resolution method will be 'calculated' (determined) based on the host name entered in the RMTSYS parameter. IP Version 6 host name resolution will be performed if the system has at least one IP Version 6 address configured. If an IP Version 6 address is not found, IP Version 4 host name resolution will be performed if the system has at least one IP Version 4 address configured. The loopback address is not considered in this case as a configured 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.
Mode de message (MSGMODE)Message mode (MSGMODE)
Indique la quantité d'informations à afficher. Specifies the amount of information to be displayed.
Élément 1: Response message detail
- *VERBOSE
- Affichez les messages à mesure que chaque réponse PING arrive. Display messages as each PING response arrives.
- *QUIET
- Affichez uniquement le message PING (VFYTCPCNN) initial et les messages récapitulatifs. Display only the initial PING (VFYTCPCNN) message and the summary messages.
Élément 2: Summary, if response errors
- *COMP
- Le message récapitulatif renvoyé par la demande PING (VFYTCPCNN) est un message de fin. The summary message returned by the PING (VFYTCPCNN) request is a completion message.
- *ESCAPE
- Un message *ESCAPE pouvant être surveillé est renvoyé. Cela est utile si vous avez écrit un programme pour émettre la demande PING et souhaitez surveiller les erreurs de cette demande. Voir la section des messages d'erreur de l'aide de la commande PING (VFYTCPCNN) pour la liste des messages *ESCAPE possibles. A monitorable escape message is returned. This is useful if you have written a program to issue the PING request and wish to monitor the PING request for errors. See the error messages section of the PING (VFYTCPCNN) command help for a list of possible escape messages.
Longueur du paquet (en octets) (PKTLEN)Packet length (in bytes) (PKTLEN)
Indique la longueur (en octets) des données des paquets envoyés au système éloigné. Elle n'inclut pas les en-têtes de paquet. Specifies the length (in bytes) of the data in the packets that are sent to the remote system. This does not include packet headers.
- 256
- La longueur des données du paquet est de 256 octets. The packet data length is 256 bytes.
- 8-65500
- Indiquez le nombre d'octets de données de chaque paquet. Specify the number of bytes of data in each packet.
Nombre de paquets (NBRPKT)Number of packets (NBRPKT)
Indique le nombre de paquets envoyés au système éloigné. Specifies the number of packets that are sent to the remote system.
- 5
- Cinq paquets sont envoyés. Five packets are sent.
- 1-999
- Indiquez le nombre de paquets envoyés au système éloigné. Specify the number of packets that are sent to the remote system.
Délai d'attente (en secondes) (WAITTIME)Wait time (in seconds) (WAITTIME)
Indique le nombre de secondes d'attente du paquet de retour (écho) avant de déclarer ce transfert de paquet en échec. Specifies the number of seconds to wait for the return (echo) packet before declaring this packet transfer a failure.
- 1
- Le système attend 1 seconde. The system waits 1 second.
- 1-120
- Indiquez le nombre de secondes d'attente. Specify the number of second to wait.
Adresse internet locale (LCLINTNETA)
Indique l'adresse Internet locale de l'interface que les paquets sortants doivent utiliser. Toute adresse IP version 4 ou IP version 6 valide est acceptée. Une adresse Internet IP version 4 n'est pas valide si la partie identificateur de réseau ou la partie identificateur d'hôte de l'adresse a pour valeur uniquement des uns binaires ou uniquement des zéros binaires. Si l'adresse Internet est entrée à partir d'une ligne de commande, elle doit être placée entre apostrophes. Specifies the local internet address of the interface that the outbound packets are to use. Any valid IP Version 4 or IP Version 6 address will be accepted. An IP Version 4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
- *ANY
- Utilisez l'adresse Internet locale de n'importe quelle interface. Use any interface's local internet address.
- valeur-caractère
- Indiquez l'adresse Internet locale. Specify the local internet address.
Type de service (TOS)Type of service (TOS)
Indique le type de service à utiliser. Le type de service définit comment les hôtes et routeurs Internet doivent arbitrer entre débit, délai, fiabilité et coût. Specifies the type of service to be used. The type of service defines how the internet hosts and routers should make trade-offs between throughput, delay, reliability, and cost.
Remarque :Ce paramètre n'est pas utilisé si la résolution d'adresse IP version 6 est utilisée pour vérifier la connectivité avec un système éloigné. Remarque :This parameter is not used if IP Version 6 address resolution is used for verifying connectivity to a remote system.
- *NORMAL
- Le service normal est utilisé pour l'acheminement des données. Normal service is used for delivery of data.
- *MINDELAY
- Délai minimal signifie que l'acheminement rapide est important pour les données de cette connexion. Minimize delay means that prompt delivery is important for data on this connection.
- *MAXTHRPUT
- Débit maximal signifie qu'un débit de données élevé est important pour les données de cette connexion. Maximize throughput means that a high data rate is important for data on this connection.
- *MAXRLB
- Fiabilité maximale signifie qu'un effort accru pour garantir l'acheminement est important pour les données de cette connexion. Maximize reliability means that a higher level of effort to ensure delivery is important for data on this connection.
- *MINCOST
- Coût minimal signifie qu'un coût réduit est important pour les données de cette connexion. Minimize monetary cost means that lower cost is important for data on this connection.
Durée de vie IP (limite de sauts) (IPTTL)IP time to live (hop limit) (IPTTL)
Indique la valeur de durée de vie (time-to-live) du datagramme IP (paquet). Le datagramme n'est valide que pour le nombre de sauts de routeur indiqué par ce paramètre. La valeur de durée de vie agit comme un « compteur de sauts ». Le compteur est décrémenté chaque fois que le datagramme traverse un routeur ou une passerelle. Limiter la validité du datagramme par le nombre de sauts contribue à empêcher les boucles de routage sur Internet. Specifies the IP datagram (packet) time-to-live value. The datagram is valid only for the number of router hops specified by this parameter. The time-to-live value acts as a "hop counter". The counter is decremented each time the datagram passes through a router or gateway. Limiting the validity of the datagram by the number of hops helps to prevent internet routing loops.
Remarque : IP version 6 désigne ce paramètre sous le nom de limite de sauts. Note: IP Version 6 refers to this parameter as the hop limit.
- *DFT
- Use the default time-to-live value.
La valeur de durée de vie par défaut pour les adresses de multidiffusion est 1. La valeur de durée de vie par défaut pour toutes les autres adresses est indiquée par le paramètre IPTTL de la commande Modifier les attributs TCP/IP (CHGTCPA). The default time-to-live value for multicast addresses is 1. The default time-to-live value for all other addresses is specified by the IPTTL parameter of the Change TCP/IP Attributes (CHGTCPA) command.
- 1-255
- Indiquez une valeur de durée de vie du datagramme IP (paquet). Specify an IP datagram (packet) time-to-live value.
Exemples
Exemple 1 : Vérification de la connexion TCP/IP avec un nom d'hôte indiqué Example 1: Verify TCP/IP Connection with a Specified Host Name
VFYTCPCNN RMTSYS(IPHOST) PKTLEN(100) NBRPKT(10)
WAITTIME(15)
Cette commande tente d'envoyer 10 paquets de 100 octets chacun à un système éloigné (connu dans la configuration TCP/IP sous le nom IPHOST) via une liaison TCP/IP. Chaque transfert de paquet doit avoir lieu dans un délai de 15 secondes, sinon il échoue. This command attempts to send 10 packets of 100 bytes each to a remote system (known to the TCP/IP configuration as IPHOST) over a TCP/IP link. Each packet transfer must take place within 15 seconds or it fails.
Exemple 2 : Vérification de la connexion TCP/IP avec une adresse IP Example 2: Verify TCP/IP Connection with an IP Address
VFYTCPCNN RMTSYS(*INTNETADR) INTNETADR('128.1.1.10')
PKTLEN(100) NBRPKT(10) WAITTIME(15)
Cette commande tente d'envoyer 10 paquets de 100 octets chacun à un système éloigné via une interface TCP/IP. L'utilisateur représente RMTSYS par son adresse Internet 128.1.1.10, plutôt que par un nom de système attribué. Chaque transfert de paquet qui dure plus de 15 secondes échoue. This command attempts to send 10 packets of 100 bytes each to a remote system over a TCP/IP interface. The user represents the RMTSYS with its internet address 128.1.1.10, rather than with an assigned system name. Each packet transfer that takes more that 15 seconds fails.
Exemple 3 : Vérification de la connexion TCP/IP avec un nom d'hôte et une adresse d'interface locale précise Example 3: Verify TCP/IP Connection with Host Name and Using a Specific Local Interface Address
VFYTCPCNN RMTSYS(IPHOST) MSGMODE(*QUIET)
LCLINTNETA('9.2.2.3')
Cette commande tente d'envoyer 5 paquets (valeur par défaut) de 256 octets chacun (valeur par défaut) à un système éloigné via une interface TCP/IP précise ayant l'adresse locale 9.2.2.3. This command attempts to send 5 packets (default) of 256 bytes each (default) to a remote system over a specific TCP/IP interface that has the local address 9.2.2.3.
Comme MSGMODE(*QUIET) est indiqué, seuls les messages de sortie principaux sont affichés. Le paramètre d'interface est utile sur les hôtes à adresses multiples pour vérifier la connectivité réseau via une interface physique précise. Because MSGMODE(*QUIET) is specified, only the primary output messages are displayed. The interface parameter is useful on multi-homed hosts to verify network connectivity through a specific physical interface.
Exemple 4 : Vérification de la connexion TCP/IP avec une adresse IP version 6 Example 4: Verify TCP/IP Connection with an IP Version 6 Address
VFYTCPCNN RMTSYS(*INTNETADR)
INTNETADR('1:2:3:4:5:6:7:8')
Cette commande tente de vérifier la connexion TCP/IP d'un système éloigné ayant l'adresse locale 1:2:3:4:5:6:7:8. This command attempts to verify the TCP/IP connection of a remote system that has the local address of 1:2:3:4:5:6:7:8.
Exemple 5 : Vérification de la connexion TCP/IP avec un nom d'hôte défini IP version 6 indiqué Example 5: Verify TCP/IP Connection with a Specified IP Version 6 Defined Host Name
VFYTCPCNN RMTSYS(IPV6HOST)
Cette commande tente d'envoyer 5 paquets (valeur par défaut) de 256 octets chacun (valeur par défaut) à un système éloigné (connu dans la configuration TCP/IP IP version 6 sous le nom IPV6HOST) via une liaison TCP/IP. This command attempts to send 5 packets (default) of 256 bytes each (default) to a remote system (known to the IP Version 6 TCP/IP configuration as IPV6HOST) over a TCP/IP link.
La valeur par défaut de « Format de version d'adresse » est *CALC. La résolution de 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 sera l'adresse utilisée pour tenter de vérifier sa connexion via une liaison TCP/IP. 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 verify its connection over a TCP/IP link.
Exemple 6 : Vérification de la connexion TCP/IP avec utilisation explicite de la résolution de nom d'hôte IP version 6 Example 6: Verify TCP/IP Connection and Explicitly Use IP Version 6 Host Name Resolution
VFYTCPCNN RMTSYS(IPV6HOST) ADRVERFMT(*IP6)
Cette commande tente d'envoyer 5 paquets (valeur par défaut) de 256 octets chacun (valeur par défaut) à un système éloigné (connu dans la configuration TCP/IP IP version 6 sous le nom IPV6HOST) via une liaison TCP/IP. This command attempts to send 5 packets (default) of 256 bytes each (default) to a remote system (known to the IP Version 6 TCP/IP configuration as IPV6HOST) over a TCP/IP link.
Cet exemple diffère de l'exemple 5 en ce que seule une adresse IP version 6 résolue valide, pour IPV6HOST, sera utilisée pour tenter de vérifier sa connexion via une liaison TCP/IP. This example differs from example 5 in that only a valid IP version 6 resolved address, for IPV6HOST, will be used when attempting to verify its connection over a TCP/IP link.
Messages d'erreur
Messages *ESCAPE *ESCAPE Messages
- TCP3210
- Statistiques de vérification de connexion : &1 sur &2 réussies (&3 %). Connection verification statistics: &1 of &2 successful (&3 %).
- TCP3213
- Impossible d'atteindre le système éloigné Cannot reach remote system
- TCP3219
- L'adresse &1 ne correspond pas au format de version d'adresse &2. Address &1 does not match address version format &2.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.