DSPFD

La commande DSPFD (Afficher description fichier) permet d'afficher un ou plusieurs types d'informations extraites des descriptions de fichier d'un ou de plusieurs fichiers base de données et/ou unité. Ces informations sont fournies pour chaque fichier qui porte le nom indiqué et qui figure dans les bibliothèques désignées dans le qualificatif de bibliothèque indiqué auquel l'utilisateur a accès. Les informations peuvent être affichées, imprimées ou dirigées vers un fichier base de données en sortie (OUTFILE). Pour plus de détails sur les fichiers utilisés par la commande DSPFD, consultez le manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

1. Avant d'afficher les fichiers indiqués, l'utilisateur doit disposer du droit d'opération sur l'objet pour ces fichiers.
2. Les fichiers indiqués sont recherchés uniquement dans les bibliothèques sur lesquelles l'utilisateur dispose du droit de lecture. Ces bibliothèques font partie de celles identifiées par le qualificatif de bibliothèque.
3. Si TYPE(*ALL), TYPE(*MBR) ou TYPE(*MBRLIST) est indiqué et qu'il s'agit d'un fichier physique, l'utilisateur requiert au moins un droit sur les données (lecture, écriture, mise à jour ou suppression) pour le fichier, afin de recevoir des informations sur les membres.

Paramètres

Fichier (FILE)

Indique le nom et la bibliothèque des fichiers.

Ce paramètre est obligatoire.

Les valeurs possibles pour les noms de fichiers sont les suivantes :

nom-fichier

Indiquez le nom complet d'un fichier pour obtenir les informations correspondantes.

nom-fichier-générique*

Indiquez un nom générique. Des informations sont fournies pour tous les fichiers dont le nom commence par les caractères indiqués.

*ALL

Fournit les informations sur tous les fichiers de la ou des bibliothèques.

Qualificatif 2: Biblio

*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.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Type d'information (TYPE)

Indique le type d'informations fournies sur le fichier. *ALL n'est admis que si les informations sont destinées à être affichées ou imprimées. *BASATR n'est admis que si elles sont destinées à être stockées dans un fichier base de données en sortie. Pour les autres paramètres, plusieurs valeurs peuvent être indiquées dans le premier cas (affichage ou impression) et une seule uniquement dans le second (fichier base de données).

Les valeurs possibles sont les suivantes :

*ALL

Toutes les informations relatives aux fichiers définis sont affichées ou imprimées.

Remarque :Vous ne pouvez pas indiquer *ALL si un nom de fichier est indiqué dans le paramètre OUTFILE.

*BASATR

Les informations d'attribut de niveau de fichier, relatives à tous les fichiers, sont affichées.

*ATR

Fournit les informations sur les principaux attributs du fichier indiqué.

*ACCPTH

Fournit les chemins d'accès pour les fichiers physiques et logiques, ainsi qu'une description de la clé composée pour les chemins d'accès par clé.

*MBRLIST

Fournit la liste alphabétique et une brève description de tous les membres du fichier indiqué.

*SELECT

Fournit l'attribut de sélection/omission pour les fichiers logiques.

*SEQ

Fournit la séquence de classement des fichiers physiques et logiques.

*RCDFMT

Fournit des informations telles que le nom et le niveau sur tous les formats d'enregistrement du fichier.

*MBR

Fournit les informations concernant les membres des fichiers physiques et logiques.

*SPOOL

Fournit les attributs du fichier spoule pour le fichier disquette ou imprimante indiqué.

*JOIN

Fournit des informations concernant la jonction des fichiers logiques (fichiers départ et arrivée) et les zones concernées par la jonction.

*TRG

Fournit le nombre de programmes de déclenchement, le nom et la bibliothèque de chacun d'entre eux, les événements et moments de déclenchement, et les conditions de déclenchement en mise à jour pour chaque fichier doté d'un déclencheur. Le format du fichier en sortie est le format QWHFDTRG du fichier modèle QAFDTRG.

*CST

