Aller au contenu

CRTCTLHOST

Créer un contrôleur hôte SNA

En bref

La commande CRTCTLHOST permet de créer une description de contrôleur hôte SNA.

CRTCTLHOST se lit CRT (Créer) + CTLHOST. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTCTLHOST CTLD(…) LINKTYPE(…)

Paramètres

Astuce : dans une session 5250, tapez CRTCTLHOST 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 CRTCTLHOST permet de créer une description de contrôleur hôte SNA. Pour plus d'informations sur cette commande, reportez-vous au manuel Communications Configuration, SC41-5401.

Remarques :

  • Paramètres qui ne sont plus pris en charge à compter de la V5R3M0 : CNNLSTOUT, CNNLSTOUTE, IDLCCNNRTY, IDLCFRMRTY, IDLCRSPTMR, IDLCWDWSIZ
  • Paramètres qui ne sont plus pris en charge à compter de la V7R4M0 : ADJLNKSTN, ADPTADR, ANSNBR, AUTOCRTDEV, AUTODLTDEV, BEXROLE, CNNNBR, CNNPWD, CPSSN, DFTPKTSIZE, DFTWDWSIZE, DIALRTY, DSAP, HPR, HPRPTHSWT, LANACCPTY, LANACKFRQ, LANACKTMR, LANCNNRTY, LANCNNTMR, LANFRMRTY, LANINACTMR, LANMAXOUT, LANRSPTMR, LANWDWSTP, LGLCHLID, LINE, LINKPCL, MAXFRAME, NETLVL, NODETYPE, PREDIALDLY, RECONTACT, REDIALDLY, RMTCPNAME, RMTNETID, RVSCRG, SHM, SNBU, SSAP, STNADR, SWTLINSLCT, SWTLINLST, TMSGRPNBR, USRDFN1, USRDFN2, USRDFN3, USRFCL, USRGRPID, X25ACKTMR, X25FRMRTY, X25INACTMR, X25RSPTMR
  • Valeurs LINKTYPE qui ne sont plus prises en charge à compter de la V7R4M0 : *FR, *LAN, *SDLC, *X25

