DSPFFD

La commande DSPFFD (Afficher description des zones) permet d'afficher, d'imprimer ou de placer dans un fichier base de données des informations au niveau des zones d'un ou de plusieurs fichiers d'une bibliothèque spécifique ou de toutes les bibliothèques accessibles à l'utilisateur.

Si les informations sont placées dans un fichier base de données, ce dernier aura un format d'enregistrement intitulé QWHDRFFD. Les zones du format d'enregistrement QWHDRFFD sont identiques aux zones du format QWHDRFFD fourni par IBM dans le fichier QADSPFFD de la bibliothèque QSYS. Les informations suivantes sont contenues dans le fichier base de données.

• Pour chaque fichier indiqué dans la commande, l'enregistrement de base de données contient :
  • Le nom du fichier, le nom de la bibliothèque contenant le fichier, ainsi que le type et le membre du fichier.
  • La date de création du fichier et le nombre des formats d'enregistrement du fichier.
  • Le nom du format d'enregistrement utilisé par le fichier, l'identificateur de niveau, la description de texte, la longueur d'enregistrement et le nombre de zones du format.
  • La date et l'heure d'extraction des informations.
• Pour chaque zone du format d'enregistrement, l'enregistrement contient également les éléments suivants, le cas échéant :
  • Le nom de la zone et le nom de la zone externe.
  • Le type et la longueur de la zone.
  • Le nom du fichier référencé, le format d'enregistrement et la zone en ce qui concerne les zones qui référencent d'autres zones ; si des attributs de la zone référencée ont été modifiés, le type d'attribut est indiqué.
  • Le code d'édition, le mot d'édition et les en-têtes de colonne associés à la zone.
  • Un signal indiquant si le contrôle de validité est effectué sur la zone.
  • L'identificateur de message du contrôle de validité, le fichier message et la bibliothèque.
  • L'utilisation de la zone.

Restrictions :

• Pour créer un OUTFILE, vous devez disposer du droit d'utilisation (*USE) sur la commande CRTPF (Créer un fichier physique) et du droit d'ajout (*ADD) sur la bibliothèque. Pour utiliser un OUTFILE existant, l'utilisateur doit disposer du droit opérationnel sur l'objet (*OBJOPR) et du droit d'ajout (*ADD) sur le fichier.
• Vous devez disposer du droit de gestion des objets (*OBJMGT) et du droit de suppression (*DLT) si *REPLACE est indiqué pour le membre fichier de sortie et si le membre fichier existe déjà.
• Vous devez disposer du droit *OBJOPR sur le fichier indiqué au paramètre FILE. De même, les bibliothèques sont recherchées uniquement dans celles pour lesquelles vous disposez du droit d'exécution (*EXECUTE). Ces bibliothèques font partie de celles indiquées par le qualificatif de bibliothèque.

Paramètres

Fichier (FILE)

Indique les fichiers pour lesquels les informations de zone sont renvoyées.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

*ALL

Permet d'afficher les informations sur tous les fichiers contenus dans la ou les bibliothèques.

nom

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

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

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.

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

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

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

*ALL

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

nom

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

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

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 :Le format du fichier de sortie doit être identique à QWHDRFFD du fichier système QADSPFFD. Pour plus d'informations sur le format du fichier de sortie, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

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.

*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 des informations concernant un fichier sur le système local

DSPFFD   FILE(LIB1/FILE2)

Cette commande permet d'afficher des informations de niveau zone concernant le fichier FILE2 de LIB1 sur le système local. Ces informations s'affichent sur le poste de travail sur lequel a été entré la commande.

Exemple 2 : Affichage des informations concernant des fichiers sur les systèmes locaux et éloignés

DSPFFD   FILE(*ALL/*ALL)  SYSTEM(*ALL)

Cette commande permet d'afficher des informations de niveau zone concernant tous les fichiers des 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 de gestion de données réparties, l'écran n'affiche que les informations concernant le fichier distant nommé au RMTFILE de la commande CRTDDMF. Ces informations s'affichent sur le poste de travail sur lequel a été entré la commande.

Exemple 3 : Acheminement d'une sortie vers un fichier base de données

DSPFFD   FILE(QGPL/FLDREF)  OUTPUT(*OUTFILE)
         OUTFILE(QGPL/FLDREFX)

Cette permet de placer les informations de niveau zone concernant le fichier FLDREF de la bibliothèque QGPL sur le système local dans un fichier base de données nommé FLDREFX de la bibliothèque générale QGPL. Le fichier FLDREFX de la bibliothèque QGPL peut ensuite être traité par un programme.

Messages d'erreur

Messages *ESCAPE

CPF3012

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

CPF3014

Impossible d'afficher fichier &1 de &2.

CPF3024

SYSTEM(&3) incompatible avec fichier &1.

CPF3052

Description du fichier &1 non disponible.

CPF3061

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

CPF3063

Le fichier de sortie &1 dans &2 n'est pas un fichier physique.

CPF3064

Bibliothèque &1 introuvable.

CPF3066

Erreur lors de la création du fichier de sortie &1 dans &2.

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.