CHGCFGL

Modifier liste configuration

En bref

La commande CHGCFGL permet de modifier une liste de configuration.

CHGCFGL se lit CHG (Modifier) + CFGL. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGCFGL TYPE(…)

Paramètres

TYPE Type de liste de configuration obligatoire
CFGL Liste configuration
DFTFTRACN Action filtrage défaut
APPNRMTFTR Filtre CFGL dist APPN
TEXT Texte 'descriptif'
APPNLCLE Poste de lieu local APPN
APPNRMTE Poste de lieu éloigné APPN
ASYNCADRE Poste adresse réseau async
ASYNCLOCE Poste de lieu éloigné async
RTLPASTHRE Poste passe-syst pnt de vente

Astuce : dans une session 5250, tapez CHGCFGL 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 CHGCFGL permet de modifier une liste de configuration.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
TYPE	Type de liste de configuration	APPNDIR, APPNLCL, APPNRMT, APPNSSN, ASYNCADR, ASYNCLOC, RTLPASTHR, SNAPASTHR	Obligatoire, clé, positionnel 1
CFGL	Liste configuration	Nom	Facultatif, clé
DFTFTRACN	Action filtrage défaut	SAME, ACCEPT, *REJECT	Facultatif
APPNRMTFTR	Filtre CFGL dist APPN	SAME, ACCEPT, *NONE	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
APPNLCLE	Poste de lieu local APPN	Valeurs uniques: PROMPT Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Nom lieu local	Nom de communication
	Élément 2: 'Description' du poste	Valeur caractère, *BLANK
APPNRMTE	Poste de lieu éloigné APPN	Valeurs uniques: PROMPT Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Nom lieu éloigné	Nom générique, nom, *ANY
	Élément 2: ID éloigné réseau	Nom de communication, NETATR, NONE
	Élément 3: Nom lieu local	Nom de communication, *NETATR
	Élément 4: Point de contrôle éloigné	Nom de communication, *NONE
	Élément 5: Id réseau du point de ctrl	Nom de communication, NETATR, NONE
	Élément 6: Mot de passe du lieu	Valeur caractère, *NONE
	Élément 7: Lieu protégé	YES, NO, *VFYENCPWD
	Élément 8: Session unique	YES, NO
	Élément 9: Session contrôlée en local	YES, NO
	Élément 10: Session pré-établie	YES, NO
	Élément 11: 'Description' du poste	Valeur caractère, *BLANK
	Élément 12: Nombre de conversations	1-512, 10
ASYNCADRE	Poste adresse réseau async	Valeurs uniques: PROMPT Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Adresse réseau	Valeur caractère
	Élément 2: Nombre essais de numérotation	1-255, 2
	Élément 3: 'Description' du poste	Valeur caractère, *BLANK
ASYNCLOCE	Poste de lieu éloigné async	Valeurs uniques: PROMPT Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Nom lieu éloigné	Nom de communication
	Élément 2: Identificateur de lieu éloigné	Nom
	Élément 3: 'Description' du poste	Valeur caractère, *BLANK
RTLPASTHRE	Poste passe-syst pnt de vente	Valeurs uniques: PROMPT Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Unité point de vente	Nom
	Élément 2: Unité SNUF	Nom
	Élément 3: Programme hôte par défaut	Nom
	Élément 4: 'Description' du poste	Valeur caractère, *BLANK

Type de liste de configuration (TYPE)

Indique le type de la liste de configuration à modifier.

*APPNDIR: Liste de configuration de filtre de recherche de répertoire APPN. Seuls les paramètres TEXT et DFTACN peuvent être modifiés à l'aide de cette commande.
Remarque :Pour modifier un poste d'une liste de configuration de répertoire APPN, utilisez la commande CHGCFGLE.
*APPNLCL: Liste de configuration de lieux locaux APPN dans laquelle peuvent figurer jusqu'à 476 postes.
*APPNRMT: Liste de configuration de lieux éloignés APPN dans laquelle peuvent figurer jusqu'à 1898 postes.
*APPNSSN: Liste de configuration de filtre d'extrémité de session APPN. Seuls les paramètres TEXT et DFTACN peuvent être modifiés à l'aide de cette commande.
Remarque :Pour modifier un poste d'une liste de configuration de session APPN, utilisez la commande CHGCFGLE.
*ASYNCADR: Liste de configuration d'adresses de réseau asynchrone dans laquelle peuvent figurer jusqu'à 294 postes.
*ASYNCLOC: Liste de configuration de lieux éloignés asynchrones. Elle peut contenir jusqu'à 32000 postes.
*RTLPASTHR: Liste passe-système point de vente dans laquelle peuvent figurer jusqu'à 450 postes.
*SNAPASTHR: Liste passe-système SNA ; seul le texte descriptif de cette liste peut être modifié à l'aide de la commande CHGCFGL (Modifier une liste de configuration).
Remarque :Pour modifier un poste d'une liste de configuration SNA, utilisez la commande CHGCFGLE.

