Aller au contenu

DSPSDSTL

Afficher liste distrib SMTP

Display SMTP Dist List

En bref

La commande Afficher la liste de distribution SMTP (DSPSDSTL) permet d'afficher ou d'imprimer des listes de distribution, ou de créer un fichier de sortie de base de données les contenant. The Display SMTP Distribution List (DSPSDSTL) command is used to display, print, or create a database output file for distribution lists.

DSPSDSTL se lit DSP (Afficher) + SDSTL. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPSDSTL

Paramètres

Astuce : dans une session 5250, tapez DSPSDSTL 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 QTCP)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Afficher la liste de distribution SMTP (DSPSDSTL) permet d'afficher ou d'imprimer des listes de distribution, ou de créer un fichier de sortie de base de données les contenant. The Display SMTP Distribution List (DSPSDSTL) command is used to display, print, or create a database output file for distribution lists.

Paramètres

Mot-clé Description Valeurs possibles Remarques
LSTID ID de listeList ID Valeur caractère, *ALL Facultatif, positionnel 1
OWNER PropriétaireOwner Nom, *ALL, *CURRENT Facultatif, positionnel 2
OUTPUT SortieOutput *, *PRINT, *OUTFILE Facultatif, positionnel 3
OUTFILE Fichier de sortieOutput file Nom d'objet qualifié Facultatif, positionnel 4
Qualificatif 1 : Fichier de sortieQualificatif 1: Output file Nom
Qualificatif 2: BibliothèqueQualificatif 2: Library Nom, *LIBL, *CURLIB
OUTMBR Membre de sortieOutput member Liste d'éléments Facultatif, positionnel 5
Élément 1: Member to receive output Nom, *FIRST
Élément 2: Replace or add records *REPLACE, *ADD
DETAIL DétailDetail *BASIC, *FULL Facultatif, positionnel 6

ID de liste (LSTID)List ID (LSTID)

Indique les listes de distribution à afficher, à imprimer ou à diriger vers un fichier de base de données. Specifies which distribution lists to display, print, or direct to a database file.

*ALL
Toutes les listes de distribution sont incluses dans la sortie. Si la sortie est une liste imprimée ou un fichier de sortie, le paramètre DETAIL détermine si la sortie est une liste des listes de distribution ou une liste des entrées de chaque liste. All distribution lists are included in the output. If the output is a printed list or output file, the DETAIL parameter determines whether a list of distribution lists or a list of the entries in each list is the output.

La valeur d'identificateur de liste possible est : The possible list identifier value is:

list-ID
Indiquez l'identificateur (ID) de liste de la liste de distribution. Specify the list identifier (ID) of the distribution list.

Propriétaire (OWNER)Owner (OWNER)

Indique le propriétaire des listes de distribution à afficher, à imprimer ou à écrire dans un fichier de base de données. Specifies the owner of the distribution lists to display, print, or write to a database file.

*ALL
Les listes de distribution appartenant à tous les profils utilisateur sont dirigées vers la sortie. The distribution lists owned by all user profiles are directed for output.
*CURRENT
Les listes de distribution appartenant à l'utilisateur en cours sont dirigées vers la sortie. The distribution lists owned by the current user are directed for output.
user-profile-name
Indiquez le profil utilisateur du propriétaire dont les listes de distribution doivent être dirigées vers la sortie. Specify the user profile of the owner whose distribution lists are to be directed for output.

Sortie (OUTPUT)Output (OUTPUT)

Indique si la sortie de la commande est affichée sur le poste de travail demandeur, imprimée avec la sortie spoule du travail ou écrite dans un fichier de base de données. Specifies whether the output from the command is shown at the requesting work station, printed with the job's spooled output, or written to a database file.

*:
La sortie demandée par un travail interactif est affichée à l'écran. Si la commande est exécutée dans le cadre d'un travail par lots, la sortie est imprimée avec la sortie spoule du travail. Output requested by an interactive job is shown on the display. If the command is run as part of a batch job, the output is printed with the job's spooled output.
*PRINT:
La sortie est imprimée avec la sortie spoule du travail. The output is printed with the job's spooled output.
*OUTFILE:
La sortie est dirigée vers le fichier de base de données indiqué dans le paramètre OUTFILE. The output is directed to the database file specified on the OUTFILE parameter.

Fichier de sortie (OUTFILE)Output file (OUTFILE)

