Aller au contenu

APING

Vérifier connexion APPC

Verify APPC Connection

En bref

La commande VFYAPPCCNN, également appelée APING, permet d'échanger des paquets de données entre le lieu local et le lieu éloigné indiqué via des communications APPC, et de mesurer la durée de l'aller-retour de chaque itération d'échange de paquet de données.

Syntaxe minimale

APING RMTLOCNAME(…)

Paramètres

  • RMTLOCNAME Lieu éloigné obligatoire
  • MODE Mode
  • RMTUSER ID utilisateur éloigné
  • RMTPWD Mot de passe éloigné
  • MSGMODE Mode de message Message mode
  • PKTLEN Longueur du paquet (en octets) Packet length (in bytes)
  • NBRITER Nombre d'itérations Number of iterations
  • NBRPKT Nombre de paquets Number of packets
  • ECHO Echo
  • WAITTIME Délai d'attente (en secondes)

Astuce : dans une session 5250, tapez APING 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 VFYAPPCCNN, également appelée APING, permet d'échanger des paquets de données entre le lieu local et le lieu éloigné indiqué via des communications APPC, et de mesurer la durée de l'aller-retour de chaque itération d'échange de paquet de données.

Pour que cette fonction puisse être utilisée, APINGD , la partie cible de cette dernière, doit être lancé sur le lieu éloigné spécifié.

Paramètres

Mot-clé Description Valeurs possibles Remarques
RMTLOCNAME Lieu éloigné Valeur caractère Obligatoire, positionnel 1
MODE Mode Nom de communication, *NETATR Facultatif, positionnel 2
RMTUSER ID utilisateur éloigné Valeur caractère, *NONE, *CURRENT Facultatif
RMTPWD Mot de passe éloigné Valeur caractère, *NONE Facultatif
MSGMODE Message mode *VERBOSE, *QUIET Facultatif
PKTLEN Longueur du paquet (en octets)Packet length (in bytes) 0-32763, 100 Facultatif
NBRITER Nombre d'itérationsNumber of iterations 1-32767, 2 Facultatif
NBRPKT Nombre de paquetsNumber of packets 1-32767, 1 Facultatif
ECHO Echo *YES, *NO Facultatif
WAITTIME Délai d'attente (en secondes) 2-3600, 10, *NOMAX, *NOWAIT Facultatif

Lieu éloigné (RMTLOCNAME)

Indique le lieu éloigné auquel vous voulez vous connecter. Spécifiez un nom de lieu éloigné en utilisant le format nnnnnnnn.cccccccc, où nnnnnnnn est l'ID réseau et cccccccc, le nom du lieu éloigné. Si vous indiquez uniquement le nom du lieu éloigné, l'attribut du réseau de l'ID local du réseau (LCLNETID) sera utilisé comme valeur pour l'ID réseau.

Mode (MODE)

Indique le nom du mode à utiliser pour la conversation APPC.

*NETATR
Le mode défini dans les attributs du réseau est utilisé.
nom-mode
Indiquez un nom de mode ou spécifiez BLANK afin de préciser un nom de mode composé de huit blancs.

Remarque :SNASVCMG et CPSVCMG sont des noms réservés. Vous ne pouvez pas les utiliser.

ID utilisateur éloigné (RMTUSER)

Indique l'ID utilisateur pour le système cible. Si un ID utilisateur est spécifié pour ce paramètre et que la fonction de sécurité par mot de passe est active sur le système cible, vous ne pouvez pas indiquer la valeur RMTPWD(*NONE).

*NONE
Aucun ID utilisateur n'est envoyé. Si la configuration de la fonction de sécurité sur le système cible requiert un ID utilisateur, la commande n'aboutira pas.
*CURRENT
L'ID utilisateur (utilisateur en session) du travail utilisant cette commande est envoyé.
valeur-alphanumérique
Indiquez un ID utilisateur existant sur le système cible. Si un ID utilisateur est spécifié et que la fonction de sécurité par mot de passe est active sur le système cible, vous devez indiquer un mot de passe.

