DSPFLR

La commande DSPFLR (Afficher un dossier) permet d'afficher ou d'imprimer une liste de dossiers et de documents, ou de créer un fichier de sortie contenant une telle liste.

Paramètres

Dossier (FLR)

Nom des dossiers ou des membres figurant sur la liste.

*ALL

La liste comprend tous les dossiers que l'utilisateur a le droit de consulter.

nom-du-dossier

Indiquez le nom du dossier dont le contenu fait partie de la liste.

Type d'objet (TYPE)

Indique si la liste comporte des dossiers ou des documents.

*FLR

La liste comprend les dossiers que l'utilisateur a le droit de consulter.

*DOC

La liste comprend les documents que l'utilisateur a le droit de consulter.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*

La sortie est affichée.

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Niveau de liste (LEVEL)

Indique si la liste comprend les dossiers emboîtés dans ceux qui font partie de la liste, ou seulement les dossiers du niveau en cours. Ce paramètre n'est pas admis lorsque (*) est indiqué à la zone Sortie (paramètre OUTPUT).

*ALL

La liste comprend les dossiers emboîtés dans ceux du niveau indiqué.

*CURRENT

Seuls les dossiers du niveau indiqué font partie de la liste.

Fichier recevant la sortie (OUTFILE)

Nom et bibliothèque du fichier base de données recevant la sortie de la commande. Si ce fichier n'existe pas, cette commande le crée dans la bibliothèque indiquée.

Pour la bibliothèque, les valeurs possibles sont :

*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 est recherché dans la bibliothèque en cours pour le travail. Si aucune bibliothèque n'a été indiquée comme bibliothèque en cours pour le travail, la bibliothèque QGPL est utilisée.

nom-de-la-bibliothèque

Indiquez le nom de la bibliothèque où se trouve le fichier.

Remarque :Si vous indiquez *FLR à la zone Type d'objet (paramètre TYPE) et qu'un nouveau fichier soit créé, le système utilise comme modèle le fichier QADSPFLR de la bibliothèque QSYS avec le nom de format FLRDTL.

Si vous indiquez *DOC à la zone Type d'objet (paramètre TYPE) et qu'un nouveau fichier soit créé, le système utilise comme modèle le fichier QADSPDOC de la bibliothèque QSYS avec le nom de format DOCDTL.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Les valeurs possibles à la zone Membre recevant la sortiesont :

*FIRST

Le premier membre du fichier reçoit la sortie. S'il n'existe pas, le système crée un membre portant le nom du fichier indiqué à la zone Fichier recevant la sortie (paramètre OUTFILE).

nom-du-membre

Indiquez le nom du membre de fichier devant recevoir la sortie. S'il n'existe pas, le système le crée.

Les valeurs possibles à la zone Remplacement ou ajout enregs sont :

*REPLACE

Les données de sortie remplacent les enregistrements existants dans le membre indiqué.

*ADD

Les données de sortie sont ajoutées à la suite des enregistrements existants dans le membre indiqué.

Format du fichier de sortie (OUTFILFMT)

Indique le format du fichier base de données vers lequel la sortie de l'écran est dirigée.

*TYPE1

La sortie est dirigée vers le format de fichier utilisé pour la version 2, édition 2 (V2R2) et toutes les éditions antérieures. Le format utilisé est défini par les fichiers de sortie modèles QADSPSDC (Format de document) et QADSPSFR (Format de dossier) de la bibliothèque QSYS dont les enregistrements sont respectivement DOCDTLS et FLRDTLS.

*TYPE2

La sortie est dirigée vers le format de fichier utilisé pour la version 2, édition 3 (V2R3) et toutes les éditions suivantes. Le format utilisé est défini par les fichiers de sortie modèles QADSPDOC (Format de document) et QADSPFLR (Format de dossier) de la bibliothèque QSYS dont les enregistrements sont respectivement DOCDTL et FLRDTL.

Exemples

Exemple 1 : affichage ou impression d'une sortie

DSPFLR   FLR(GENERAL)  TYPE(*FLR)  OUTPUT(*)

Cette commande permet d'afficher une liste de dossiers pour le dossier GENERAL sur le poste de travail demandeur (si la demande provient d'un travail interactif). De manière alternative, la sortie est imprimée avec la sortie spoule du travail (si la demande provient d'un travail par lots).

Exemple 2 : direction de la sortie vers un fichier de base de données

DSPFLR   FLR(*ALL)  TYPE(*FLR)  OUTPUT(*OUTFILE)  LEVEL(*ALL)
         OUTFILE(MYLIB/MYFILE) OUTMBR(MYMBR *REPLACE)

Cette commande permet d'afficher les dossiers que l'utilisateur a le droit de consulter. La sortie est dirigée vers MYMBR, dans MYFILE, situé dans la bibliothèque MYLIB. Si le membre MYMBR existe déjà, MYMBR est supprimé et les nouveaux enregistrements sont ajoutés.

Messages d'erreur

Aucun