ADDHDBDLFM

Ajouter une BD hôte à DLFM

En bref

La commande ADDHDBDLFM (Ajouter une base de données hôte à DLFM) permet d'enregistrer avec DFLM (gestionnaire de fichiers de liaisons de données) une base de donnés hôte qui peut ensuite servir à appeler ce dernier pour lier des fichiers.

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

Syntaxe minimale

ADDHDBDLFM

Paramètres

HOSTDBLIB Bibliothèque base données hôte
HOSTDBINST Instance base de données hôte
HOSTDB Base de données hôte
SRCFILE Fichier source
SRCMBR Membre source

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

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit spécial de configuration de système d'entrée-sortie (*IOSYSCFG).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
HOSTDBLIB	Bibliothèque base données hôte	Values (jusqu'à 300 répétitions): Liste d'éléments	Facultatif, positionnel 1
HOSTDBLIB	Élément 1: Name	Valeur caractère	Facultatif, positionnel 1
HOSTDBINST	Instance base de données hôte	Valeur caractère, QSYS	Facultatif, positionnel 2
HOSTDB	Base de données hôte	Valeur caractère	Facultatif
SRCFILE	Fichier source	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Fichier source	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCMBR	Membre source	Valeur caractère	Facultatif

Bibliothèque base données hôte (HOSTDBLIB)

Indique une ou plusieurs bibliothèques de la base de données hôte susceptibles de contenir des fichiers base de données associés à des liaisons de données. Vous pouvez indiquer jusqu'à 300 noms.

valeur-caractères: Indiquez le nom de la bibliothèque.

Instance base de données hôte (HOSTDBINST)

Indique l'instance de base de données à enregistrer avec DLFM (gestionnaire de fichiers de liaisons de données), ce qui permet de spécifier le chemin d'installation du produit DB2 sur le système hôte. S'il s'agit d'un système hôte IBM i, c'est QSYS qui doit être indiqué pour ce paramètre.

QSYS: L'instance de base de données prend le nom QSYS.
valeur-caractères: Indiquez le nom de l'instance de base de données.

Base de données hôte (HOSTDB)

Indique le nom de la base de données hôte à enregistrer. Il s'agit de la base de données relationnelle éloignée (ou du serveur) qui sera connecté au DLFM (gestionnaire de fichiers de liaisons de données) local pour établir et annuler les demandes de liaison de données.

valeur-caractères: Indiquez le nom de la base de données hôte.

Fichier source (SRCFILE)

Indique le fichier source fournissant les informations de base de données hôte à enregistrer.

Qualificatif 1 : Fichier source

nom: Indiquez le nom du fichier source.

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: Le fichier est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

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

Membre source (SRCMBR)

Indique le membre source contenant les informations de base de données hôte à enregistrer. Chaque ligne de ce membre doit contenir une bibliothèque de base de données hôte, une instance de base de données hôte et un nom de serveur de base de données hôte (ces valeurs étant séparées par des blancs).

valeur-caractères: Indiquez le nom du membre de fichier source.

Exemples

Enregistrement d'une base de données hôte de gestionnaire de fichiers de liaisons de données

ADDHDBDLFM   HOSTDBLIB(MYLIB TESTLIB PERSONNEL)
             HOSTDBINST(QSYS)  HOSTDB(RCHASXYZ)

Cette commande enregistre RCHASXYZ comme système admis pour appeler le gestionnaire de fichiers de liaisons de données via une demande de liaison. MYLIB, TESTLIB et PERSONNEL sont des bibliothèques (ou collections) du système de base de données hôte pouvant inclure des fichiers base de données contenant des liaisons de données. QSYS est utilisée en tant qu'instance de base de données hôte, dans la mesure où le système est un serveur IBM i.

Messages d'erreur

Messages *ESCAPE

CPF3168: La commande du gestionnaire de fichiers de liaisons de données DLFM a échoué.