Indique le nom du fichier de base de données vers lequel la sortie de l'affichage est dirigée. Si le fichier de sortie n'existe pas, cette commande crée un fichier de base de données dans la bibliothèque indiquée. Si aucune bibliothèque n'est indiquée, le fichier de base de données est créé dans QGPL. Specifies the name of the database file to which the output of the display is directed. If the output file does not exist, this command creates a database file in the specified library. If no library is specified, the database file is created in QGPL.

Si le fichier est créé, le texte est 'OUTFILE created by DSPSDSTL' et les droits publics sur le fichier sont identiques aux droits de création indiqués pour la bibliothèque dans laquelle le fichier est créé. Utilisez la commande Afficher la description de bibliothèque (DSPLIBD) pour afficher les droits de création de la bibliothèque. If the file is created, the text is 'OUTFILE created by DSPSDSTL' and the public authority to the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*LIBL
Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
La bibliothèque en cours du travail est utilisée pour localiser le fichier de base de données. Si aucune bibliothèque en cours n'est définie pour le travail, QGPL est utilisée. The current library for the job is used to locate the database file. If no library is specified as the current library for the job, QGPL is used.
nom-bibliothèque
Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier de base de données. Specify the name of the library where the database file is located.
data-base-file-name
Indiquez le nom du fichier de base de données qui reçoit la sortie de l'affichage. Si le fichier de base de données est qualifié par *LIBL mais que le système ne le trouve pas, un fichier est créé dans la bibliothèque par défaut de l'utilisateur, si elle est indiquée. Si la bibliothèque par défaut n'a pas été indiquée, le fichier est créé dans QGPL. Specify the name of the database file that receives the output of the display. If the database file is qualified with *LIBL but the system cannot find the file, one is created in the user's default library, if specified. If the default library was not specified, the file is created in QGPL.

Remarque :Si un nouveau fichier est créé, le fichier système QAOSDSTO de la bibliothèque système QSYS, avec un nom de format OSDSTL, est utilisé comme modèle. Remarque :If a new file is created, system file QAOSDSTO in system library QSYS with a format name of OSDSTL is used as a model.

Membre de sortie (OUTMBR)Output member (OUTMBR)

Indique le nom du membre de fichier de base de données vers lequel la sortie de l'affichage est dirigée. Si un membre existe déjà, le système utilise la seconde partie de ce paramètre pour déterminer si le membre est vidé avant l'ajout des nouveaux enregistrements. Si le membre n'existe pas et qu'aucun nom de membre n'est indiqué, le système crée un membre portant le nom du fichier indiqué dans le paramètre Fichier de sortie (OUTFILE). Si un nom de membre de fichier de sortie est indiqué mais que le membre n'existe pas, le système le crée. Specifies the name of the database file member to which the output of the display is directed. If a member already exists, the system uses the second part of this parameter to determine whether the member is cleared before the new records are added. If the member does not exist and a member name is not specified, the system creates a member with the name of the file specified on the Output file (OUTFILE) parameter. If an output file member name is specified, but the member does not exist, the system creates it.

Les valeurs de membre devant recevoir la sortie possibles sont : The possible member to receive output values are:

*FIRST
Le premier membre du fichier de sortie reçoit la sortie. The first member in the output file receives the output.
member-name
Indiquez le nom du membre de fichier de sortie qui reçoit la sortie. Specify the name of the output file member that receives the output.

Les valeurs de remplacement ou d'ajout d'enregistrements possibles sont : The possible replace or add records values are:

*REPLACE
Les nouvelles données remplacent les données actuellement contenues dans le membre du fichier de sortie. Le membre est vidé à l'ouverture du fichier. The new data replaces the data currently contained in the output file member. The member is cleared when the file is opened.
*ADD
Le membre n'est pas vidé. Les nouvelles données sont ajoutées au membre du fichier de base de données. The member is not cleared. The new data is added to the database file member.

Détail (DETAIL)Detail (DETAIL)

