Aller au contenu

ADDDSTLE

Ajouter poste liste diffusion

En bref

La commande ADDDSTLE (Ajouter un poste à une liste de diffusion) permet d'ajouter de nouveaux postes à une liste de diffusion existante.

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

Syntaxe minimale

ADDDSTLE LSTID(…)

Paramètres

  • LSTID Identificateur de liste obligatoire
  • USRID Identificateur utilisateur
  • FROMLSTID A partir de l'ID liste
  • CMDCHRID ID caractères pour commande

Astuce : dans une session 5250, tapez ADDDSTLE 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 ADDDSTLE (Ajouter un poste à une liste de diffusion) permet d'ajouter de nouveaux postes à une liste de diffusion existante. Une liste de diffusion peut comprendre des utilisateurs locaux, éloignés, indirects et des utilisateurs de postes de travail programmables. Une liste peut comporter en outre des listes de diffusion éloignées, mais non locales.

Vous pouvez ajouter jusqu'à 300 postes à la fois à une liste de diffusion. De plus, vous pouvez y inscrire jusqu'à 50 ID listes de diffusion locales, dont tous les membres seront ajoutés à la liste.

La liste de diffusion doit exister pour que cette commande puisse être exécutée. La commande CRTDSTL (Créer une liste de diffusion) peut être utilisée pour créer une nouvelle liste de diffusion.

Restriction : L'utilisateur de la commande ADDDSTLE doit avoir un droit d'administrateur de la sécurité pour pouvoir ajouter des postes à une liste de diffusion appartenant à une autre personne. Tout utilisateur peut cependant ajouter sans restriction des postes à une liste de diffusion qu'il a créée.

Paramètres

Mot-clé Description Valeurs possibles Remarques
LSTID Identificateur de liste Liste d'éléments Obligatoire, positionnel 1
Élément 1: ID Liste Valeur caractère
Élément 2: Qualificatif ID Liste Valeur caractère
USRID Identificateur utilisateur Valeurs uniques: *NONE
Autres valeurs (jusqu'à 300 répétitions): Liste d'éléments
Facultatif
Élément 1: ID utilisateur Valeur caractère
Élément 2: Adresse Valeur caractère
Élément 3: Description de l'utilisateur Valeur caractère, *FIRST
FROMLSTID A partir de l'ID liste Valeurs uniques: *NONE
Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments
Facultatif
Élément 1: ID Liste Valeur caractère
Élément 2: Qualificatif ID Liste Valeur caractère
CMDCHRID ID caractères pour commande Valeurs uniques: *SYSVAL, *DEVD
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Jeu de caractères graphiques Entier
Élément 2: Page de codes Entier

Identificateur de liste (LSTID)

Identificateur, composé de deux éléments, de la liste de diffusion à laquelle des postes sont ajoutés.

Ce paramètre est obligatoire.

identificateur-de-liste
Indiquez l'ID liste en deux éléments.

Les règles d'appellation des ID liste sont expliquées dans le manuel intitulé SNA Distribution Services, SC41-5410.

Si vous avez entré des caractères en minuscules, le système les convertit et les stocke en majuscules.

Identificateur utilisateur (USRID)

ID, adresse et description de l'utilisateur ajouté à la liste de diffusion. L'ID utilisateur et l'adresse sont tous deux obligatoires. Cependant, un ID liste (à deux éléments) peut être utilisé à la place de l'ID utilisateur et de l'adresse pour identifier une liste de diffusion éloignée. Une telle liste peut être ajoutée à un répertoire local en tant qu'utilisateur éloigné ou peut être acceptée si une valeur *ANY tient lieu de poste par défaut. Une description peut également être entrée; elle doit correspondre exactement au poste, tel qu'il figure dans le répertoire. Si aucune description n'est donnée, *FIRST sera la valeur par défaut.

Vous pouvez indiquer jusqu'à 300 combinaisons ID utilisateur, adresse et description. Chaque jeu accepté est ajouté à la liste de diffusion.

*NONE
Aucun ID utilisateur n'est précisé. Si *NONE est indiqué, vous devez alors définir une valeur autre que *NONE pour le paramètre A partir de l'ID liste (FROMLSTID).
ID-utilisateur et adresse
Indiquez l'ID et l'adresse de l'utilisateur.

Si vous avez entré des caractères en minuscules, le système les convertit et les stocke en majuscules.

Vous pouvez également indiquer l'ID d'une liste éloignée.

*FIRST
La première ou la seule description associée à l'ID utilisateur et à l'adresse indiqués est ajoutée.
description-de-l'utilisateur
Entrez la description associée à l'utilisateur (jusqu'à 50 caractères). Si un ID liste est indiqué, entrez sa description. Votre description doit être identique à celle qui figure dans le répertoire, sinon vous recevrez un message d'erreur.

