DSPRDBDIRE

Afficher postes répertoire RDB

En bref

La commande DSPRDBDIRE permet d'afficher un seul poste, des postes génériques ou tous les postes figurant dans le répertoire des bases de données relationnelles (RDB).

DSPRDBDIRE se lit DSP (Afficher) + RDBDIRE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPRDBDIRE

Paramètres

RDB Poste
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPRDBDIRE puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande DSPRDBDIRE permet d'afficher un seul poste, des postes génériques ou tous les postes figurant dans le répertoire des bases de données relationnelles (RDB).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RDB	Poste	Nom générique, nom, *ALL	Facultatif, positionnel 1
OUTPUT	Sortie	, PRINT, *OUTFILE	Facultatif, positionnel 2
OUTFILE	Fichier recevant la sortie	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Fichier recevant la sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OUTMBR	Options pour membre de sortie	Liste d'éléments	Facultatif
	Élément 1: Membre recevant la sortie	Nom, *FIRST
	Élément 2: Remplacement ou ajout enregs	REPLACE, ADD

Poste (RDB)

Indique le poste du répertoire des bases de données relationnelles. Si un poste n'a pas d'alias, le nom de poste utilisé est le nom de la base de données relationnelle. Dans le cas contraire, l'alias est utilisé comme nom de poste.

*ALL: Tous les postes du répertoire des bases de données relationnelles.
nom-générique: Indiquez le nom générique des postes de la base de données relationnelle. Un nom générique est une chaîne d'un ou de plusieurs caractères suivi(s) d'un astérisque (*).
nom: Indiquez le nom du poste du répertoire des bases de données relationnelles.

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 (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 envoyée vers un fichier en sortie.

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données vers lequel le résultat de la commande est dirigé. 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).

Si un nouveau fichier est créé, le fichier système QADSPDE de la bibliothèque système QSYS ayant RWRDDSP pour nom de format d'enregistrement est utilisé comme modèle. Si ce fichier existe déjà, il doit avoir le même format.

Qualificatif 1 : Fichier recevant la sortie

nom: Indiquez le nom du fichier base de données dans lequel s'inscrit la sortie de la commande.

Qualificateur 2: Biblio

*LIBL: La liste des bibliothèques est utilisée pour localiser le fichier. Si le fichier est introuvable, il en est créé 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: La bibliothèque en cours pour l'unité d'exécution est 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.

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.

Exemples

Exemple 1 : Envoi d'informations vers un fichier spoule

DSPRDBDIRE   OUTPUT(*PRINT)

Cette commande permet de diriger des informations vers un fichier spoule depuis tous les postes du répertoire des bases de données relationnelles.

Exemple 2 : Envoi d'informations à un fichier base de données

DSPRDBDIRE   OUTPUT(*OUTFILE)  OUTFILE(SAVEDIR)

Cette commande permet de diriger vers un fichier en sortie nommé SAVEDIR tous les postes du répertoire des bases de données relationnelles. Il s'agit de la méthode habituelle pour sauvegarder le contenu du répertoire des bases de données relationnelles. Les postes peuvent être restaurés à l'aide d'un programme CL qui lit les informations du fichier en sortie et émet des commandes ADDRDBDIRE (Ajouter un poste au répertoire RDB) pour replacer les informations dans le répertoire des bases de données relationnelles.

Messages d'erreur

*ESCAPE Messages

CPF3EC3: Poste du répertoire des bases de données relationnelles non affiché.