Indique le niveau de détail à imprimer ou à diriger vers le fichier de base de données. Ce paramètre n'est pas utilisé lorsque * est indiqué dans le paramètre ID de liste (OUTPUT) ou lorsqu'un ID de liste précis a été indiqué dans le paramètre Identificateur de liste (LSTID). Lorsque *ALL est indiqué dans le paramètre LSTID, ce paramètre détermine si la sortie est une liste de toutes les listes de distribution ou une liste de toutes les entrées de chaque liste de distribution. Specifies how much detail should be printed or directed to the database file. This parameter is not used when * is specified on the List ID (OUTPUT) parameter or when a specific list ID was specified on the List identifier (LSTID) parameter. When *ALL is specified on the LSTID parameter, this parameter is used to determine whether a list of all distribution lists or a list of all entries in every distribution list is used as the output.

*BASIC
La liste ou la sortie dans le fichier de base de données contient uniquement une liste de toutes les listes de distribution. The list or output in the database file contains only a list of all distribution lists.
*FULL
La liste ou la sortie dans le fichier de base de données contient toutes les entrées de chaque liste de distribution. The list or output in the database file contains all of the entries in every distribution list.

Exemples

Exemple 1 : Affichage d'une liste Example 1: Displaying a List

DSPSDSTL   LSTID(*ALL)  OUTPUT(*)

Cette commande affiche une liste de toutes les listes de distribution. Indiquer DSPSDSTL sans paramètres aurait le même effet. This command displays a list of all distribution lists. Specifying DSPSDSTL without parameters would result in the same action.

Exemple 2 : Impression d'une liste Example 2: Printing a List

DSPSDSTL   LSTID(DISTLIST)  OUTPUT(*PRINT)

Cette commande imprime une liste de toutes les entrées de la liste de distribution DISTLIST. Le paramètre DETAIL n'est pas utilisé lors de l'impression d'une liste précise. This command prints a list of all entries in the distribution list DISTLIST. The detail parameter is not used when printing for a specific list.

Exemple 3 : Envoi de la sortie vers un fichier de base de données Example 3: Directing Output to a Database File

DSPSDSTL   OUTPUT(*OUTFILE)
          OUTFILE(ALLLISTS)  OUTMBR(*FIRST *REPLACE)
          DETAIL(*BASIC)

Cette commande écrit un enregistrement pour chaque liste de distribution contenue dans le répertoire dans le fichier de base de données ALLLISTS. Si ce fichier est introuvable dans la liste de bibliothèques, il est créé dans la bibliothèque QGPL, puisqu'aucune bibliothèque n'est indiquée. This command writes one record for each distribution list contained in the directory to the database file ALLLISTS. If this file is not found in the library list, it is created in the QGPL library, since no library is specified.

Exemple 4 : Envoi de la sortie d'un propriétaire de liste de distribution vers un fichier de base de données Example 4: Directing Output for a Distribution List Owner to a Database File

DSPSDSTL   OWNER(ABSMITH)  OUTFILE(DISTLIST/ABSMITH)
          OUTMBR(*FIRST *REPLACE)  DETAIL(*BASIC)

Cette commande écrit un enregistrement pour chaque liste de distribution appartenant au profil utilisateur ABSMITH dans le fichier de base de données ABSMITH de la bibliothèque DISTLIST. Si ce fichier est introuvable dans la bibliothèque DISTLIST, il est créé. This command writes one record for each distribution list owned by user profile ABSMITH to the database file ABSMITH in the library DISTLIST. If this file is not found in the library DISTLIST, it is created.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP96C8
L'ID de liste &1 est introuvable. List ID, &1, cannot be found.
TCP96C9
L'ID de liste &1 n'est pas un nom valide. List ID &1 is not a valid name.
CPF9820
Vous n'êtes pas autorisé à utiliser la bibliothèque &1. Not authorized to use library &1.
CPF9822
Vous n'êtes pas autorisé à utiliser le fichier &1 de la bibliothèque &2. Not authorized to file &1 in library &2.
CPF9845
Une erreur s'est produite lors de l'ouverture du fichier &1. Error occurred while opening file &1.
CPF9846
Erreur lors du traitement du fichier &1 de la bibliothèque &2. Error while processing file &1 in library &2.
CPF9847
Une erreur s'est produite lors de la fermeture du fichier &1 de la bibliothèque &2. Error occurred while closing file &1 in library &2.
CPF9850
Le remplacement du fichier d'imprimante &1 n'est pas autorisé. Override of printer file &1 not allowed.
CPF9851
La valeur de débordement du fichier &1 dans &2 est trop petite. Overflow value for file &1 in &2 too small.
CPF9860
Une erreur s'est produite pendant le traitement du fichier de sortie. Error occurred during output file processing.

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