Aller au contenu

Commande CL IBM i (AS/400)

ADDCFGLE

Ajouter poste liste de config

En bref

La commande ADDCFGLE permet d'ajouter des postes dans une liste de configuration.

ADDCFGLE se lit ADD (Ajouter) + CFGLE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDCFGLE TYPE(…)

Paramètres

Astuce : dans une session 5250, tapez ADDCFGLE 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 ADDCFGLE permet d'ajouter des postes dans une liste de configuration.

Remarque :L'utilisateur peut également se servir de l'écran de saisie plein écran de la commande WRKCFGL (Gérer des listes de configuration) pour ajouter, enlever ou modifier des postes dans une liste existante, à l'exception des listes de configuration de type *APPNDIR, *APPNSSN et *SNAPASTHR.

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
APPNLCLE Poste de lieu local APPN Values (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 Values (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 Values (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 Values (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 Values (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
FTRCPNAME Nom point contrôle filtré Nom générique, nom, *ANY Facultatif
FTRCPNETID ID réseau CP filtré Nom de communication, *NETATR Facultatif
LCLLOCNAME Nom lieu local Nom générique, nom, *ANY Facultatif
FTRACN Action filtrage Valeur caractère, *ACCEPT, *REJECT Facultatif
APPNDIRE Postes recherche répert APPN Values (jusqu'à 300 répétitions): Liste d'éléments Facultatif
Élément 1: Nom lieu CP filtré Nom générique, nom, *ANY
Élément 2: NETID lieu CP filtré Nom de communication, *NETATR
Élément 3: Nom lieu partenaire Nom générique, nom, *ANY
Élément 4: ID réseau lieu partenaire Nom de communication, *NETATR
Élément 5: 'Description' du poste Valeur caractère, *BLANK
APPNSSNE Postes extrémité session APPN Values (jusqu'à 300 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
Élément 3: 'Description' du poste Valeur caractère, *BLANK
GRPNAME Nom groupe passe-système SNA Nom Facultatif
DEV Unité passe-système SNA Values (jusqu'à 254 répétitions): Nom Facultatif
TEXT 'Description' du poste Valeur caractère, *BLANK Facultatif
SNAPASTHRE Poste passe-système SNA Liste d'éléments Facultatif
Élément 1: Nom groupe passe-système SNA Nom de communication
Élément 2: Unité passe-système SNA Values (jusqu'à 254 répétitions): Nom de communication
Élément 3: 'Description' du poste Valeur caractère, *BLANK

Type de liste de configuration (TYPE)

Indique le type du poste de liste de configuration à ajouter.

*APPNDIR
Liste de configuration de filtre de recherche de répertoire APPN*.
*APPNLCL
Liste de lieux locaux APPN dans laquelle peuvent figurer jusqu'à 476 postes. Vous pouvez gérer ces postes à l'aide des commandes CHGCFGL (Modifier une liste de configuration) et CRTCFGL (Créer une liste de configuration).
*APPNRMT
Liste de lieux éloignés APPN dans laquelle peuvent figurer jusqu'à 1898 postes. Vous pouvez gérer ces postes à l'aide des commandes CHGCFGL (Modifier une liste de configuration) et CRTCFGL (Créer une liste de configuration).
*APPNSSN
Liste de configuration de filtre d'extrémité de session APPN.
*ASYNCADR
Liste d'adresses de réseau asynchrone dans laquelle peuvent figurer jusqu'à 294 postes.
*ASYNCLOC
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.
*SNAPASTHR
Liste passe-système SNA dans laquelle peuvent figurer jusqu'à 254 postes.

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.

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.

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.

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.

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.

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.

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.

Nom point contrôle filtré (FTRCPNAME)

Nom du point de contrôle adjacent filtré par le système local lors d'une demande de recherche de répertoire.

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

*ANY
Tout nom de point de contrôle est filtré.
nom-générique*-CP-filtré
Indiquez le nom générique (partie d'un nom suivie d'un astérisque) des points de contrôle adjacents en cours de filtrage. Ce nom permet de définir un seul poste de répertoire pour tous les points de contrôle d'un seul réseau dont le nom correspond aux caractères qui précèdent l'astérisque.
nom-CP-filtré
Indiquez le nom du point de contrôle adjacent en cours de filtrage.

ID réseau CP filtré (FTRCPNETID)

Identificateur de réseau du point de contrôle adjacent filtré par le système local lors d'une demande de recherche de répertoire.

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

*NETATR
La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
ID-réseau-CP-filtré
Indiquez l'identificateur de réseau du point de contrôle adjacent filtré par le système local.

Nom lieu local (LCLLOCNAME)

Nom de lieu local fourni par le programme appelant et filtré par le système local. Lorsque celui-ci démarre une session, il s'agit du nom de lieu local utilisé. Lorsqu'une demande d'édition de liens est reçue d'un autre système, il s'agit du nom de LU secondaire utilisé.

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

*ANY
Tout nom de lieu local est filtré par le système local.
nom-générique*-lieu-local
Indiquez le nom générique (partie d'un nom suivie d'un astérisque) des lieux locaux en cours de filtrage. Ce nom permet de définir un seul poste pour tous les noms de lieu local sur le système dont le nom correspond aux caractères qui précèdent l'astérisque.
nom-lieu-local
Indiquez le nom de lieu local filtré par le système local.

Action filtrage (FTRACN)

Action de filtrage associée aux demandes APPN gérées par le système local.

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

*ACCEPT
La demande est acceptée.
*REJECT
La demande est rejetée.

Postes recherche répert APPN (APPNDIRE)

Poste de recherche de répertoire APPN filtré par le système local. Ce paramètre peut être spécifié lorsque la valeur du paramètre TYPE est *APPNDIR. Vous pouvez indiquer jusqu'à 300 postes à la fois.

Les valeurs possibles pour le nom de lieu filtré sont les suivantes :

*ANY
Tout lieu de point de contrôle est filtré.
nom-générique*-lieu-CP-filtré
Indiquez le nom générique (partie d'un nom suivie d'un astérisque) des lieux de point de contrôle à filtrer. Ce nom permet d'indiquer un seul nom pour tous les lieux de point de contrôle dont le nom correspond aux caractères qui précèdent l'astérisque.
nom-lieu-CP-filtré
Indiquez le nom de lieu de point de contrôle à filtrer. Il s'agit du nom du lieu appartenant au point de contrôle adjacent qui est en cours de filtrage si ce dernier est un noeud d'extrémité ou un noeud LEN. Ou bien, il s'agit du nom d'un lieu qui accède au réseau local via le point de contrôle adjacent (noeud de réseau non natif). Ce nom de lieu représente celui du partenaire de session qui tente d'établir une session avec le nom de lieu éloigné (lieu qui existe sur le réseau du système local).

Les valeurs possibles pour l'ID réseau de lieu CP filtré sont les suivantes :

*NETATR
La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
ID-réseau-lieu-CP-filtré
Indiquez l'identificateur de réseau associé au nom de lieu CP à filtrer.

Les valeurs possibles pour le nom de lieu partenaire sont les suivantes :

*ANY
Tout lieu éloigné est filtré.
nom-générique*-lieu-partenaire
Indiquez le nom générique (partie d'un nom suivie d'un astérisque) des lieux partenaires à filtrer. Ce nom permet d'indiquer un seul nom pour tous les lieux partenaires dont le nom correspond aux caractères qui précèdent l'astérisque.
nom-lieu-partenaire
Indiquez le nom du lieu partenaire à filtrer.

Les valeurs possibles pour l'ID réseau de lieu partenaire sont les suivantes :

*NETATR
La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
ID-réseau-partenaire
Indiquez l'identificateur de réseau associé au lieu partenaire à filtrer.

Les valeurs possibles pour la description de poste sont les suivantes :

*BLANK
Aucun texte n'est indiqué.
'description-poste'
Indiquez un bref texte descriptif d'au plus 20 caractères pour chaque poste.

Postes extrémité session APPN (APPNSSNE)

Poste d'extrémité de session APPN filtré par le système local. Ce paramètre peut être spécifié lorsque le paramètre TYPE a pour valeur *APPNSSN. Vous pouvez indiquer jusqu'à 300 postes à la fois.

Les valeurs possibles pour le nom de lieu éloigné sont les suivantes :

*ANY
Tout lieu éloigné est filtré.
nom-générique*-lieu-éloigné
Indiquez le nom générique (partie d'un nom suivie d'un astérisque) des lieux éloignés à filtrer. Ce nom permet d'indiquer un seul nom pour tous les lieux éloignés dont le nom correspond aux caractères qui précèdent l'astérisque.

Les valeurs possibles pour l'ID éloigné de réseau sont les suivantes :

*NETATR
La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
ID-éloigné-réseau
Indiquez l'identificateur éloigné de réseau associé au lieu éloigné à filtrer.

Les valeurs possibles pour le texte descriptif sont les suivantes :

*BLANK
Aucun texte n'est indiqué.
'description-poste'
Indiquez un bref texte descriptif d'au plus 20 caractères pour chaque poste.

Nom groupe passe-système SNA (GRPNAME)

Indique le nom du groupe passe-système SNA du poste ajouté dans la liste de configuration. Chaque nom de groupe, qui doit figurer dans la liste de configuration, correspond à plusieurs unités passe-système SNA amont (paramètre DEV).

Remarque :Ce paramètre est admis uniquement si TYPE(*SNAPASTHR) est indiqué.

Unité passe-système SNA (DEV)

Indique le nom des unités amont associées au groupe passe-système SNA (paramètre GRPNAME).

Remarque :Ce paramètre est admis uniquement si TYPE(*SNAPASTHR) est indiqué.

'Description' du poste (TEXT)

Indique le texte décrivant brièvement le groupe passe-système SNA.

Remarque :Ce paramètre est admis uniquement si le paramètre TYPE a pour valeur *APPNDIR, *APPNSSN ou *SNAPASTHR.

*BLANK
Aucun texte n'est indiqué.
'description-poste'
Décrivez le poste passe-système SNA à ajouter : la description ne doit pas dépasser 50 caractères.

Poste passe-système SNA (SNAPASTHRE)

Définit le poste passe-système SNA. Ce paramètre peut être spécifié uniquement si TYPE(*SNAPASTHR) est défini. Etant donné qu'il risque d'être supprimé dans une édition ultérieure, il est recommandé d'utiliser, chaque fois que cela est possible, les paramètres GRPNAME, DEV et TEXT.

Exemples

ADDCFGLE  TYPE(*APPNLCL)
          APPNLCLE((LOC1 'lieu un') (LOC2 'lieu deux'))

Cette commande ajoute les lieux LOC1 et LOC2 à la liste de configuration QAPPNLCL.

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é.
CPF2613
Trop de postes ont été ajoutés.
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.

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