A partir de l'ID liste (FROMLSTID)

Liste de diffusion existante dont les postes sont ajoutés à la présente liste. Vous pouvez entrer jusqu'à 50 ID liste différents. Les postes en double ne seront pas supprimés.

*NONE
Aucun ID liste n'est indiqué.
ID-liste-source
Indiquez l'ID en deux éléments d'une liste de diffusion dont les postes sont ajoutés à la présente liste.

ID caractères pour commande (CMDCHRID)

Identificateur des caractères (jeu de caractères graphiques et page de codes) des données entrées comme valeurs de paramètres de commandes. La valeur que vous indiquez pour ce paramètre s'applique aux paramètres Identificateur de liste (LSTID), Identificateur utilisateur (USRID) et A partir de l'ID liste (FROMLSTID).

Remarques :

  • Seuls l'ID utilisateur et adresse, le nom et le groupe du système, le service, et les paramètres X.400 O/R sont traduits selon l'identificateur de jeu de caractères graphiques indiqué dans ce paramètre. Toutes les autres valeurs précisées sont stockées telles quelles, et la valeur de l'identificateur est stockée avec elles.
  • Si cette commande est exécutée de manière interactive, la valeur d'identificateur de caractères graphiques par défaut est extraite de la description de l'unité écran. Si la commande est exécutée en traitement par lots, la valeur par défaut est la valeur système QCHRID. Vous pouvez indiquer une valeur de jeu de caractères et de page de codes à ce paramètre, et la substituer ainsi à la valeur par défaut.

Valeurs uniques

*SYSVAL
Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.
*DEVD
Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767
Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767
Indiquez la page de codes à utiliser.

Exemples

ADDDSTLE   LSTID(CHICAGO DLIST)
           USRID((HURST NEWYORK 'Directeur de Payroll')
                 (LEE DEPT554 *FIRST)
                 (BOCA DLIST 'Liste diffusion distance pour Boca')
                 (ERIC WAREHSE))
           FROMLSTID((DEPT48K DLIST) (ALLMGRS DLIST))

Cette commande indique que quatre ID utilisateur sont ajoutés à la liste de diffusion CHICAGO DLIST. Le troisième ID utilisateur correspond en fait à une liste de diffusion à distance. Le quatrième ID utilisateur (ERIC WAREHSE) est défini par défaut sur la première description de cet ID utilisateur. En outre, tous les postes des deux listes de diffusion sont ajoutés à cette liste de diffusion.

Messages d'erreur

Messages *ESCAPE

CPF9024
Le système ne peut pas extraire l'enregistrement pour terminer l'opération.
CPF905C
Erreur lors de la recherche d'une table de conversion.
CPF9090
Aucun poste n'a été ajouté à la liste de diffusion &1 &2.
CPF9091
&1 poste(s) ajouté(s) et &2 liste(s) copiée(s) à liste &3 &4. &5 poste(s) non ajouté(s) et &6 liste(s) non copiée(s)
CPF9096
Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.
CPF9838
Limite mémoire du profil utilisateur dépassée.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9846
Erreur lors du traitement du fichier &1 de &2.

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