CHGCTLHOST
Modifier contrôleur hôte SNA
En bref
La commande CHGCTLHOST permet de modifier une description de contrôleur hôte SNA.
CHGCTLHOST se lit CHG
(Modifier) + CTLHOST.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGCTLHOST CTLD(…)
Paramètres
-
CTLDDescription de contrôleur obligatoire -
ONLINEEn ligne à l'IPL -
APPNAPPN possible -
CODECode caractères -
SSCPIDIdentificateur SSCP -
INLCNNConnexion initiale -
DIALINITInitialisation numérotation -
SWTDSCDéconnexion commutée -
DSCTMRDélai avant déconnexion -
MINSWTSTSAPPN Etat minimal en commuté -
CMNRCYLMTLimites de rétablissement -
MSGQFile attente messages -
TEXTTexte 'descriptif' -
PRIDLUSNom de DLUS primaire -
BKUDLUSNom DLUS de secours -
ACTTMRDélai d'activation -
RECNNTMRTempo Déconnex/Reconnex (T309)
Astuce : dans une session 5250, tapez CHGCTLHOST 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 CHGCTLHOST permet de modifier une description de contrôleur hôte SNA.
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 : ACTSNBU, 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, LINKPCL, MAXFRAME, NETLVL, NODETYPE, PREDIALDLY, RECONTACT, REDIALDLY, RMTCPNAME, RMTNETID, RVSCRG, SSAP, STNADR, SWTLINSLCT, SWTLINLST, TMSGRPNBR, USRDFN1, USRDFN2, USRDFN3, USRFCL, USRGRPID, X25ACKTMR, X25FRMRTY, X25INACTMR, X25RSPTMR
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, clé, positionnel 1 |
| ONLINE | En ligne à l'IPL | *SAME, *YES, *NO | Facultatif |
| APPN | APPN possible | *SAME, *YES, *NO | Facultatif |
| CODE | Code caractères | *SAME, *EBCDIC, *ASCII | Facultatif |
| SSCPID | Identificateur SSCP | 050000000000-05FFFFFFFFFF, *SAME, *NONE | Facultatif |
| INLCNN | Connexion initiale | *SAME, *ANS, *DIAL | Facultatif |
| DIALINIT | Initialisation numérotation | *SAME, *LINKTYPE, *IMMED, *DELAY | Facultatif |
| SWTDSC | Déconnexion commutée | *SAME, *YES, *NO | Facultatif |
| DSCTMR | Délai avant déconnexion | Valeurs uniques: *SAME Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Délai minimal de connexion | 0-65535 | ||
| Élément 2: Délai de déconnexion | 0-65535, *SAME | ||
| MINSWTSTS | APPN Etat minimal en commuté | *SAME, *VRYONPND, *VRYON | Facultatif |
| CMNRCYLMT | Limites de rétablissement | Valeurs uniques: *SAME, *SYSVAL Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Nombre maximal d'essais | 0-99 | ||
| Élément 2: Intervalle | 0-120 | ||
| MSGQ | File attente messages | Valeurs uniques: *SAME, *SYSVAL, *SYSOPR Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File attente messages | Nom | ||
| Qualificatif 2: Biblio | Nom | ||
| TEXT | Texte 'descriptif' | Valeur caractère, *SAME, *BLANK | Facultatif |
| PRIDLUS | Nom de DLUS primaire | Valeurs uniques: *SAME, *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: *SAME, *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 | ||
| ACTTMR | Délai d'activation | 30-2550, *SAME | Facultatif |
| RECNNTMR | Tempo Déconnex/Reconnex (T309) | 1-2550, *SAME | Facultatif |
Description de contrôleur (CTLD)
Ce paramètre est obligatoire.
Indique le nom de la description de contrôleur.
En ligne à l'IPL (ONLINE)
Indique si cet objet est mis en fonction automatiquement lors de la procédure de chargement initial (IPL).
- *SAME
La valeur reste inchangée.
- *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.
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.
- *SAME
La valeur reste inchangée.
- *YES
Le contrôleur est géré par APPN.
- *NO
Le contrôleur n'est pas géré par APPN.
Code caractères (CODE)
Indique le code utilisé sur la ligne : code *EBCDIC ou code *ASCII (American National Standard Code for Information Interchange).
- *SAME
La valeur reste inchangée.
- *EBCDIC
Le code EBCDIC est utilisé.
- *ASCII
- Le code caractères ASCII est utilisé.
Identificateur SSCP (SSCPID)
Identificateur du SSCP (centre directeur des services du système) du système hôte.
- *SAME
La valeur reste inchangée.
- *NONE
Aucun identificateur SSCP n'est indiqué.
- identificateur-SSCP
Indiquez l'identificateur SSCP (12 caractères hexadécimaux).
Connexion initiale (INLCNN)
Indique la méthode utilisée pour établir une connexion avec ce contrôleur.
- *SAME
La valeur reste inchangée.
- *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é.
- *SAME
La valeur reste inchangée.
- *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é.
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.
- *SAME
La valeur reste inchangée.
- *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
- *SAME
La valeur reste inchangée.
- 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
- *SAME
La valeur reste inchangée.
- 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.
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.
- *SAME
La valeur reste inchangée.
- *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.
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
- *SAME
La valeur reste inchangée.
- *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
- 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.
- *SAME
La valeur reste inchangée.
- *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.
Texte 'descriptif' (TEXT)
Texte décrivant brièvement l'objet.
- *SAME
La valeur reste inchangée.
- *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
- *SAME
La valeur reste inchangée.
- *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
- *SAME
La valeur reste inchangée.
- *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
- *SAME
La valeur reste inchangée.
- *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
- *SAME
La valeur reste inchangée.
- *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.
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.
- *SAME
La valeur reste inchangée.
- 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) :
- 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.
- 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) :
- Le contrôleur DLUR attend une tentative d'activation provenant d'un noeud DLUS.
- *SAME
La valeur reste inchangée.
- tempo-reconnexion
Indiquez une valeur entre 30 et 2550 (secondes).
Exemples
CHGCTLHOST CTLD(BOSTON) SSCPID(050000000011)
Cette commande permet de modifier le contrôleur hôte BOSTON en lui affectant le SSCPID 050000000011.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.