Pour les fichiers physiques uniquement, fournit des informations concernant les associations de contrainte liées à chaque fichier. Le format du fichier en sortie est le format QWHFDCST du fichier modèle QAFDCST.

*NODGRP

Pour les fichiers physiques répartis uniquement, fournit les informations relatives à la partition des données et à la base de données relationnelle copiées à partir d'un groupe de noeuds (*NODGRP) lorsque le fichier a été créé. Le format du fichier en sortie est le format QWHFDNGP du fichier modèle QAFDNGP.

Sortie (OUTPUT)

Indique la destination de la sortie générée par la commande.

*

La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).

*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).

Attributs de fichier (FILEATR)

Indique le type du fichier dont les attributs sont affichés. Les seuls paramètres acceptés pour les fichiers éloignés sont *PF, *LF ou *ALL.

Les valeurs possibles sont les suivantes :

*ALL

Fournit les attributs de tous les fichiers. Ce paramètre n'est pas permis, si vous avez répondu par *OUTFILE à l'invite Sortie (paramètre OUTPUT) et par *ATR en réponse à l'invite Type d'information (paramètre TYPE).

*DSPF

Fournit les attributs des fichiers écran.

*PRTF

Fournit les attributs des fichiers imprimante.

*DKTF

Fournit les attributs des fichiers disquette.

*TAPF

Fournit les attributs des fichiers bande.

*CMNF

Fournit les attributs des fichiers de communications.

*BSCF

Fournit les attributs des fichiers BSC.

*MXDF

Fournit les attributs des fichiers mixtes.

*PF

Fournit les attributs des fichiers physiques.

*LF

Fournit les attributs des fichiers logiques.

*ICFF

Fournit les attributs des fichiers ICF.

*SAVF

Fournit les attributs des fichiers sauvegarde.

*DDMF

Fournit les attributs des fichiers DDM.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).

Qualificatif 1 : Fichier recevant la sortie

nom

Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificateur 2: Biblio

*LIBL

Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.

*CURLIB

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Remarque :Si un nouveau fichier est créé, le système prend pour modèle l'un des fichiers de sortie de QSYS avec l'un des noms de format énumérés ci-dessous, selon les valeurs figurant en regard des invites Type d'information (paramètre TYPE) et Attributs de fichier (paramètre FILATR). Pour obtenir des informations complémentaires sur le format OUTFILE, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Paramètres de commande          Fichier de sortie créé
TYPE         FILEATR            OUTFILE     FORMAT
*BASATR      Note 1             QAFDBASI    QWHFDBAS
*ATR         *BSCF              QAFDBSC     QWHFDBSC
*ATR         *CMNF              QAFDCMN     QWHFDCMN
*ATR         *DSPF              QAFDDSP     QWHFDDSP
*ATR         *PRTF              QAFDPRT     QWHFDPRT
*ATR         *DKTF              QAFDDKT     QWHFDDKT
*ATR         *TAPF              QAFDTAP     QWHFDTAP
*ATR         *PF                QAFDPHY     QWHFDPHY
*ATR         *LF                QAFDLGL     QWHFDLGL
*ATR         *ICFF              QAFDICF     QWHFDICF
*ATR         *SAVF              QAFDSAV     QWHFDSAV
*ATR         *DDMF              QAFDDDM     QWHFDDDM
*ACCPTH      Note 2             QAFDACCP    QWHFDACP
*SELECT      Note 3             QAFDSELO    QWHFDSO
*SEQ         Note 2             QAFDCSEQ    QWHFDSEQ
*MBR         Note 2             QAFDMBR     QWHFDMBR
*SPOOL       Note 4             QAFDSPOL    QWHFDSPL
*RCDFMT      Note 1             QAFDRFMT    QWHFDFMT
*MBRLIST     Note 2             QAFDMBRL    QWHFDML
*JOIN        Note 5             QAFDJOIN    QWHFDJN