Restriction : Pour utiliser cette commande, vous devez disposer du droit spécial *IOSYSCFG (configuration de système d'entrée-sortie).

Paramètres

Mot-clé Description Valeurs possibles Remarques
CTLD Description de contrôleur Nom Obligatoire, positionnel 1
LINKTYPE Type de liaison *DLUR Obligatoire, positionnel 2
ONLINE En ligne à l'IPL *YES, *NO Facultatif
SWITCHED Connexion commutée *NO, *YES Facultatif
APPN APPN possible *YES, *NO Facultatif
SSCPID Identificateur SSCP 050000000000-05FFFFFFFFFF Facultatif
LCLEXCHID Identificateur d'échange local 05600000-056FFFFF, *LIND Facultatif
INLCNN Connexion initiale *DIAL, *ANS Facultatif
DIALINIT Initialisation numérotation *LINKTYPE, *IMMED, *DELAY Facultatif
MINSWTSTS APPN Etat minimal en commuté *VRYONPND, *VRYON Facultatif
TEXT Texte 'descriptif' Valeur caractère, *BLANK Facultatif
PRIDLUS Nom de DLUS primaire Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Nom de point de contrôle Nom de communication
Élément 2: Identificateur réseau Nom de communication, *NETATR
BKUDLUS Nom DLUS de secours Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Nom de point de contrôle Nom de communication
Élément 2: Identificateur réseau Nom de communication, *NETATR
DEPPUNAME Nom de PU dépendante Nom de communication, *NONE Facultatif
ACTTMR Délai d'activation 30-2550, 170 Facultatif
RECNNTMR Tempo Déconnex/Reconnex (T309) 1-2550, 170 Facultatif
DEV Unités connectées Values (jusqu'à 254 répétitions): Nom Facultatif
CODE Code caractères *EBCDIC, *ASCII Facultatif
SWTDSC Déconnexion commutée *NO, *YES Facultatif
DSCTMR Délai avant déconnexion Liste d'éléments Facultatif
Élément 1: Délai minimal de connexion 0-65535, 170
Élément 2: Délai de déconnexion 0-65535, 30
CMNRCYLMT Limites de rétablissement Valeurs uniques: *SYSVAL
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Nombre maximal d'essais 0-99, 2
Élément 2: Intervalle 0-120, 5
MSGQ File attente messages Valeurs uniques: *SYSVAL, *SYSOPR
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: File attente messages Nom
Qualificatif 2: Biblio Nom
AUT Droits Nom, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT Facultatif

Description de contrôleur (CTLD)

Ce paramètre est obligatoire.

Indique le nom de la description de contrôleur.

Type de liaison (LINKTYPE)

Indique le type de la ligne à laquelle le contrôleur est connecté.

Ce paramètre est obligatoire.

*DLUR

Ce contrôleur est utilisé pour les fonctions DLUR et n'est connecté à aucune ligne.

En ligne à l'IPL (ONLINE)

Indique si cet objet est mis en fonction automatiquement lors de la procédure de chargement initial (IPL).

*YES

Le contrôleur est automatiquement mis en fonction lors de l'IPL.

*NO

Le contrôleur n'est pas automatiquement mis en fonction lors de l'IPL.

Connexion commutée (SWITCHED)

Indique si ce contrôleur est connecté à une ligne commutée.

*NO

Le contrôleur est connecté à une ligne louée.

*YES

Le contrôleur est connecté à une ligne commutée.

APPN possible (APPN)

Indique si le système local utilise les fonctions APPN (Gestion de réseau paritaire) lorsqu'il communique avec ce contrôleur.

*YES

Le contrôleur est géré par APPN.

*NO

Le contrôleur n'est pas géré par APPN.

Identificateur SSCP (SSCPID)

Identificateur du SSCP (centre directeur des services du système) du système hôte.

Remarque :L'identificateur de point de contrôle de service système (SSCPID) représente une valeur hexadécimale à 12 chiffres, dont les deux premiers sont 05. Ce paramètre est obligatoire lorsque APPN(*NO) est indiqué.

identificateur-SSCP

Indiquez l'identificateur SSCP (12 caractères hexadécimaux).

Identificateur d'échange local (LCLEXCHID)

Indique le numéro utilisé par le système éloigné pour identifier le système local. REMARQUE :

Ce paramètre est requis si :

  1. des connexions parallèles doivent être établies entre un IBM i et un système hôte SNA ;
  2. si le support DLUR est utilisé (LINKTYPE(*DLUR)), en l'absence du paramètre DEPPUNAME.
*LIND

Le système utilise l'identificateur d'échange indiqué au paramètre EXCHID dans la description de ligne associée à cette description de contrôleur.

identificateur-échange-local

Indiquez un identificateur d'échange local sous forme d'un nombre hexadécimal à huit chiffres. Les trois premiers chiffres de ce nombre représentent le numéro de bloc et les cinq chiffres suivants représentent le système.

Connexion initiale (INLCNN)

Indique la méthode utilisée pour établir une connexion avec ce contrôleur.

*DIAL

Le système émet des appels sortants et répond à des appels entrants.

*ANS

L'IBM i établit la connexion lorsqu'il répond à un appel entrant provenant de ce contrôleur. Il répond à l'appel entrant reçu du contrôleur éloigné si toutes les conditions nécessaires sont remplies.

Initialisation numérotation (DIALINIT)

Indique la méthode utilisée pour la numérotation initiale sur une ligne commutée entre le système et le contrôleur éloigné.

*LINKTYPE

Le type de numérotation effectué dépend de la valeur du paramètre LINKTYPE. Pour tous les autres types de liaisons, la numérotation est différée par défaut.

*IMMED

La numérotation est effectuée dès la mise en fonction de la description du contrôleur.

*DELAY

La numérotation est différée jusqu'au lancement d'un travail faisant appel aux ressources du contrôleur éloigné.

APPN Etat minimal en commuté (MINSWTSTS)

Indique l'état minimal de la connexion commutée pour que le réseau APPN la considère comme un contrôleur disponible pour le routage.

*VRYONPND

APPN considère que le contrôleur est disponible pour l'acheminement s'il est à l'état Instance de mise en fonction, En fonction ou Actif.

*VRYON

APPN considère que le contrôleur est disponible pour l'acheminement uniquement s'il est à l'état En fonction ou Actif.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Nom de DLUS primaire (PRIDLUS)

Indique le NOM du serveur primaire de LU dépendante (DLUS) et l'identificateur de réseau.

Le nom a le format XXXXXXXX YYYYYYYY, le préfixe correspondant au nom du point de contrôle (CP) et le suffixe, à l'identificateur du réseau APPN (sous-réseau) où réside le DLUS éloigné. Si ce dernier est situé sur le même réseau que l'IBM i, seul le nom CP doit être défini par l'utilisateur, l'identificateur de réseau local indiqué dans les attributs de réseau servant d'ID réseau par défaut.

Nom réseau CP qualifié de réseau affecté au SSCP du DLUS éloigné avec lequel le contrôleur hôte DLUR doit communiquer en priorité. Si ce paramètre est précisé et que *DIAL est défini pour la connexion initiale du contrôleur DLUR, l'IBM i envoie d'abord la demande d'activation à ce serveur DLUS.

*NONE est la valeur par défaut. Cependant, si INLCNN(*DIAL) est défini pour la connexion initiale, ce paramètre devient obligatoire.

Elément 1 : Nom de DLUS primaire

*NONE

Aucun nom de CP primaire n'est précisé.

nom-DLUS-primaire

Indiquez le nom du DLUS primaire.

Elément 2 : ID réseau

*NETATR

La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.

ID-réseau

Indiquez l'ID réseau du DLUS.

Nom DLUS de secours (BKUDLUS)

Indique le nom du DLUS de secours et l'ID réseau.

Le nom a le format XXXXXXXX YYYYYYYY, le préfixe correspondant au nom du point de contrôle (CP) et le suffixe, à l'identificateur du réseau APPN (sous-réseau) où réside le DLUS éloigné. Si ce dernier est situé sur le même réseau que l'IBM i, seul le nom CP doit être défini par l'utilisateur, l'identificateur de réseau local indiqué dans les attributs de réseau servant d'ID réseau par défaut.

Nom réseau CP qualifié de réseau affecté au SSCP du DLUS éloigné avec lequel le contrôleur hôte DLUR doit communiquer en priorité. Si ce paramètre est précisé et que *DIAL est défini pour la connexion initiale du contrôleur DLUR, l'IBM i envoie d'abord la demande d'activation à ce serveur DLUS.

*NONE est la valeur par défaut. Cependant, si INLCNN(*DIAL) est défini pour la connexion initiale, ce paramètre devient obligatoire.

Elément 1 : Nom du DLUS de secours

*NONE

Aucun nom de CP de secours n'est précisé.

nom-DLUS-sauvegarde

Indiquez le NOM du DLUS (serveur de LU dépendante) de secours.

Elément 2 : ID réseau

*NETATR

La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.

ID-réseau

Indiquez l'ID réseau du DLUS de secours.

Nom de PU dépendante (DEPPUNAME)

Indique le nom d'unité physique (PU) dépendante utilisée pour le DLUR afin de renforcer la sécurité de la connexion.

Si ce nom est indiqué, il doit figurer dans toute demande d'activation (SNA ACTPU) envoyée par un noeud DLUS, sans quoi celle-ci sera rejetée.

Lorsque le noeud DLUR IBM i établit une session avec le noeud DLUS éloigné (INLCNN(*DIAL)), le nom de l'unité physique dépendante est envoyé au serveur DLUS, qui le renvoie dans la demande ACTPU.

Si le noeud DLUS éloigné établit une session avec le contrôleur hôte du DLUR via l'activation de définitions préalablement indiquées sur le noeud DLUS, il est nécessaire que les deux systèmes puissent coordonner avec précision les informations relatives au nom de PU dépendante et au nom de PU indiqués sur le serveur DLUS.

Si ce paramètre n'est pas indiqué, la vérification porte sur les paramètres de contrôleur suivants : ID d'échange local et nom de CP éloigné.

*NONE

Aucun nom de lieu n'est défini.

NOM-de-PU-dépendante

Indiquez le NOM de PU dépendante utilisé pour les applications DLUR.

30-2550 (secondes) (ACTTMR)

Délai durant lequel le système doit attendre la réception d'une réponse du noeud DLUS éloigné lorsqu'il tente d'établir une session avec ce noeud (connexion initiale *DIAL).

Ce paramètre est utilisé conjointement avec le paramètre CMNRCYLMT (Limites de rétablissement) et le délai d'activation. Pour chaque tentative (jusqu'à ce que le nombre limite soit atteint), une demande d'activation (dont le délai d'attente est déterminé par le délai d'activation) est émise. Le système attend l'expiration du délai d'activation défini avant de tenter l'activation suivante (s'il ne reçoit pendant ce temps aucune réponse ni aucun message d'erreur).

Le système utilise donc ces trois paramètres pour gérer les tentatives de connexion au DLUS primaire. Une fois le nombre maximal de tentatives atteint, ce nombre est réinitialisé et le système tente d'activer le DLUS de secours (si celui-ci est défini) jusqu'à ce que ce nombre soit de nouveau atteint. Si aucune tentative n'aboutit avec aucun des noeuds DLUS configurés, un message d'erreur est envoyé dans l'historique de messages de QSYSOPR, avec des options permettant de retenter toute la séquence d'activation.

170

Le délai par défaut est de 170 secondes.

valeur-délai-activation

Indiquez une valeur entre 30 et 2550 (secondes).

Tempo Déconnex/Reconnex (T309) (RECNNTMR)

Ce délai est utilisé en cas d'interruption de la session avec le noeud DLUS éloigné. Il s'agit du délai pendant lequel le support DLUR du système hôte attend que le noeud DLUS renvoie une demande d'activation au système hôte. Une fois ce délai expiré, le système hôte effectue les opérations suivantes :

  • Si la configuration du contrôleur hôte DLUR est INLCNN(*DIAL) :
    1. Le support DLUR effectue une seule tentative de reconnexion au noeud DLUS auquel le système était connecté lors de l'interruption de la session.
    2. Si cette tentative n'aboutit pas, un message d'erreur est consigné dans l'historique des erreurs de QSYSOPR avec une option de nouvelle tentative. Si cette option est choisie, la demande d'activation est envoyée de nouveau au DLUS primaire ou de secours configuré.
  • Si la configuration du contrôleur hôte DLUR est INLCNN(*ANS) :
    1. Le contrôleur DLUR attend une tentative d'activation provenant d'un noeud DLUS.
170

Le délai par défaut est de 170 secondes.

tempo-reconnexion

Indiquez une valeur entre 30 et 2550 (secondes).

Unités connectées (DEV)

Indique les noms des unités connectées à ce contrôleur. Les descriptions d'unités doivent déjà exister.

Un maximum de 254 unités peuvent être connectées à ce contrôleur.

Code caractères (CODE)

Indique le code utilisé sur la ligne : code *EBCDIC ou code *ASCII (American National Standard Code for Information Interchange).

*EBCDIC

Le code EBCDIC est utilisé.

*ASCII
Le code caractères ASCII est utilisé.

Déconnexion commutée (SWTDSC)

Indique si la connexion commutée au contrôleur est coupée lorsque la dernière unité est mise hors fonction.

*NO

La mise hors fonction de la dernière unité n'entraîne pas l'abandon de la connexion.

*YES

La connexion commutée est désactivée lorsque la dernière unité est mise hors fonction.

Délai avant déconnexion (DSCTMR)

Indique les options permettant de contrôler le temps d'attente (en secondes) avant la coupure d'une connexion sans activité ou bien le délai précédant la déconnexion automatique. Si vous ne souhaitez pas que la ligne soit coupée, indiquez la valeur *NO au paramètre SWTDSC.

Elément 1 : Durée minimale de connexion

170

Une connexion est interrompue après 170 secondes d'inactivité.

délai-avant-déconnexion:

Indiquez le temps d'attente avant la déconnexion. Les valeurs admises sont comprises entre 0 et 65535 secondes.

Elément 2 : Délai avant déconnexion

30

Le délai précédant la déconnexion est de 30 secondes.

délai-déconnexion

Indiquez une valeur afin de différer la coupure de liaison jusqu'à la fin de la dernière session du contrôleur. Les valeurs admises sont comprises entre 0 et 65535 secondes.

Limites de rétablissement (CMNRCYLMT)

Indique le nombre de tentatives de rétablissement effectuées par le système avant l'envoi d'un message d'interrogation à l'opérateur système. Précise également le délai (en minutes) observé avant l'envoi d'un message d'interrogation à l'opérateur système pour lui indiquer que le nombre maximal de tentatives de rétablissement est atteint.

Elément 1 : Nombre maximal de tentatives de rétablissement

2

Deux tentatives de rétablissement sont effectuées au cours de l'intervalle de temps indiqué.

*SYSVAL
La valeur système QCMNRCYLMT utilisée.
nombre-maximal

Indiquez le nombre de tentatives de rétablissement de second niveau à effectuer. Les valeurs admises sont comprises entre 0 et 99.

Elément 2 : Délai de rétablissement

5

Le nombre de tentatives de rétablissement indiqué est effectué dans un intervalle de 5 minutes.

intervalle

Indiquez un intervalle de temps (en minutes) pendant lequel le nombre de tentatives de rétablissement de second niveau indiqué est effectué. Les valeurs admises sont comprises entre 0 et 120. Si la valeur indiquée pour nombre-maximal-essais est différente de 0, et que cette invite a pour valeur 0, le nombre de tentatives de rétablissement est illimité.

Pour plus d'informations sur le rétablissement des communications, reportez-vous au manuel Communications Management, SC41-5406.

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages vers laquelle sont envoyés les messages d'exploitation.

*SYSVAL
Les messages sont envoyés dans la file d'attente de messages définie dans la valeur système QCFGMSGQ.
*SYSOPR
Les messages sont envoyés dans la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

Qualificatif 1 : File attente messages

nom
Indiquez le nom de la file d'attente de messages dans laquelle sont envoyés les messages d'exploitation.

Qualificatif 2 : Biblio

nom
Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

Pour plus d'informations sur l'utilisation de cette commande, reportez-vous au manuel Communications Management, SC41-5406.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*CHANGE
L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.
*ALL
L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.
*USE
L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).
*EXCLUDE
L'utilisateur n'a pas accès à l'objet.
*LIBCRTAUT
Le système détermine les droits sur l'objet à l'aide de la valeur précisée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.
nom
Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTCTLHOST   CTLD(HOST1)  LINKTYPE(*DLUR) SWITCHED(*YES) APPN(*YES)
             PRIDLUS(HOST1 *NETATR) BKUDLUS(*NONE) DEPPUNAME(ASDF)

Cette commande crée un contrôleur hôte DLUR.

Messages d'erreur

Messages *ESCAPE

CPF26BB
Membre de contrôleur sans fil non modifié.
CPF26BC
Membre de contrôleur sans fil non affiché.
CPF26BD
Poste groupe codes barres non supprimé du membre de contrôleur sans fil.
CPF26BE
Poste groupe PTC non supprimé du membre de contrôleur sans fil.
CPF26BF
Fin anormale du programme QZXCINZ. Reportez-vous aux messages précédents.
CPF26B3
Le membre de ligne sans fil n'a pas été ajouté.
CPF26B4
Le membre de ligne sans fil n'a pas été modifié.
CPF26B5
Le membre de ligne sans fil n'a pas été affiché.
CPF26B8
Le membre du contrôleur sans fil n'a pas été ajouté.
CPF2716
Description de contrôleur &1 non créée.

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