Aller au contenu

RUNLPDA

Lancer LPDA-2

En bref

La commande RUNLPDA (Lancer LPDA-2) vous permet de lancer une commande opérationnelle LPDA-2 (Aide au diagnostic de la liaison-2) sur le DCE (Equipement de terminaison de circuit de données) local ou éloigné.

RUNLPDA se lit RUN (Exécuter) + LPDA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RUNLPDA LINE(…) OPTION(…)

Paramètres

Astuce : dans une session 5250, tapez RUNLPDA 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 RUNLPDA (Lancer LPDA-2) vous permet de lancer une commande opérationnelle LPDA-2 (Aide au diagnostic de la liaison-2) sur le DCE (Equipement de terminaison de circuit de données) local ou éloigné. La commande RUNLPDA peut être utilisée pour :

  • Etablir une connexion au réseau téléphonique commuté ou mettre fin à cette connexion.
  • Ouvrir ou fermer le contact à relais dans un coupleur.
  • Déterminer si un contact à relais est ouvert ou fermé.
  • Déterminer si un capteur interne est traversé par du courant électrique.
  • Modifier la vitesse de transmission d'un DCE pour qu'elle soit à plein régime ou au ralenti.

Le résultat de la commande RUNLPDA est retourné sous forme de message.

Restrictions :

  1. La commande RUNLPDA n'est admise que pour les DCE LPDA-2 analogiques connectés à une ligne SDLC spécialisée.
  2. Cette commande est livrée avec le droit public *EXCLUDE et les profils utilisateur QPGMR, QSYSOPR, QSRV ou QSRVBAS disposent de droits privés pour utiliser cette commande.

Paramètres

Mot-clé Description Valeurs possibles Remarques
LINE Ligne Nom Obligatoire, positionnel 1
OPTION Option *CALL, *DSC, *SETSPEED, *CONTSENSE, *CONTOPER Obligatoire, positionnel 2
LCLDCEADR Adresse DCE local 01-FB, *LCL Facultatif
RMTDCEADR Adresse DCE éloigné 01-FB, *NONE, *ANY Facultatif
TELNBR Numéro de téléphone Valeurs uniques: *STORED
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Numéro 1 Valeur caractère
Élément 2: Numéro 2 Valeur caractère
CONTACT Contact à relais *OPEN, *CLOSE Facultatif
SPEED Vitesse de transmission *FULL, *BACKUP Facultatif
DTEPORT Port DTE *ALL, A, B, C, D Facultatif
DCERTY Nb d'essais DCE *NO, *YES Facultatif

Ligne (LINE)

Indique le nom de la ligne SDLC spécialisée qui est associée au DCE analogique sur lequel la commande opérationnelle LPDA-2 doit être lancée. Si *CALL est indiqué à l'inviteOption (paramètre OPTION), la ligne doit être en fonction mais inactive. Si *CONTOPER, *CONTSENSE, *DSC ou *SETSPEED est indiqué au paramètre OPTION, la ligne doit être soit en fonction, soit active.

Ce paramètre est obligatoire.

Option (OPTION)

Indique la commande opérationnelle LPDA-2 qui est exécutée.

Ce paramètre est obligatoire.

Les commandes d'établissement du contact, de détection du contact et de définition de vitesse de transmission peuvent être exécutées sur un DCE local ou éloigné.

Pour exécuter l'une de ces commandes sur un DCE local, procédez comme suit :

  • Indiquez l'adresse du DCE local dans la zone Adresse DCE local (paramètre LCLDCEADR).
  • Indiquez la valeur *NONE dans la zone Adresse DCE éloigné (paramètre RMTDCEADR).

Pour exécuter l'une de ces commandes sur un DCE éloigné :

  • Indiquez, au paramètre LCLDCEADR, l'adresse du DCE local auquel est connecté le DCE éloigné.
  • Indiquez l'adresse du DCE éloigné au paramètre RMTDCEADR.

Remarque :Si le DCE local est configuré en tant que station secondaire point à point ou tributaire multipoint, les commandes LPDA-2 ne sont pas envoyées au DCE éloigné.

Les valeurs possibles sont les suivantes :

