CRTCFGL

Créer liste de configuration

En bref

La commande CRTCFGL permet de créer une liste de configuration.

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

Syntaxe minimale

CRTCFGL 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
AUT Droits

Astuce : dans une session 5250, tapez CRTCFGL 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 CRTCFGL permet de créer 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, positionnel 1
CFGL	Liste configuration	Nom	Facultatif
DFTFTRACN	Action filtrage défaut	ACCEPT, REJECT	Facultatif
APPNRMTFTR	Filtre CFGL dist APPN	ACCEPT, NONE	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, *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
AUT	Droits	Nom, CHANGE, ALL, USE, EXCLUDE, *LIBCRTAUT	Facultatif

Type de liste de configuration (TYPE)

Indique un des cinq types de listes de configuration possibles.

Ce paramètre est obligatoire.

*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 lieux locaux APPN dans laquelle peuvent figurer jusqu'à 476 lieux locaux APPN.
*APPNRMT: Liste de lieux éloignés APPN dans laquelle peuvent figurer jusqu'à 1898 lieux éloignés APPN.
*APPNSSN: Liste de configuration de filtre d'extrémité de session APPN.
*ASYNCADR: Création d'une liste d'adresses de réseau asynchrone. La liste de configuration peut contenir jusqu'à 294 adresses de réseau asynchrone.
*ASYNCLOC: Création d'une liste 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 passe-système point de vente.
*SNAPASTHR: Liste passe-système SNA dans laquelle peuvent figurer jusqu'à 254 postes. Seul le texte descriptif peut être indiqué à l'aide de cette commande.

Remarque :Pour ajouter un poste à une liste de configuration SNA, utilisez la commande ADDCFGLE.

Pour ajouter un nom et une description d'unité à un poste existant, 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.

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é.

*REJECT: La demande est rejetée.
*ACCEPT: La demande est accepté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é.

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

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.

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.

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

CRTCFGL   TYPE(*APPNLCL)

Cette commande permet d'afficher un écran de saisie plein-écran qui permet à l'utilisateur d'ajouter de nouveaux postes dans la liste de configuration QAPPNLCL.

Messages d'erreur

Messages *ESCAPE

CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF260D: La liste de configuration &1 existe déjà.
CPF260E: Liste de configuration &1 non créé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.
CPF2634: Non autorisé à l'objet &1.
CPF9838: Limite mémoire du profil utilisateur dépassée.