Liste configuration (CFGL)

Indique le nom de la liste de configuration. Cette valeur n'est requise et correcte que si la liste de configuration est une liste d'adresses de réseau asynchrones (*ASYNCADR est précisé à l'invite Type de liste de configuration (paramètre TYPE)). Les noms des types de liste sont fournis par le système : QAPPNLCL, QAPPNRMT, QASYNCADR, QASYNCLOC, QRTLPASTHR et QSNAPASSTHR.

Ce paramètre est obligatoire.

Action filtrage défaut (DFTFTRACN)

Action de filtrage par défaut pour les demandes APPN traitées par le système local. Cette action s'applique à toutes les demandes de recherche de répertoire et d'extrémité de session qui ne figurent pas dans la liste de configuration.

Remarque :Ce paramètre n'est admis que si TYPE(*APPNDIR) ou TYPE(*APPNSSN) est indiqué.

*SAME: L'action de filtrage par défaut reste la même.
*ACCEPT: La demande est acceptée.
*REJECT: La demande est rejetée.

Filtre CFGL dist APPN (APPNRMTFTR)

Indique si les postes d'une liste de configuration éloignée APPN doivent être utilisés pour le filtrage des demandes d'extrémité de session.

Remarque :Ce paramètre n'est admis que si TYPE(*APPNSSN) est indiqué.

*SAME: L'action de filtrage d'une liste de configuration éloignée APPN reste inchangée.
*ACCEPT: Les demandes d'extrémité de session pour les postes spécifiés dans la liste de configuration éloignée APPN sont acceptées.
*NONE: Les demandes d'extrémité de session ne sont pas filtrées à l'aide des postes précisés dans la liste de configuration éloignée APPN.

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.

*SAME: La valeur ne change pas.

Poste de lieu local APPN (APPNLCLE)

Désigne le poste du lieu local APPN. Ce paramètre est nécessaire si *APPNLCL est spécifié au paramètre Type de liste de configuration (TYPE).

Ce paramètre admet des valeurs multiples.

*PROMPT: La valeur spéciale *PROMPT permet d'ajouter, enlever et modifier des postes à partir d'un panneau de saisie plein écran.

Remarque :Indiquez *PROMPT pour éviter que les postes figurant déjà sur la liste de configuration soient affectés. Si vous spécifiez directement les postes à partir de la commande CHGCFGL, tous les postes seront supprimés et remplacés.

Pour ce paramètre, vous pouvez spécifier directement jusqu'à 50 postes. Un poste est une valeur composée des éléments suivants :

nom-lieu-local: Indiquez le nom de lieu du système local. Ce nom est utilisé par APPN pour déterminer si la demande entrante est destinée à ce système ou à un autre système du réseau. Le nom local de lieu doit être unique et ne peut ni exister comme nom éloigné de lieu utilisé par la liste de configuration QAPPNRMT, ni être spécifié comme nom local de lieu d'un autre système du même réseau APPN.
description-poste: Indiquez une description succincte pour chaque poste local (20 caractères maximum).

Poste de lieu éloigné APPN (APPNRMTE)

Désigne le poste de lieu éloigné APPN. Ce paramètre est nécessaire si *APPNRMT est spécifiée au paramètre Type de liste de configuration (TYPE).

Ce paramètre admet des valeurs multiples.

*PROMPT: La valeur spéciale *PROMPT permet d'ajouter, enlever et modifier des postes à partir d'un panneau de saisie plein écran.

Pour ce paramètre, vous pouvez spécifier directement jusqu'à 50 postes. Un poste est une valeur composée des éléments suivants :

nom-lieu-éloigné

Indiquez le nom d'un lieu éloigné. Ce nom peut être spécifique ou générique (se terminant par un astérisque). Le nom de lieu générique permet de définir un seul poste de répertoire pour tous les lieux d'un seul point de contrôle dont le nom correspond aux caractères qui précèdent l'astérisque. Vous pouvez également spécifier *ANY pour permettre à toutes les demandes de transiter par le système. Les noms génériques ne sont admis que lorsqu'ils proviennent de noeuds de réseau.

identificateur-réseau-éloigné

Indiquez l'identificateur du réseau dans lequel se trouve le lieu éloigné. La valeur par défaut *NETATR utilise la valeur LCLNETID des attributs de réseau du système.

nom-lieu-local

Indiquez le nom de lieu du système local. Ce nom est utilisé par APPN en combinaison avec un poste de lieu éloigné. La valeur par défaut *NETATR renvoie à la valeur LCLLOCNAME des attributs de réseau du système.

nom-point-contrôle

Indiquez le point de contrôle qui fournit les fonctions de gestion du réseau pour le lieu éloigné. L'utilisation de ce nom de point de contrôle (poste du répertoire du lieu éloigné) permet, lors de l'interrogation du réseau, de faciliter la recherche du lieu. Cette zone est nécessaire si le nom du lieu éloigné est générique. La valeur par défaut est *NONE.

identificateur-réseau-point-contrôle

Indiquez l'identificateur du réseau dans lequel se trouve le point de contrôle. La valeur par défaut *NETATR utilise la valeur LCLNETID des attributs de réseau du système.

mot-de-passe-du-lieu

Indiquez le mot de passe utilisé lors de l'établissement de sessions sur la paire nom de lieu éloigné/local. Ce paramètre doit comprendre un nombre pair de caractères hexadécimaux. La valeur par défaut est *NONE.

lieu-protégé

Indique la manière de gérer les informations de sécurité lors de la réception de demandes de démarrage de programmes en provenance d'un système éloigné. La valeur choisie est envoyée à ces derniers lors de l'établissement de sessions. Elle détermine la façon de traiter les demandes d'allocation ou d'appel. Cette valeur s'applique uniquement aux conversations établies avec le niveau de sécurité SECURITY(SAME).

*NO: Le système éloigné n'est pas un lieu protégé. et ses validations de sécurité ne sont pas acceptées. Les conversations ayant le niveau de sécurité SECURITY(SAME) sont traitées avec le niveau SECURITY(NONE). Aucune information de sécurité n'est envoyée avec les demandes d'allocation ou d'appel.
*YES: Le système éloigné est un lieu protégé et ses validations de sécurité sont acceptées par le système local. Ce dernier lui permet de vérifier les mots de passe utilisateur lors de conversations ayant le niveau de sécurité SECURITY(SAME). Sur le système éloigné, les ID utilisateur sont extraits du système d'exploitation, puis envoyés avec un indicateur déjà vérifié dans les demandes d'allocation ou d'appel.
*VFYENCPWD: Le système éloigné n'est pas un lieu protégé. Il n'est pas autorisé à envoyer l'indicateur déjà vérifié lors de conversations ayant le niveau de sécurité SECURITY(SAME). Sur le système éloigné, les ID et mots de passe utilisateur sont extraits du système d'exploitation. Les mots de passe sont ensuite chiffrés, puis envoyés avec les ID dans les demandes d'allocation ou d'appel pour vérification par le système local. N'utilisez cette valeur que si le système éloigné utilise la version V3R2M0 ou une version ultérieure de l'i5/OS. S'il ne prend pas en charge la protection des mots de passe, aucun établissement de session n'est autorisé ; s'il prend en charge la protection des mots de passe mais pas la vérification des mots de passe chiffrés (VFYENCPWD), le niveau de sécurité SECURITY(NONE) est attribué aux conversations.

nombre-conversations

Indiquez le nombre de conversations pour une connexion à session unique. Le nombre de conversations par défaut est de 10. La valeur par défaut doit être utilisée si la valeur attribuée à l'unité à session unique est *NO. Les valeurs admises sont comprises entre 1 et 512.

session-contrôlée-en-local

Indiquez YES si une session contrôlée en local est admise pour cette paire de noms local/éloigné de lieu. La valeur par défaut est *NO.

session-préétablie

Indiquez YES si la session est automatiquement établie lorsqu'une connexion est réalisée entre le lieu local et le lieu éloigné. La valeur par défaut est *NO.

description-poste

Indiquez une description succincte pour chaque poste éloigné. La valeur par défaut est *BLANK.

Remarque :La combinaison nom de lieu éloigné, identificateur de réseau et nom de lieu local doit être unique. En outre, le nom de lieu éloigné ne doit pas exister comme lieu local dans la liste QAPPNLCL, ou comme valeur en cours de l'attribut de réseau LCLLOCNAME ou LCLCPNAME.

Poste adresse réseau async (ASYNCADRE)

Désigne le poste de l'adresse de réseau asynchrone. Cette valeur est nécessaire si *ASYNCADR est spécifiée au paramètre Type de liste de configuration (TYPE).

Ce paramètre admet des valeurs multiples.

*PROMPT: La valeur spéciale *PROMPT permet d'ajouter, enlever et modifier des postes à partir d'un panneau de saisie plein écran.

Pour ce paramètre, vous pouvez spécifier directement jusqu'à 50 postes. Un poste est une valeur composée des éléments suivants :

adresse-réseau: Indiquez l'adresse du réseau X.25. Cette valeur ne doit comprendre que les chiffres de 0 à 9.
nombre-d'essais-numérotation: Indiquez le nombre d'essais de recomposition du numéro d'appel en cas d'erreurs, avant composition du numéro suivant. Ce nombre doit être compris entre 1 et 255.
description-poste: Indiquez une description succincte de chaque poste d'adresse de réseau.

Poste de lieu éloigné async (ASYNCLOCE)

Indique le poste de lieu éloigné asynchrone. Ce paramètre est nécessaire si *ASYNCLOC est spécifiée au paramètre Type de liste de configuration (TYPE).

Ce paramètre admet des valeurs multiples.

*PROMPT: La valeur spéciale *PROMPT permet d'ajouter, enlever et modifier des postes à partir d'un panneau de saisie plein écran.

Pour ce paramètre, vous pouvez spécifier directement jusqu'à 50 postes. Un poste est une valeur composée des éléments suivants :

nom-lieu-éloigné: Indiquez le nom qui, combiné à l'identificateur de lieu éloigné, déterminera l'acceptation d'un appel entrant. Ce nom est identique au nom local dans le système éloigné. Cette valeur doit être unique.
identificateur-lieu-éloigné: Indiquez l'identificateur qui, combiné au nom de lieu éloigné, détermine si un appel entrant sera accepté. Cet identificateur doit être le même que l'identificateur local du système éloigné.
description-poste: Indiquez la description succincte de chaque poste de lieu éloigné. La valeur par défaut est *BLANK.

Poste passe-syst pnt de vente (RTLPASTHRE)

Indique le poste passe-système point de vente. Cette valeur doit être indiquée lorsque *RTLPASTHR est précisé au paramètre Type de liste de configuration (TYPE).

Ce paramètre admet des valeurs multiples.

*PROMPT: La valeur spéciale *PROMPT permet d'ajouter, enlever et modifier des postes à partir d'un panneau de saisie plein écran.

Pour ce paramètre, vous pouvez spécifier directement jusqu'à 50 postes. Un poste est une valeur composée des éléments suivants :

nom-unité-point-de-vente: Indiquez le nom de l'unité point de vente qui communique avec le système hôte. Cette valeur doit être unique.
nom-unité-SNUF: Indiquez le nom de l'unité SNUF utilisée pour les communications entre l'unité point de vente et le système hôte. Cette valeur doit être unique.
nom-programme-hôte-par-défaut: Indiquez le nom du programme qui doit être lancé sur le système hôte dans le cas où il n'est pas mentionné dans la commande SNA (INIT-SELF) de demande de lancement de session.
description-poste: Donnez une brève description de chaque poste passe-système point de vente. La valeur par défaut est *BLANK.

Exemples

CHGCFGL   TYPE(*ASYNCADR)  CFGL(CFGL01)

Cette commande permet d'afficher un écran de saisie plein-écran contenant les postes existants pour la liste de configuration CFGL01. A partir de cet écran, l'utilisateur peut ajouter, modifier et supprimer des postes.

Messages d'erreur

Messages *ESCAPE

CPF260F: Liste de configuration &1 non trouvée.
CPF261C: Index de liste de configuration &1 non modifié.
CPF261D: Index de liste de configuration &1 non modifié.
CPF261F: Liste de configuration &1 supprimée.
CPF2625: Impossible d'allouer l'objet &1.
CPF263A: Type &1 de liste de configuration non identique au type &2.
CPF2634: Non autorisé à l'objet &1.
CPF2663: Liste de configuration &1 précédemment supprimée.
CPF9838: Limite mémoire du profil utilisateur dépassée.