Aller au contenu

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

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) :
    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.
*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.

Messages d'erreur

Messages *ESCAPE

CPF2652
Description de contrôleur &1 non modifiée.

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