Remarque :Indiquez le paramètre FILEATR uniquement lorsque la valeur TYPE(*ATR) est utilisée. La valeur par défaut FILEATR(*ALL) est admise pour toutes les autres valeurs de TYPE si les types de fichiers requis correspondent à la demande.

• Une valeur ou plusieurs valeurs peuvent être indiquées pour le paramètre FILEATR.
• Uniquement pour les fichiers physiques et logiques.
• Uniquement pour les fichiers logiques.
• Uniquement pour les fichiers unité.
• Uniquement pour les fichiers logiques joints.

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.

Elément 1 : Membre recevant la sortie

*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 en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

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

Système (SYSTEM)

Indique si les informations reçues portent sur des fichiers du système local ou de systèmes éloignés.

Les valeurs possibles sont les suivantes :

*LCL

Les informations reçues portent uniquement sur des fichiers locaux.

*RMT

Les informations reçues portent uniquement sur des fichiers éloignés.

*ALL

Les informations reçues portent à la fois sur des fichiers locaux et éloignés.

Exemples

Exemple 1 : Affichage de la définition d'un fichier

DSPFD   FILE(*ALL/FILE1)

Cette commande permet d'afficher la définition du fichier FILE1 telle qu'elle figure dans les bibliothèques autorisées pour l'utilisateur sur le système local. Les informations s'affichent sur le poste de travail qui exécute la commande.

Exemple 2 : Affichage des attribut d'affichage d'un fichier DDM local

DSPFD   FILE(LIBRARY1/FILE1)

Cette commande permet d'afficher la définition du fichier FILE1 telle qu'elle figure dans la bibliothèque LIBRARY1. Si FILE1 est un fichier DDM, seuls les attributs de ce fichier sont affichés sur le poste de travail qui exécute la commande.

Exemple 3 : Affichage de la définition de tous les fichiers

DSPFD   FILE(*ALL/*ALL)  TYPE(*ALL)  SYSTEM(*ALL)

Cette commande permet d'afficher la définition de tous les fichiers de toutes les bibliothèques sur lesquelles l'utilisateur dispose de droits sur le système local et sur tous les systèmes éloignés. Pour les fichiers DDM, l'écran affiche d'abord les informations concernant le fichier DDM local, puis, le cas échéant, les informations concernant le fichier distant nommé au paramètre RMTFILE de la commande CRTDDMF. Les informations s'affichent sur le poste de travail qui exécute la commande.

Messages d'erreur

Messages *ESCAPE

CPF3011

TYPE non trouvé pour fichier &1 dans bibliothèque &2.

CPF3012

Fichier &1 non trouvé dans bibliothèque &2.

CPF3014

Impossible d'afficher fichier &1 de &2.

CPF3020

Aucun fichier &1 de &2 n'a les attributs indiqués (FILEATR).

CPF3021

Fichier &1 incompatible avec SYSTEM(*RMT).

CPF3022

SYSTEM(*RMT) non admis pour fichiers &1 de &2.

CPF3030

&3 enregistrements ajoutés au membre &4 du fichier &1 de &2.

CPF3061

Format d'enreg &3 non trouvé pour fichier de sortie &1.

CPF3064

Bibliothèque &1 introuvable.

CPF3067

Erreur lors de l'ouverture du fichier &1 de &2.

CPF3068

Erreur lors de l'écriture dans le fichier &1 de &2.

CPF3069

Erreur lors de la fermeture du fichier &1 de &2.

CPF3070

Erreur lors de la création du membre &3 dans le fichier &1.

CPF3072

&1 de &2 est un fichier système.

CPF3074

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

CPF3075

Bibliothèque &1 non disponible.

CPF3076

Une erreur s'est produite en cours d'affichage.

CPF3077

Une erreur s'est produite lors de l'annulation de l'affichage.

CPF3084

Erreur lors de la remise à blanc du membre &3 du fichier &1.

CPF326B

Fichier &1 de la bibliothèque &2 endommagé.

CPF9851

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

CPF9852

Largeur de page insuffisante pour le fichier &1 de &2.

CPF9899

Erreur lors du traitement de la commande.