*CALL
La commande d'appel externe est exécutée ; elle permet d'établir une connexion entre un DCE local et un DCE éloigné via un réseau téléphonique commuté. Cette valeur n'est admise que si les conditions suivantes sont réunies :
  • Le DCE local et le DCE éloigné possèdent tous les deux des coupleurs à deux fils ou à quatre fils.
  • La ligne indiquée dans la zone Ligne (paramètre LINE) est en fonction, mais inactive.
*CONTOPER
La commande d'établissement du contact est exécutée ; elle permet d'ouvrir ou de fermer le contact à relais dans le coupleur, en fonction de la valeur indiquée dans la zone Contact à relais (paramètre CONTACT). Cette valeur n'est admise que si un coupleur à deux fils est installé sur le DCE sur lequel cette commande est exécutée.
*CONTSENSE
La commande de détection du contact est exécutée ; elle permet de signaler si le contact à relais du coupleur est ouvert ou fermé et si le capteur interne est traversé par du courant électrique. Cette option n'est admise que si un coupleur à deux fils est installé sur le DCE sur lequel cette commande est exécutée.
*DSC
La commande de déconnexion est exécutée ; elle permet de mettre fin à la connexion au réseau téléphonique commuté établie entre le DCE local et le DCE éloigné. Si vous indiquez cette valeur, *NONE ne peut pas être indiqué dans la zone Adresse DCE éloigné (paramètre RMTDCEADR).
*SETSPEED
La commande de définition de vitesse de transmission est exécutée ; elle permet de modifier la vitesse de transmission du DCE pour qu'elle soit à plein régime ou au ralenti, selon la valeur spécifiée dans la zone Vitesse de transmission (paramètre SPEED). Pour les configurations de DCE à ports multiples, dans lesquelles la vitesse de transmission des divers ports DTE peut être différente, utilisez la zone Port DTE (paramètre DTEPORT) pour indiquer le port.

Remarque :La commande de définition de vitesse de transmission peut ne pas modifier cette vitesse. Son action dépend des options de configuration choisies pour le DCE. Pour de plus amples informations, consultez la documentation relative au DCE.

Adresse DCE local (LCLDCEADR)

Indique l'adresse hexadécimale du DCE local. Consultez la documentation relative au DCE pour obtenir de plus amples informations sur l'adressage.

Les valeurs possibles sont les suivantes :

*LCL
X'01' est utilisé pour l'adresse.
adresse-DCE-local
Indiquez l'adresse du DCE local. Les valeurs admises sont comprises entre X'01' et X'FB'.

Adresse DCE éloigné (RMTDCEADR)

Indique l'adresse hexadécimale du DCE éloigné sur lequel la commande opérationnelle LPDA-2 doit être exécutée.

Les valeurs possibles sont les suivantes :

*NONE
X'00' est utilisé comme adresse : cela signifie que la commande LPDA-2 doit être exécutée sur le DCE local. Vous ne pouvez pas indiquer *NONE à ce paramètre si vous avez indiqué *DSC dans la zone Option (paramètre OPTION).
*ANY
X'FD' est utilisé comme adresse. Indiquez cette valeur dans les cas suivants :
  • La commande LPDA-2 doit être exécutée sur n'importe quel DCE éloigné connecté au DCE local.
  • Vous ne connaissez pas l'adresse du DCE éloigné d'une ligne point à point.
  • Pour exécuter la commande opérationnelle LPDA-2 sur tous les DCE tributaires d'une ligne multipoint. Dans ce cas, aucune réponse détaillée n'est reçue.
adresse-DCE-éloigné
Indiquez l'adresse du DCE éloigné. Les valeurs admises sont comprises entre X'01' et X'FB'.

Numéro de téléphone (TELNBR)

Indique le ou les numéro(s) de téléphone composé(s) par le DCE local pour établir une connexion avec le DCE éloigné. Ce paramètre n'est admis que si *CALL est indiqué dans la zone Option (paramètre OPTION).

Les valeurs possibles sont les suivantes :

*STORED
Le ou les numéro(s) de téléphone mémorisés dans le DCE local lors de sa configuration sont utilisés.
numéro-téléphone
Si le DCE local dispose d'un coupleur à deux fils, indiquez un numéro de téléphone. S'il dispose d'un coupleur à quatre fils, indiquez deux numéros de téléphone. Seuls les caractères numériques sont traités par la commande LPDA-2 ; toutefois, vous pouvez également entrer des caractères alphabétiques afin de faciliter leur lecture. Vous pouvez utiliser une virgule (,) pour indiquer au DCE qu'il doit marquer une pause lors de la composition du numéro.

