Commande CL IBM i (AS/400)

DSPDTADCT

Afficher dictionnaire données

En bref

La commande DSPDTADCT (Afficher un dictionnaire de données) permet d'afficher ou d'imprimer une définition (de zone, de format d'enregistrement ou de fichier) contenue dans un dictionnaire de données.

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

Syntaxe minimale

DSPDTADCT DTADCT(…)

Paramètres

DTADCT Dictionnaire de données obligatoire
DFN Définition
DFNTYPE Type de définition
OUTPUT Sortie
FILEINF Information fichiers
RCDFMTINF Information formats
FLDINF Information zones
CRTDATE Date de création

Astuce : dans une session 5250, tapez DSPDTADCT 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

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DTADCT	Dictionnaire de données	Nom	Obligatoire, positionnel 1
DFN	Définition	Nom générique, nom, *ALL	Facultatif
DFNTYPE	Type de définition	FILE, RCDFMT, *FLD	Facultatif
OUTPUT	Sortie	, PRINT	Facultatif
FILEINF	Information fichiers	BASIC, DETAIL, EXTENDED, ALL, *NONE	Facultatif
RCDFMTINF	Information formats	BASIC, EXTENDED, ALL, NONE	Facultatif
FLDINF	Information zones	BASIC, DETAIL, EXTENDED, ALL, *NONE	Facultatif
CRTDATE	Date de création	Date, *FIRST	Facultatif

Dictionnaire de données (DTADCT)

Indique le nom du dictionnaire de données qui contient la définition à afficher ou imprimer.

Ce paramètre est obligatoire.

Définition (DFN)

Indique le nom de la définition à afficher ou imprimer.

*ALL: Toutes les définitions correspondant au type indiqué en regard de l'invite Type de définition (paramètre DFNTYPE) sont affichées ou imprimées.
nom-définition: Indiquez le nom de la définition à afficher ou imprimer.
nom-définition-générique*: Indique le nom générique de la définition à afficher ou imprimer. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*). Ainsi, toutes les définitions dont le nom commence par le même préfixe sont affichées ou imprimées.

Type de définition (DFNTYPE)

Indique le type des définitions à afficher ou imprimer.

*FILE: Les définitions de fichier sont affichées ou imprimées. Cette valeur n'est pas admise si *NONE est indiqué en regard de l'invite Information fichiers (paramètre FILEINF).
*FLD: Les définitions de zone sont affichées ou imprimées. Cette valeur n'est pas admise si *NONE est indiqué en regard de l'invite Information zones (paramètre FLDINF).
*RCDFMT: Les définitions de format d'enregistrement sont affichées ou imprimées. Cette valeur n'est pas admise si *NONE est indiqué en regard de l'invite Information formats (paramètre RCDFMTINF).

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 pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.

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

Information fichiers (FILEINF)

Indique le niveau des informations, relatives à la définition de fichier, qui sont affichées ou imprimées.

*BASIC

Les informations de base suivantes sont affichées ou imprimées :

le nom de la définition
le type de la définition
le dictionnaire contenant la définition
la date de création de la définition
l'ID utilisateur de la personne qui l'a créée
la date de la dernière modification
l'ID utilisateur de l'auteur de la dernière modification
le texte de la définition
le nombre de définitions de format d'enregistrement utilisées par cette définition de fichier

*DETAIL

Les informations de base, tout comme les informations concernant une zone clé, sont affichées ou imprimées.

*EXTENDED

Les informations détaillées ainsi que tout commentaire développé concernant la définition de fichier sont affichés ou imprimés.

*ALL

Les informations complètes ainsi qu'une liste des fichiers utilisant cette définition sont affichées ou imprimées.

*NONE

Aucune information détaillée relative à la définition de fichier n'est imprimée ni affichée lorsque *RCDFMT ou *FLD est indiqué en regard de l'invite Type de définition (paramètre DFNTYPE).

Information formats (RCDFMTINF)

Indique le niveau de détail des informations relatives au format d'enregistrement qui sont imprimées ou affichées.

*BASIC

Les informations de base suivantes sont affichées ou imprimées :

le nom de la définition
le type de la définition
le dictionnaire contenant la définition
la date de création de la définition
l'ID utilisateur de la personne qui l'a créée
la date de la dernière modification
l'ID utilisateur de l'auteur de la dernière modification
le texte de la définition
le nombre de définitions de zones utilisées par cette définition de format d'enregistrement
la longueur du format

*EXTENDED

Les informations de base et un commentaire développé concernant la définition de format d'enregistrement sont affichés ou imprimés.