Mot de passe éloigné (RMTPWD)

Indique le mot de passe envoyé au système cible.

*NONE
Le système n'envoie pas de mot de passe. Si un ID utilisateur est indiqué au paramètre RMTUSER et que la fonction de sécurité par mot de passe est active sur le système cible, la commande n'aboutira pas.
valeur-alphanumérique
Indiquez un mot de passe envoyé au système cible pour vérifier l'ouverture de session à l'aide de l'ID utilisateur indiqué au paramètre RMTUSER. Le mot de passe peut être remplacé ou non via la ligne de transmission suivant que le système éloigné prend en charge ou non les substitutions de mot de passe.

Message mode (MSGMODE)

Indique la quantité d'informations affichées par la commande.

*VERBOSE
Affiche un message de vérification après chaque itération.
*QUIET
Affiche uniquement les messages de début et les messages récapitulatifs.

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

Indique la taille (en octets) des paquets échangés entre le système local et le système éloigné.

100
La taille du paquet est de 100 octets.
0-32763
Indiquez le nombre d'octets de chaque paquet.

Nombre d'itérations (NBRITER)Number of iterations (NBRITER)

Indique un nombre d'itérations. Au cours de chacune d'elles, le nombre de paquets de données indiqué est échangé entre le système local et le système éloigné.

2
Deux itérations sont effectuées.
1-32767
Indiquez un nombre d'itérations.

Nombre de paquets (NBRPKT)Number of packets (NBRPKT)

Indique le nombre de paquets que le système local doit envoyer pour chaque itération avant d'accorder au système cible la permission d'envoyer des données.

1
Un paquet est envoyé pour chaque itération.
1-32767
Indiquez le nombre de paquets à envoyer pour chaque itération.

Echo (ECHO)

Indique si le lieu éloigné doit renvoyer les paquets par écho au lieu local.

*YES
Le lieu éloigné renvoie les paquets par écho au lieu local.
*NO
Les paquets sont envoyés uniquement du lieu local au lieu éloigné. Ils ne sont pas renvoyés par écho au lieu local.

Délai d'attente (en secondes) (WAITTIME)

Indique le délai d'attente (en secondes) du retour (écho) qui peut s'écouler avant de déclarer que le lieu éloigné ne répond pas.

10
Le système attend 10 secondes.
*NOMAX
Le système attend indéfiniment.
*NOWAIT
Le système répond immédiatement s'il dispose d'une connexion.
2-3600
Indiquez le nombre de seconde à attendre.

Exemples

Exemple 1 : vérification de connexion APPC

VFYAPPCCNN   RMTLOCNAME(RPCNET.CHICAGO)  NBRITER(3)  NBRPKT(4)
             PKTLEN(500)

Cette commande permet d'échanger quatre paquets de données de 500 octets dans chacune de trois itérations ayant comme lieu éloigné CHICAGO et l'identificateur de réseau RPCNET. Le mode utilisé par défaut est pris dans l'attribut de réseau DFTMODE. Le SGMODE(*VERBOSE) par défaut ayant été choisi, chaque itération produira un message d'information dans l'historique du travail, indiquant le temps de réponse de l'itération.

Exemple 2 : utilisation de la commande alias APING

APING   RMTLOCNAME(RPCNET.CHICAGO)  NBRITER(3)  NBRPKT(4)  PKTLEN(500)

Cette commande est similaire à celle décrite dans l'exemple 1 ci-dessus.

Exemple 3 : utilisation de la commande APING associée à un délai de réponse

APING   RMTLOCNAME(RPCNET.CHICAGO)  WAITTIME(20)

Cette commande permet de vérifier la connexion avec le lieu éloigné CHICAGO portant l'identificateur de réseau RPCNET. Le temps de réponse maximum du lieu éloigné est de 20 secondes.

Messages d'erreur

Messages *ESCAPE

CPF91CC
La commande a échoué.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.