DSPDIRE

La commande DSPDIRE (Afficher les postes du répertoire) permet d'afficher, d'imprimer ou de créer un fichier base de données pour certains ou pour tous les postes du répertoire de distribution du système. La sortie du fichier base de données est affichée, imprimée ou créée selon les règles suivantes :

• Pour une sortie affichée, lorsque les paramètres USRID ou USER s'appliquent à plusieurs postes d'un répertoire, le système fournit une liste de postes. Lorsque ces paramètres identifient uniquement un poste de répertoire, le système fournit les détails concernant le poste.
• Pour une sortie imprimée ou une sortie fichier base de données, si le paramètre USRID indique le répertoire complet, le paramètre DETAIL détermine si la sortie est constituée par une liste des postes ou par les détails complets pour chaque poste. Si les paramètres USRID ou USER indiquent un ID ou un profil utilisateur, les détails complets correspondant à cet utilisateur sont envoyés à la sortie.

La commande DSPDIRE ne met pas à jour le répertoire. Cette fonction est exécutée en mode interactif, avec affichage, par les commande WRKDIRE (Gérer les postes du répertoire), ADDDIRE (Ajouter un poste au répertoire), RMVDIRE (Enlever un poste du répertoire), CHGDIRE (Modifier un poste du répertoire) et RNMDIRE (Rebaptiser un poste du répertoire).

Paramètres

Identificateur utilisateur (USRID)

Indique l'ID et l'adresse de l'utilisateur pour lequel les postes du répertoire sont affichés, imprimés ou dirigés vers un fichier base de données. Si le paramètre USRID est précisé, vous ne pouvez pas indiquer le paramètre USER.

Pour une sortie affichée, si l'ID et l'adresse utilisateur désignent un poste associé à une seule description, les détails du répertoire associés à ce poste sont affichés. Si l'ID et l'adresse utilisateur sont associés à plusieurs descriptions, la liste des ID et adresses utilisateur correspondants s'affiche. Dans celle-ci, vous pouvez sélectionner l'ID et l'adresse dont vous souhaitez connaître les détails.

Pour une sortie imprimée ou une sortie fichier base de données, les détails de répertoire complets, notamment la totalité des descriptions correspondant à l'ID et à l'adresse utilisateur, sont imprimés ou envoyés à un fichier base de données. Pour plus d'informations sur l'ID et l'adresse utilisateur, reportez-vous au manuel SNA Distribution Services, SC41-5410.

*ALL

Tous les postes du répertoire de distribution du système sont affichés, imprimés ou dirigés vers un fichier base de données. Les postes sont classés par ordre alphabétique, par ID et adresse utilisateur. Si les données sont dirigées vers une liste imprimée ou un fichier en sortie, le paramètre DETAIL indique si la sortie est constituée par une liste d'ID utilisateur, d'adresses et de descriptions, ou par les détails complets du répertoire.

La valeur possible pour l'ID utilisateur est la suivante :

ID-utilisateur

Indique l'ID de l'utilisateur pour lequel un poste de répertoire existant est affiché, imprimé ou dirigé vers un fichier base de données.

La valeur possible de l'adresse de l'utilisateur est la suivante :

adresse-utilisateur

Indiquez l'adresse de l'utilisateur pour lequel un poste de répertoire existant est affiché, imprimé ou dirigé vers un fichier base de données.

Profil utilisateur (USER)

Indique un profil utilisateur pour lequel des postes de répertoire sont affichés, imprimés ou écrits dans un fichier base de données. Si le paramètre USER est précisé, vous ne pouvez pas indiquer le paramètre USRID.

Pour une sortie affichée, si le profil désigne un poste associé à une seule description, les détails du répertoire associés à ce poste sont affichés. Si le profil est associé à plusieurs descriptions, la liste des ID et adresses utilisateur correspondants s'affiche. Dans celle-ci, vous pouvez sélectionner l'ID et l'adresse dont vous souhaitez connaître les détails.

*CURRENT

Le profil utilisateur associé au travail en cours est utilisé.

nom-du-profil-utilisateur

Indiquez un nom de profil utilisateur dont les détails associés au poste de répertoire correspondant constituent la sortie.

Sortie (OUTPUT)

Indique si la sortie générée par la commande est affichée sur le poste de travail ayant émis cette dernière, si elle est imprimée avec la sortie spoule du travail ou si elle est écrite dans un fichier de sortie.