Contact à relais (CONTACT)

Indique si le contact à relais d'un coupleur à deux fils doit être ouvert ou fermé. Ce paramètre est obligatoire si *CONTOPER est indiqué dans la zone Option (paramètre OPTION).

Les valeurs possibles sont les suivantes :

*OPEN
Le contact à relais est ouvert.
*CLOSE
Le contact à relais est fermé.

Vitesse de transmission (SPEED)

Indique la vitesse de transmission souhaitée pour le DCE. Ce paramètre est obligatoire si *SETSPEED est indiqué dans la zone Option (paramètre OPTION).

Les valeurs possibles sont les suivantes :

*FULL
Les transmissions s'effectuent à vitesse normale.
*BACKUP
Les transmissions s'effectuent à vitesse réduite.

Port DTE (DTEPORT)

Indique le port DTE du DCE local ou éloigné pour lequel la vitesse de transmission est modifiée. Ce paramètre n'est admis que si *SETSPEED est indiqué dans la zone Option (paramètre OPTION) et ne s'applique que pour les DCE à ports multiples qui n'utilisent pas l'option de configuration multiadresse.

Les valeurs possibles sont les suivantes :

*ALL
La vitesse globale du DCE est modifiée. Consultez la documentation relative au DCE pour obtenir des informations sur les effets de la modification de la vitesse globale de transmission des ports individuels.
A
La vitesse de transmission du port A est modifiée.
B
La vitesse de transmission du port B est modifiée.
C
La vitesse de transmission du port C est modifiée.
D
La vitesse de transmission du port D est modifiée.

Nb d'essais DCE (DCERTY)

Indique si le DCE local renvoie la commande LPDA-2 au DCE éloigné s'il ne reçoit aucune réponse de sa part. Aucun autre essai ne sera effectué si *CALL ou *DSC est indiqué dans la zone Option (paramètre OPTION).

Les valeurs possibles sont les suivantes :

*NO
Aucun autre essai n'est effectué.
*YES
Un nouvel essai est effectué.

Exemples

Exemple 1 : Etablissement d'une connexion au réseau téléphonique commuté

RUNLPDA   LINE(SDLCLINE)  OPTION(*CALL)  LCLDCEADR(*LCL)
          RMTDCEADR(*NONE)  TELNBR(*STORED)

Permet d'exécuter la commande d'appel externe. Le DCE local dont l'adresse est X'01' (*LCL) sur la ligne SDLCLINE compose les numéros de téléphone mémorisés dans le DCE local.

Exemple 2 : Etablissement d'une connexion au réseau téléphonique commuté

RUNLPDA   LINE(SDLCLINE)  OPTION(*CALL)
          LCLDCEADR(*LCL)  RMTDCEADR(*NONE)
          TELNBR('9, 1-507-555-1212' '9, 1 (507) 555-1313')

Permet d'exécuter la commande d'appel externe. Le DCE local compose les deux numéros spécifiés au paramètre TELNBR. La virgule (,) indique une pause dans la numérotation. Les autres caractères non numériques sont ignorés mais sont admis afin de faciliter la lecture.

Exemple 3 : Déconnexion d'une connexion au réseau téléphonique commuté

RUNLPDA   LINE(SDLCLINE)  OPTION(*DSC)
          LCLDCEADR(10)  RMTDCEADR(*ANY)

Permet d'exécuter la commande de déconnexion. Le DCE local dont l'adresse est X'10' déconnecte du réseau téléphonique commuté.

Exemple 4 : Fermeture du contact à relais dans le DCE local

RUNLPDA   LINE(SDLCLINE)  OPTION(*CONTOPER)  LCLDCEADR(02)
          RMTDCEADR(*NONE)  CONTACT(*CLOSE)

Permet d'exécuter la commande d'établissement du contact. Le DCE local dont l'adresse est X'02' ferme le contact à relais dans son coupleur à deux fils.

Exemple 5 : Rapport d'état du contact à relais

