DSPDBR

La commande DSPDBR (Afficher les relations de base de données) fournit des informations sur les relations qui existent dans les fichiers base de données. Elle permet d'identifier les fichiers physiques et logiques qui dépendent d'un fichier spécifique, les fichiers qui utilisent le même format d'enregistrement, ou les membres de fichiers associés à un membre donné. Ces informations peuvent être affichées, imprimées ou stockées dans un fichier base de données en sortie. Cette commande ne s'applique pas aux fichiers unité.

Si les informations sont placées dans un fichier base de données en sortie, le format d'enregistrement utilisé est intitulé QWHDRDBR. Les zones du format d'enregistrement QWHDRDBR sont identiques aux zones du format QWHDRDBR fourni par IBM dans le fichier QADSPDBR de la bibliothèque QSYS. Les informations suivantes sont contenues dans le fichier base de données en sortie :

• Pour chaque fichier indiqué dans la commande, l'enregistrement de base de données contient :
  • Le nom, le nom de bibliothèque et le type du fichier indiqué.
  • Le nom du format d'enregistrement utilisé pour le fichier, si un nom est indiqué pour RCDFMT.
  • La ou les dates d'extraction des informations relatives au fichier ; la date la plus récente contient les informations les plus exactes si des modifications ont été apportées aux fichiers.
• L'un des éléments suivants est également inclus dans l'enregistrement.
  • Le nom de tous les fichiers qui sont dépendants du fichier indiqué quant au partage du chemin d'accès ou des données ; le nom des bibliothèques contenant les fichiers et le type de partage sont également inclus.
  • Le nom de tous les membres de fichier qui sont dépendants du membre indiqué, le nom des bibliothèques associées et le type de partage.
  • Le nom de tous les fichiers qui sont dépendants du format d'enregistrement indiqué et le nom des bibliothèques associées.

Restrictions :

• Pour afficher chaque fichier indiqué, vous devez disposer du droit opérationnel sur l'objet (*OBJOPR) pour le fichier. De même, les fichiers sont recherchés uniquement dans les bibliothèques pour lesquelles l'utilisateur dispose du droit d'exécution (*EXECUTE). Ces bibliothèques font partie de celles indiquées par le qualificatif de bibliothèque.
• 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, vous devez disposer des droits *OBJOPR et *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à.

Paramètres

Fichier (FILE)

Indique les fichiers dont les informations relationnelles doivent être affichées, imprimées ou stockées dans un fichier de sortie.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

*ALL

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

nom

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

nom-générique

Indiquez un nom générique pour obtenir les informations concernant tous les fichiers base de données dont le nom commence par ces caractères.

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 à QWHDRDBR du fichier système QADSPDBR dans la bibliothèque QSYS. 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.

Membre (MBR)

Indique le membre de fichier base de données dont les informations de dépendance doivent être affichées, imprimées ou stockées dans un fichier de sortie.

*NONE

Aucune information sur les membres de fichier n'est fournie.

nom

Indiquez le nom entier du membre pour obtenir les informations correspondantes. Dans ce cas, n'indiquez rien pour le paramètre Format d'enregistrement (RCDFMT)

Format d'enregistrement (RCDFMT)

Indique le format d'enregistrement pour lequel les informations de dépendance doivent être affichées, imprimées ou stockées dans un fichier de sortie. Si ce paramètre est défini, aucun nom de membre ne peut être indiqué au paramètre Membre (MBR)

*NONE

Aucune information relative au format d'enregistrement n'est affichée.

*ALL

Fournit des informations sur tous les formats d'enregistrement partagés des fichiers indiqués.

nom

Indiquez le nom entier du format d'enregistrement pour obtenir les informations correspondantes.

nom-générique

Indiquez un nom générique. Fournit des informations sur tous les formats d'enregistrement dont le nom commence par les caractères indiqués.

Exemples

Dans les exemples qui suivent, l'on suppose que l'environnement est interactif et que l'utilisateur de la commande est autorisé à accéder à toutes les bibliothèques et tous les objets requis.

Exemple 1 : Affichage des informations relatives aux relations de base de données

DSPDBR   FILE(LIBRARY1/FILE1)  RCDFMT(FORMAT1)

Cette commande permet d'afficher une liste de noms et des informations sur les relations de base de données qui utilisent le format FORMAT1 et sont associés au fichier FILE1 dans LIBRARY1. L'environnement état interactif, la sortie s'affiche sur le poste de travail qui exécute la commande.

Exemple 2 : Affichage des informations relatives aux relations de base de données

DSPDBR   FILE(LIB1/FILE1)

Cette commande permet d'afficher les informations sur les relations de base de données pour tous les fichiers qui dépendent de FILE1 dans LIB1 pour le partage de données. Sa sortie s'affiche sur le poste de travail qui exécute la commande.

Exemple 3 : Affichage des informations relatives aux relations de base de données

DSPDBR   FILE(LIB1/FILE1)  MBR(MEMBER1)

Cette commande permet d'afficher les informations sur les relations de base de données pour tous les fichiers qui dépendent de MEMBER1 dans FILE1 de LIB1 pour le partage de données ou le partage de chemin d'accès. Sa sortie s'affiche sur le poste de travail qui exécute la commande.

Messages d'erreur

Messages *ESCAPE

CPF3010

Aucun fichier base de données trouvé pour &1 de &2.

CPF3012

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

CPF3014

Impossible d'afficher fichier &1 de &2.

CPF3028

Format d'enreg &1 non trouvé dans fichier &2.

CPF3029

Membre &1 non trouvé dans fichier &2 de &3.

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.