*

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)

Indique le nom qualifié du fichier base de données vers lequel est dirigée la sortie de l'affichage. Si le fichier base de données n'existe pas, cette commande le crée dans la bibliothèque indiquée. Si aucune bibliothèque n'est précisée, le fichier base de données est créé dans la bibliothèque par défaut de l'utilisateur précisée dans le profil utilisateur. Si aucune bibliothèque par défaut n'est indiquée, le fichier base de données en sortie est créé dans la bibliothèque QGPL.

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 la bibliothèque QGPL.

Reportez-vous au paramètre OUTFILFMT pour connaître les types de fichiers en sortie admis et leurs noms.

Le nom du fichier base de données peut être accompagné de l'une des valeurs de bibliothèque 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

La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

nom-fichier-base-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 la bibliothèque QGPL.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre du fichier base de données vers lequel est dirigée la sortie. Si un membre existe déjà, le système utilise le deuxième élément de ce paramètre pour déterminer si le membre est effacé avant d'ajouter les nouveaux enregistrements. Si le membre n'existe pas et qu'aucun nom de membre n'est indiqué, le système crée un membre en lui donnant le nom du fichier en sortie précisé au paramètre 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 possibles pour le membre en sortie sont les suivantes :

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué au paramètre OUTFILE.

nom-membre

Indiquez le membre du fichier qui reçoit la sortie. Si OUTMBR(nom-membre) est indiqué et que le membre n'existe pas, ce dernier est créé par le système.

L'opération que vous pouvez exécuter sur les valeurs du membre est la suivante :

*REPLACE

Le système efface le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Détail (DETAIL)

Indique les détails imprimés ou dirigés vers le fichier base de données. Ce paramètre n'est pas utilisé lorsque la sortie est dirigée vers un affichage (OUTPUT(*)) ou lorsqu'un ID ou un profil utilisateur est indiqué.

*BASIC

La sortie est la liste de tous les ID, adresses et descriptions utilisateur figurant dans le répertoire.

*FULL

La sortie est l'ensemble complet des détails associés à l'utilisateur dans le répertoire. Lorsque USRID(*ALL) est indiqué, la liste imprimée contient une page pour chaque ID et adresse utilisateur du répertoire, avec tous les détails associés à ce poste. Les détails sont associés à plusieurs descriptions d'ID et d'adresse utilisateur. Pour un fichier base de données, un enregistrement est créé pour chaque ID, adresse et description utilisateur, et contient tous les détails de chaque poste. Lorsqu'il existe plusieurs descriptions pour un ID et une adresse utilisateur, la sortie de chaque description est constituée par un enregistrement complet, et seule la zone de description est différente.

Lorsqu'un ID et une adresse utilisateur ou un nom de profil utilisateur sont précisés à un paramètre en entrée, la liste imprimée contient une page de sortie comportant toutes les descriptions avec les détails associés à l'ID et l'adresse utilisateur. Le fichier en sortie contient un enregistrement de détail complet pour chaque description. Seule la zone de description est différente pour les enregistrements.

Format du fichier de sortie (OUTFILFMT)

Indique le format du fichier en sortie.

*TYPE1

Le format est défini par le fichier modèle en sortie QAOSDIRO dans la bibliothèque QSYS, dont le nom de format d'enregistrement est OSDIRE. Ce format n'inclut pas les nouvelles zones de répertoire ajoutées depuis l'Edition 2.0.

*TYPE2

Le format du fichier en sortie est défini par les fichiers modèles en sortie QAOSDIRB et QAOSDIRF dans la bibliothèque QSYS.

Si DETAIL(*BASIC) est indiqué, le fichier en sortie contient uniquement les zones de base, et le fichier modèle en sortie QAOSDIRB est utilisé avec le nom de format d'enregistrement OSDIRB. Si DETAIL(*FULL) est indiqué, le fichier en sortie contient toutes les zones de détail, et le fichier modèle en sortie QAOSDIRF est utilisé avec le format d'enregistrement OSDIRF.

*TYPE3

Le fichier en sortie contient toutes les zones de détail ainsi que le nom d'O/R X.400. Le fichier modèle en sortie QAOSDIRX dans la bibliothèque QSYS est utilisé avec le nom de format d'enregistrement OSDIRX.