*ALL

Les informations complètes, les codes d'ID d'enregistrements, une liste des définitions de fichiers et des fichiers utilisant cette définition de format d'enregistrement sont affichés ou imprimés.

*NONE

Lorsque *NONE est indiqué, et lorsque *FILE figure en regard de l'invite Type de définition (paramètre DFNTYPE), aucune information détaillée relative aux définitions de formats d'enregistrement dans un format de fichier n'est imprimée ou affichée. *NONE n'est pas admis lorsque *RCDFMT est mentionné en regard de l'invite Type de définition (paramètre DFNTYPE). Lorsque *FLD figure en regard de l'invite Type de définition (paramètre DFNTYPE), aucune information relative à une définition de format d'enregistrement n'est affichée ou imprimée.

Information zones (FLDINF)

Indique le niveau de détail des informations relatives à la description de zone qui sont imprimées ou affichées.

*BASIC

Les informations de base suivantes sont affichées ou imprimées :

le nom de la définition
le type de la définition
le dictionnaire contenant la définition
le texte de la définition
le type de données
la longueur de zone
la taille de la mémoire tampon
la position de la mémoire tampon
l'utilisation de la zone
les en-têtes de colonne

*DETAIL

Les informations de base sont accompagnées des renseignements suivants :

la date de création de la définition
l'ID utilisateur de la personne qui l'a créée
la date de la dernière modification
l'ID utilisateur de l'auteur de la dernière modification
le nom d'alias
les informations d'édition

*EXTENDED

Les informations détaillées et un commentaire développé relatif à la définition de zone sont affichés.

*ALL

Les informations précédentes et une liste de définitions et de fichiers utilisant cette définition sont affichées ou imprimées.

*NONE

Aucune information détaillée concernant la définition de zone dans une définition de format d'enregistrement n'est affichée ou imprimée lorsque *FILE ou *RCDFMT figure en regard de l'invite Type de définition (paramètre DFNTYPE). Ce paramètre n'est pas admis lorsque *FLD est mentionné en regard de l'invite Type de définition (paramètre DFNTYPE).

Date de création (CRTDATE)

Indique la date de création de la définition.

*FIRST: La première définition créée sous ce nom est affichée ou imprimée. S'il existe plusieurs définitions dont le nom et la date de création sont identiques et si un nom figure en regard de l'invite Définition (paramètre DFN), seule la première définition associée à la date de création mentionnée est affichée ou imprimée. Lorsqu'un nom générique ou *ALL est indiqué, l'invite Date de création (paramètre CRTDATE) n'est pas prise en compte et toutes les définitions correspondant à l'invite Définition (paramètre DFN) sont affichées ou imprimées.
date: Indiquez la date de création de la définition de fichier à afficher ou imprimer.

Exemples

DSPDTADCT   DTADCT(MINE)  DFN(*ALL)  DFNTYPE(*FILE)
            OUTPUT(*PRINT)  FILEINF(*BASIC)  RCDFMTINF(*BASIC)
            FLDINF(*EXTENDED)

Cette commande imprime toutes les définitions de fichier dans le dictionnaire de données MINE. Les informations de base relatives aux définitions de fichier sont imprimées. Les informations de base relatives aux définitions de format de chaque définition de fichier, et les informations détaillées relatives aux définitions de zone de chaque définition de format RECORD des définitions de fichier sont imprimées.

Messages d'erreur

Messages *ESCAPE

CPF2DAA: Imprimante &1 introuvable.
CPF2DAC: Vous n'êtes pas autorisé à utiliser l'imprimante &4.
CPF2DAD: Imprimante &4 non disponible actuellement.
CPF2D76: Un nom ne peut pas contenir d'astérisque (*) intercalaire.
CPF2E9B: Définition &1 non trouvée.
CPF2F02: Vous n'êtes pas autorisé à utiliser le dictionnaire &1.
CPF2F08: Dictionnaire &1 non trouvé.
CPF3012: Fichier &1 non trouvé dans bibliothèque &2.
CPF3014: Impossible d'afficher fichier &1 de &2.
CPF3024: SYSTEM(&3) incompatible avec fichier &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.
CPF3074: Non autorisé à utiliser la bibliothèque &1.
CPF3076: Une erreur s'est produite en cours d'affichage.
CPF3077: Une erreur s'est produite lors de l'annulation de l'affichage.
CPF4253: Non autorisé à la file d'attente en sortie pour l'unité &6.
CPF9850: Substitution non admise pour fichier imprimante &1.
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.