RUNLPDA   LINE(SDLCLINE)  OPTION(*CONTSENSE)
          LCLDCEADR(01)  RMTDCEADR(04)

Permet d'exécuter la commande de détection du contact. Un message indique l'état du contact à relais dans le DCE éloigné dont l'adresse est X'04' (l'adresse correcte du DCE local doit être spécifiée au paramètre mustLCLDCEADR).

Exemple 6 : Modification de la vitesse de transmission

RUNLPDA   LINE(SDLCLINE)  OPTION(*SETSPEED)  LCLDCEADR(05)
          RMTDCEADR(*NONE)  SPEED(*BACKUP)  DTEPORT(B)

Permet d'exécuter la commande de définition de la vitesse de transmission. La vitesse de transmission définie pour le port B du DCE local dont l'adresse est X'05' passe à la vitesse réduite.

Messages d'erreur

Messages *ESCAPE

CPF1BAA
La commande LPDA-2 ne peut être lancée en mode RTCS.
CPF1BAB
Commande LPDA-2 non admise par le DCE cible.
CPF1BAC
Dispositif requis non installé.
CPF1BAD
Commande LPDA-2 incompatible avec la configuration du DCE.
CPF1BA1
La description de ligne &1 n'existe pas.
CPF1BA2
Ligne &1 inactive ou hors fonction.
CPF1BA3
La ligne &1 est une ligne secondaire active.
CPF1BA4
Défaillance de la ligne &1 lors du traitement de la commande RUNLPDA.
CPF1BA5
Aucune réponse reçue pour la commande LPDA-2.
CPF1BA6
Impossible de lancer la commande LPDA-2 pour la ligne &1.
CPF1BA7
Aucune mémoire tampon disponible pour les données RUNLPDA.
CPF1BA8
Commande LPDA-2 déjà active sur la ligne &1.
CPF1BBA
Tonalité de réponse continue à la suite du premier appel.
CPF1BBB
Tonalité de réponse continue à la suite du second appel.
CPF1BBC
Aucun signal de ligne au cours de la connexion commutée.
CPF1BBD
Aucune tonalité initiale.
CPF1BBE
Aucune tonalité après la pause.
CPF1BBF
DCE éloigné occupé.
CPF1BB0
Coupleur non installé sur le DCE local.
CPF1BB1
Coupleur non opérationnel.
CPF1BB2
Commande LPDA-2 incompatible avec les options de configuration.
CPF1BB3
Numéro de téléphone incorrect.
CPF1BB5
Connexion commutée déjà active.
CPF1BB6
Un seul numéro de téléphone est admis.
CPF1BB7
Deux numéros de téléphone nécessaires.
CPF1BB8
Aucune réponse du DCE éloigné lors du premier appel.
CPF1BB9
Aucune réponse du DCE éloigné lors du second appel.
CPF1BDA
Incident lors du traitement de la commande RUNLPDA.
CPF1BDB
Erreur de traitement interne.
CPF1BDC
Dispositif obligatoire non opérationnel.
CPF1BDD
Délai de réponse dépassé.
CPF1BDE
DCE occupé. Impossible de lancer la commande LPDA-2.
CPF1BDF
L'état de la ligne ne permet pas d'appeler la commande LPDA-2.
CPF1BD3
Traitement de la commande LPDA-2 précédente en cours par le DCE.
CPF1BD5
Impossible d'envoyer la commande au DCE éloigné.
CPF1BD6
Description de ligne &1 autre que ligne spécialisée *SDLC.
CPF1BD8
La demande a échoué. Fonction SST active.
CPF1BD9
La commande RUNLPDA n'accepte pas les lignes commutées.
CPF1B85
Coupleur à deux fils non installé.
CPF1B86
Coupleur non installé.
CPF1B87
Impossible de modifier la vitesse de transmission.
CPF1B88
Port DTE choisi non compatible avec la configuration.
CPF1B94
Le DCE local n'a reçu aucune réponse du DCE éloigné.
CPF1B95
Accès à la description de ligne &1 non autorisé.
CPF1B97
Réponse reçue dans un format incorrect.
CPF1B98
Une réponse comportant une séquence de contrôle de trame erronée a été reçue.
OFC8DB7
Echec du traitement interne.

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