LNKDTADFN

Lier/délier définition données

En bref

La commande LNKDTADFN (Lier/délier une définition de données) permet de lier ou de délier des définitions de fichiers dans un dictionnaire et dans des fichiers à description interne ou externe.

Syntaxe minimale

LNKDTADFN OPTION(…) FILE(…)

Paramètres

OPTION Option obligatoire
FILE Fichier base de données obligatoire
DTADCT Dictionnaire de données
DFN Définition de fichier
CRTDATE Date de création

Astuce : dans une session 5250, tapez LNKDTADFN 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 LNKDTADFN (Lier/délier une définition de données) permet de lier ou de délier des définitions de fichiers dans un dictionnaire et dans des fichiers à description interne ou externe.

Restriction : Vous ne pouvez pas lier un fichier déjà lié. En revanche, une définition peut être liée à plusieurs fichiers simultanément.

Remarque :Si le texte du fichier et la définition de fichier ne sont pas identiques, une nouvelle version de la définition est créée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OPTION	Option	LINK, UNLINK	Obligatoire, positionnel 1
FILE	Fichier base de données	Valeurs uniques: ALL Autres valeurs: Nom d'objet qualifié*	Obligatoire, positionnel 2
	Qualificatif 1: Fichier base de données	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
DTADCT	Dictionnaire de données	Nom	Facultatif
DFN	Définition de fichier	Nom	Facultatif
CRTDATE	Date de création	Date, *FIRST	Facultatif

Option (OPTION)

Indique l'opération exécutée sur un fichier à description interne ou externe ou sur une définition de fichier.

Remarque :Les fichiers à description externe peuvent uniquement être déliés.

Ce paramètre est obligatoire.

Les valeurs possibles sont les suivantes :

*LINK: Le fichier à description interne ou la définition de fichier est lié.
*UNLINK: Le fichier à description interne ou externe ou la définition de fichier est délié.

Fichier base de données (FILE)

Indique le nom et la bibliothèque du fichier à description interne ou externe à lier ou à délier.

Ce paramètre est obligatoire.

Pour le fichier, les valeurs possibles sont les suivantes :

*ALL: Tous les fichiers à description interne liés à des définitions d'un dictionnaire particulier sont déliés. Cette valeur est admise uniquement lorsque *UNLINK est également indiqué en regard de l'invite Option (paramètre OPTION) et que le nom du dictionnaire est indiqué en regard de l'invite Dictionnaire de données (paramètre DTADCT). Cette valeur n'est pas admise pour les fichiers à description externe.
nom-bibliothèque/nom-fichier: Indiquez le nom du fichier base de données à lier ou à délier.

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 contenant la définition de fichier à lier ou à délier au fichier à description interne. Un nom est obligatoire lorsque *LINK figure en regard de l'invite Option (paramètre OPTION), ou si *ALL est mentionné en regard de l'invite Fichier base de données (paramètre FILE) et *UNLINK en regard de Option (paramètre OPTION).

Définition de fichier (DFN)

Indique le nom de la définition de fichier à lier au fichier à description interne. Ce paramètre ne s'applique pas lorsque *UNLINK est indiqué en regard de l'invite Option (paramètre OPTION).

Date de création (CRTDATE)

Indique la date de création de la définition de fichier à lier au fichier à description interne. Cette information n'est pas prise en compte si *UNLINK est mentionné en regard de l'invite Option (paramètre OPTION).

Les valeurs possibles sont les suivantes :

*FIRST: La définition de fichier dont le nom est indiqué et dont la date de création est la plus récente est utilisée.
date-création: Indiquez la date de création de la définition de fichier à lier au fichier à description interne.

Exemples

LNKDTADFN   OPTION(*LINK)  FILE(MYLIB/MYFILE)
            DTADCT(MINE)  DFN(MYDEF)

Cette commande établit un lien entre la définition MYDEF du dictionnaire MINE et le fichier base de données MYFILE décrit dans les programmes qui se trouve dans la bibliothèque MYLIB.

Messages d'erreur

Messages *ESCAPE

CPF2E9B: Définition &1 non trouvée.
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.
CPF2FE3: Erreur dans fichier de références croisées système.
CPF2FE4: Fichier de références croisées système non disponible.
CPF2F02: Vous n'êtes pas autorisé à utiliser le dictionnaire &1.
CPF2F07: Erreur dans le dictionnaire &1.
CPF2F08: Dictionnaire &1 non trouvé.
CPF2F6A: Fichier &2 de &3 incorrect pour LNKDTADFN.
CPF2F6C: Tous les fichiers n'ont pas été déliés.
CPF2F61: Fichier &2 de &3 en cours d'utilisation.
CPF2F7B: Fichier &2 non lié. Longueurs d'enregistrement différentes.
CPF2F7C: Début de clé (position &1) ne correspond pas au début de la zone &2.
CPF2F7D: Fin de clé (position &1) ne correspond pas à la fin de la zone &2.
CPF2F7F: Fichier &2 de &3 déjà lié.
CPF2F76: Seules les définitions pour fichiers physiques peuvent être liées.
CPF2F77: Impossible de lier un fichier sans clé à une définition de fichier avec clé.
CPF2F78: Erreur dans la définition &1.
CPF2F79: Zones clé non concordantes.
CPF2F80: Fichier &2 de &3 non lié.
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.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.