ADDDTADFN

Ajouter définition de données

En bref

La commande ADDDTADFN (Ajouter une définition de données) permet d'ajouter des définitions de fichiers, de formats d'enregistrement et de zones dans un dictionnaire de données à partir d'un fichier base de données à description externe.

ADDDTADFN se lit ADD (Ajouter) + DTADFN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDDTADFN FILE(…) DTADCT(…)

Paramètres

FILE Fichier base de données obligatoire
DTADCT Dictionnaire de données obligatoire
DFN Définition de fichier

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

Lorsqu'une définition est à ajouter à un dictionnaire, le système lance une recherche dans le dictionnaire pour savoir s'il contient une définition du même nom. Si une correspondance exacte est trouvée, la définition existante est utilisée. Sinon, une nouvelle version de la définition est créée.

Les fichiers base de données utilisant les fonctions suivantes ne sont pas ajoutés à un dictionnaire :

Partage du chemin d'accès
Modification de la séquence de classement
Fichiers à description interne
Jointure de fichiers logiques
Utilisation de plus d'un format (fichiers logiques)
Utilisation de spécifications sélection/omission (fichiers logiques)

Seules les définitions de formats et de zones des fichiers base de données utilisant les fonctions suivantes sont ajoutées dans un dictionnaire :

Valeurs de zones par défaut
Codes de contrôle de validité (zones)
Zones clés définies à l'aide de noms provenant de fichiers physiques sous-jacents
Zones extraites

Remarque :Lorsqu'un fichier à ajouter est déjà lié, le lien en cours est supprimé, puis la définition est ajoutée et liée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier base de données	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier base de données	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
DTADCT	Dictionnaire de données	Nom	Obligatoire, positionnel 2
DFN	Définition de fichier	Nom, *FILE	Facultatif, positionnel 3

Fichier base de données (FILE)

Indique le nom et la bibliothèque du fichier base de données à description externe contenant la définition copiée dans le dictionnaire mentionné.

Ce paramètre est obligatoire.

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: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

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

Dictionnaire de données (DTADCT)

Indique le nom du dictionnaire auquel les définitions sont ajoutées. Ce paramètre est obligatoire.

Définition de fichier (DFN)

Indique le nom attribué à la définition de fichier lorsqu'elle est entrée dans le dictionnaire.

Les valeurs possibles sont les suivantes :

*FILE: Le nom de la définition de fichier est identique au nom du fichier base de données indiqué en regard de l'invite Fichier base de données (paramètre FILE).
définition-fichier: Indiquez le nom attribué à la définition de fichier lorsque vous l'entrez dans le dictionnaire.

Exemples

ADDDTADFN   FILE(MYLIB/MYFILE)  DTADCT(MINE)  DFN(*FILE)

Cette commande copie les définitions de MYFILE se trouvant dans la bibliothèque MYLIB dans le dictionnaire MINE. Le nom de la définition de fichier est identique à celui du fichier base de données indiqué dans le paramètre FILE.

Messages d'erreur

Messages *ESCAPE

CPF2E9E: Espace mémoire insuffisant pour ajout au dictionnaire &1.
CPF2FE0: Erreur lors de l'ouverture du dictionnaire &1.
CPF2FE1: Erreur lors de la fermeture du dictionnaire &1.
CPF2FE2: Dictionnaire &1 en cours d'utilisation.
CPF2F02: Vous n'êtes pas autorisé à utiliser le dictionnaire &1.
CPF2F07: Erreur dans le dictionnaire &1.
CPF2F08: Dictionnaire &1 non trouvé.
CPF2F61: Fichier &2 de &3 en cours d'utilisation.
CPF2F72: Fichier &2 de &3 incorrect pour ADDDTADFN.
CPF2F73: Commande ADDDTADFN non admise pour les fichiers base de données SQL.
CPF2F74: Attributs du fichier &2 de &3 non acceptés.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9822: Non autorisé au fichier &1 de &2.