Données à sortir (OUTDTA)

Indique le type de données à inclure en tant que sortie de la valeur indiquée au paramètre OUTPUT. Ce paramètre n'est pas utilisé lorsque la sortie est dirigée vers un affichage (OUTPUT(*)) ou lorsqu'un ID ou un profil utilisateur est indiqué.

*LCL

Les données définies localement sont insérées, mais pas les données résultant de la réplication.

*ALL

Toutes les données du poste du répertoire sont insérées, y compris les données définies localement et celles résultant de la réplication.

ID caractères pour commande (CMDCHRID)

Indique l'identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant au paramètre de cette commande. Cet identificateur de caractères (CHRID) est associé à l'unité d'affichage utilisée pour lancer la commande. Pour plus d'informations sur le traitement du CHRID, reportez-vous au manuel Application Display Programming book, SC41-5715.

*SYSVAL

Le système détermine le jeu de caractères graphiques et la page de codes associés aux paramètres de la commande à partir des valeurs système QCHRID.

*DEVD

Le système détermine le jeu de caractères graphiques et la page de codes associés au paramètre de la commande, à partir de la description d'unité d'affichage d'où est lancée la commande. Cette option est admise uniquement si elle est indiquée à partir d'un travail interactif. Si elle est indiquée dans un programme CL interactif ou un travail par lots, un message d'erreur est émis.

La valeur possible pour le jeu de caractères est la suivante :

jeu-caractères-graphiques

Indiquez les valeurs du jeu de caractères graphiques utilisées pour créer les paramètres de la commande. Les valeurs admises sont comprises entre 1 et 9999.

La valeur possible pour la page de codes est la suivante :

page-codes

Indiquez la page de codes. Les valeurs admises sont comprises entre 1 et 9999.

Exemples

Exemple 1 : affichage de l'écran pour une description

DSPDIRE   USRID(HURST NEWYORK)

Cette commande affiche l'écran des détails du poste du répertoire pour l'ID utilisateur et adresse HURST NEWYORK si cet ID utilisateur ne possède qu'une description qui lui est associée. S'il existe plusieurs descriptions, tous les éléments de cet ID utilisateur et de cette adresse sont affichés.

Exemple 2 : impression des renseignements répertoire

DSPDIRE   USER(JONES)  OUTPUT(*PRINT)

Cette commande imprime les détails de répertoire complets concernant le profil utilisateur JONES. S'il existe plusieurs descriptions dans le répertoire pour JONES, la sortie imprimée contient chacune d'entre elles.

Exemple 3 : envoi des détails complets vers un fichier de base de données

DSPDIRE   OUTPUT(*OUTFILE)
          OUTFILE(MYLIB/DIRLIST)  OUTMBR(*FIRST *REPLACE)
          DETAIL(*FULL)

Cette commande envoie un enregistrement vers le fichier de base de données DIRLIST dans la bibliothèque MYLIB pour chaque entrée du répertoire. Cet enregistrement contient les détails complets relatifs à chaque utilisateur. Le format du fichier de sortie est celui qui était utilisé avant la version 3.0 en raison de la valeur par défaut de OUTFILFMT(*TYPE1). Si le fichier n'existe pas déjà, il est créé. Dans le cas contraire, il est remplacé.

Exemple 4 : envoi d'informations de base vers un fichier de base de données

DSPDIRE   OUTPUT(*OUTFILE)
          OUTFILE(MYLIB/DIRLIST)  DETAIL(*BASIC)
          OUTFILFMT(*TYPE2)

Cette commande envoie un enregistrement vers le fichier de base de données DIRLIST dans la bibliothèque MYLIB pour chaque entrée du répertoire. Les données ne contiennent que les champs de base tels que l'ID utilisateur, l'adresse et la description. Si le fichier nommé DIRLIST existe déjà dans la bibliothèque MYLIB pour des données au format de la version 1.0 ou 2.0 (voir Exemple 2), une erreur se produit ; dans le cas contraire, le fichier est créé au format de la version Release 3.0.

Messages d'erreur

Messages *ESCAPE

CPF2204

Profil utilisateur &1 non trouvé.

CPF9006

Utilisateur non inscrit dans le répertoire de distribution du système.

CPF9009

Le fichier &1 de la bibliothèque &2 doit être journalisé.

CPF905C

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

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.