DSPDSTL

La commande DSPDSTL (Afficher une liste de diffusion) permet d'afficher, d'imprimer ou de créer un ficher base de données de sortie pour des listes de diffusion contenues dans le répertoire de distribution, mais pas de créer ou de supprimer des listes de diffusion, ni de mettre à jour des listes existantes.

Paramètres

Identificateur de liste (LSTID)

Listes de diffusion à afficher, à imprimer ou à envoyer dans un fichier base de données.

*ALL

Toutes les listes de diffusion du répertoire de distribution du système sont incluses dans la sortie. Les postes sont classés par ordre alphabétique et par ID liste. Si la sortie est une liste imprimée ou un fichier en sortie, le paramètre DETAIL détermine si la sortie est constituée par une liste des listes de diffusion ou par une liste des postes contenus dans chaque liste.

La valeur possible de l'ID liste est la suivante :

ID-liste

Indiquez l'identificateur (ID) de la liste de diffusion.

La valeur possible pour le qualificatif de la liste est la suivante :

qualificatif-ID-liste

Indiquez le qualificatif de l'ID de la liste de diffusion.

Remarque :L'identificateur de la liste de diffusion se compose de deux parties, l'ID et le qualificatif, séparés par au moins un espace. Si vous utilisez des caractères minuscules, le système les convertit en majuscules.

Les conventions d'appellation de l'ID liste en deux parties sont identiques à celles appliquées pour l'ID et l'adresse d'un utilisateur. Vous trouverez une description complète de ces conventions dans le manuel SNA Distribution Services, SC41-5410.

Propriétaire (OWNER)

Indique le propriétaire des listes de diffusion à afficher, imprimer, ou écrire dans un fichier base de données.

*ALL

Les listes de diffusion appartenant à tous les profils utilisateur sont dirigées en sortie.

*CURRENT

Les listes de diffusion appartenant à l'utilisateur en cours sont dirigées en sortie.

nom-du-profil-utilisateur

Indiquez le profil utilisateur du propriétaire dont les listes de diffusion doivent être dirigées en sortie.

Sortie (OUTPUT)

Indique si la sortie générée par la commande est affichée sur le poste de travail demandeur, imprimée avec la sortie spoule du travail ou écrite dans un fichier base de données.

*:

La sortie demandée par un travail interactif s'affiche à l'écran. Si la commande est exécutée dans un travail par lots, la sortie est imprimée avec la sortie spoule du travail.

*PRINT:

La sortie est imprimée avec la sortie spoule du travail.

*OUTFILE:

La sortie est dirigée vers le fichier base de données indiqué au paramètre OUTFILE.

Fichier recevant la sortie (OUTFILE)

Fichier base de données auquel la sortie affichée est envoyée. Si ce fichier n'existe pas, le système se charge de le créer dans la bibliothèque indiquée. Si aucune bibliothèque n'est indiquée, le fichier base de données est créé dans QGPL.

Si le fichier est créé, la mention 'SORTIE créée par DSPDSTL' apparaît et le droit public au dossier est le même que le droit de création indiqué pour la bibliothèque dans laquelle le dossier est créé. Ce droit de création peut être affiché à l'aide de la commande DSPLIBD (Afficher une description de bibliothèque).

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier base de données est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque où se trouve le fichier base de données.

nom-du-fichier-base-de-données

Indiquez le nom du fichier base de données recevant la sortie affichée. Si le fichier base de données est qualifié par *LIBL, mais que le système ne parvient pas à le trouver, il est créé dans la bibliothèque par défaut de l'utilisateur si celle-ci est précisée dans le profil utilisateur. Si ce n'est pas le cas, le fichier est créé dans QGPL.

Remarque :Si le système crée un nouveau fichier, il prend pour modèle le fichier système QAOSDSTO de la bibliothèque système QSYS et le nom de format OSDSTL.

Options pour membre de sortie (OUTMBR)

Nom du membre de fichier base de données vers lequel la sortie affichée est acheminée. Si ce membre existe déjà, le système se sert du second élément de ce paramètre pour déterminer si le membre doit être effacé avant l'ajout des nouveaux enregistrements. Si le membre n'existe pas et qu'aucun nom de membre n'est indiqué, le système en crée un du nom du fichier précisé par le paramètre Fichier recevant la sortie (OUTFILE). Si un nom de membre de fichier en sortie est indiqué, mais que le membre n'existe pas, le système le crée.

Les valeurs de membre recevant la sortie possibles sont :

*FIRST

Le premier membre du fichier de sortie reçoit la sortie.

nom-membre

Indiquez le nom du membre du fichier de sortie vers lequel la sortie sera acheminée.

Les valeurs d'ajout ou de remplacement d'enregistrements possibles sont :

*REPLACE

Les nouvelles données remplacent les données en cours du membre du fichier de sortie. Ce membre est mis à blanc à l'ouverture du fichier.

*ADD

Le membre n'est pas mis à blanc. Les nouvelles données sont ajoutées au membre du fichier base de données.

Détail (DETAIL)

Détails à imprimer ou à envoyer dans le fichier base de données. Ce paramètre n'est pas utilisé lorsqu'un astérisque (*) est entré pour le paramètre Sortie (OUTPUT) ou qu'un ID liste spécifique est indiqué pour le paramètre Identificateur de liste (LSTID). Mais si *ALL est précisé pour ce dernier, le paramètre sert alors à déterminer si la sortie comprend seulement une liste de toutes les listes de diffusion ou si elle inclut tous les postes de chaque liste de diffusion.

*BASIC

La liste ou la sortie envoyée dans le fichier base de données contient uniquement une liste de toutes les listes de diffusion figurant dans le répertoire.

*FULL

La liste ou la sortie envoyée dans le fichier base de données contient tous les postes de chaque liste de diffusion figurant dans le répertoire.

ID caractères pour commande (CMDCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) pour les données à entrer comme valeurs de paramètres de commandes.

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.

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.

Exemples

Exemple 1 : affichage d'une liste

DSPDSTL   LSTID(*ALL)  OUTPUT(*)

Cette commande affiche une liste de toutes les listes de diffusion du répertoire. Le fait d'indiquer DSPDSTL sans paramètres entraînerait la même action.

Exemple 2 : impression d'une liste

DSPDSTL   LSTID(DEPT48K DISTLIST)  OUTPUT(*PRINT)

Cette commande imprime la liste de tous les postes de la liste de diffusion DEPT48K DISTLIST. Les paramètre détaillés ne sont pas utilisés lors de l'impression d'une liste en particulier.

Exemple 3 : transcription du résultat dans un fichier de base de données

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

Cette commande écrit dans le fichier de base de données ALLLISTS un enregistrement pour chaque liste de diffusion contenue dans le répertoire. Si ce fichier est introuvable dans la liste des bibliothèques, il est créé dans la bibliothèque QGPL, aucune bibliothèque n'ayant été spécifiée.

Exemple 4 : transcription du résultat pour un propriétaire de liste de diffusion vers un fichier de base de données

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

Cette commande écrit dans le fichier ABSMITH de DISTLIST un enregistrement pour chaque liste de diffusion possédée par le profil utilisateur ABSMITH. Si ce fichier est introuvable dans la bibliothèque DISTLIST, il est créé.

Messages d'erreur

Messages *ESCAPE

CPF905C

Erreur lors de la recherche d'une table de conversion.

CPF9052

ID liste &1 &2 introuvable.

CPF9096

Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9822

Non autorisé au fichier &1 de &2.

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.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.

CPF9860

Erreur lors du traitement du fichier de sortie.