ADDBNDDIRE

Ajouter poste répertoire liage

En bref

La commande ADDBNDDIRE (Ajouter poste répertoire liage) permet d'ajouter un poste à un répertoire de liage.

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

Syntaxe minimale

ADDBNDDIRE BNDDIR(…) OBJ(…)

Paramètres

BNDDIR Répertoire de liage obligatoire
OBJ Spécifications d'objet obligatoire
POSITION Spécifications de position

Astuce : dans une session 5250, tapez ADDBNDDIRE 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 ADDBNDDIRE (Ajouter poste répertoire liage) permet d'ajouter un poste à un répertoire de liage.

Restrictions :

Vous devez disposer du droit d'utilisation (*USE) sur la bibliothèque dans laquelle se trouve le répertoire de liage à modifier.
Vous devez disposer du droit d'opération sur l'objet (*OBJOPR) et du droit d'ajout (*ADD) sur le répertoire de liage à modifier.
Vous devez disposer d'un droit d'exécution (*EXECUTE) sur la bibliothèque spécifiée lorsqu'un nom générique est indiqué à l'invite Spécifications d'objet(paramètre OBJ).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
BNDDIR	Répertoire de liage	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Répertoire de liage	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, *USRLIBL
OBJ	Spécifications d'objet	Values (jusqu'à 50 répétitions): Liste d'éléments	Obligatoire, positionnel 2
	Élément 1: Objet	Nom d'objet qualifié
	Qualificatif 1: Objet	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, *LIBL
	Élément 2: Type d'objet	SRVPGM, MODULE
	Élément 3: Activation	IMMED, DEFER
POSITION	Spécifications de position	Valeurs uniques: LAST, FIRST Autres valeurs: Liste d'éléments	Facultatif, positionnel 3
	Élément 1: Position d'objet	AFTER, BEFORE, *REPLACE
	Élément 2: Objet	Nom d'objet qualifié
	Qualificatif 1: Objet	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
	Élément 3: Type d'objet	SRVPGM, MODULE

Répertoire de liage (BNDDIR)

Indique le répertoire de liage auquel un poste est ajouté.

Ce paramètre est obligatoire.

Qualificatif 1 : Répertoire de liage

nom: Indiquez le nom du répertoire de liage à mettre à jour.

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: La recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.
*USRLIBL: La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Spécifications d'objet (OBJ)

Indique un ou plusieurs noms d'objet à ajouter au répertoire de liage.

Ce paramètre est obligatoire.

Vous pouvez indiquer 50 valeurs pour ce paramètre.

Vous pouvez contrôler l'activation de chaque programme de service. Vous pouvez aussi indiquer si le programme de service référencé est activé au même moment que le programme ou le programme de service créé à partir du répertoire de liage, ou s'il est mis en différé jusqu'à ce qu'une procédure exportée du programme de service référencé soit appelée. La mise en différé de l'activation peut améliorer les performances de votre application.

Elément 1 : Objet

Qualificatif 1 : Objet

*ALL: Tous les objets du type indiqué résidant dans la bibliothèque spécifiée doivent être ajoutés.
nom-générique: Indiquez le nom générique de l'objet. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) : ABC*, par exemple. L'astérisque remplace tout caractère admis. Un nom générique désigne tous les objets dont le nom commence par le préfixe générique sur lesquels l'utilisateur a des droits. Si l'astérisque n'est pas inclus dans le nom (préfixe) générique, le système considère qu'il s'agit d'un nom d'objet complet. Si le nom complet de l'objet est indiqué et que plusieurs bibliothèques sont explorées, plusieurs objets peuvent être ajoutés, à condition toutefois que la valeur de bibliothèque *ALL ou *ALLUSR puisse être indiquée pour le nom.
nom: Indiquez le nom de l'objet à ajouter au répertoire de liage.

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.

nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Elément 2 : Type d'objet

*SRVPGM: L'objet à ajouter est un programme de service.
*MODULE: L'objet à ajouter est un module.

Elément 3 : Activation

*IMMED: L'activation du programme de service lié a lieu dès que le programme ou le programme de service en cours de création dans le répertoire de liage est activé.
*DEFER: L'activation du programme de service lié peut être mise en différé jusqu'à ce qu'une fonction exportée par ce programme soit appelée.

Spécifications de position (POSITION)

Indique la position à laquelle la liste des objets est ajoutée dans le répertoire de liage.

Valeurs particulières

*LAST: La liste des objets est ajoutée à la fin des postes de répertoire de liage.
*FIRST: La liste des objets doit être insérée avant le premier poste de répertoire de liage.

Elément 1 : Position d'objet

*AFTER: La liste des objets est ajoutée au répertoire de liage, après le poste indiqué pour ce paramètre. Le poste indiqué doit exister dans le répertoire de liage.
*BEFORE: La liste des objets est ajoutée au répertoire de liage, avant le poste indiqué pour ce paramètre. Le poste indiqué doit exister dans le répertoire de liage.
*REPLACE: L'objet indiqué au répertoire OBJ remplace le poste de répertoire de liage indiqué pour ce paramètre. Le poste indiqué doit exister dans le répertoire de liage. Un seul poste peut être indiqué au paramètre OBJ.

Elément 2 : Objet

Qualificatif 1 : Objet

nom: Indiquez le nom d'objet d'un poste de répertoire de liage existant.

Qualificatif 2 : Biblio

*LIBL: Le poste de répertoire de liage existant possède le qualificatif de bibliothèque *LIBL.
nom: Indiquez le nom du qualificatif de bibliothèque pour le poste existant.

Elément 3 : Type d'objet

*SRVPGM: Le poste de répertoire est un programme de service.
*MODULE: Le poste de répertoire est un module.

Exemples

Exemple 1 : ajout d'un poste en fin de liste

ADDBNDDIRE   BNDDIR(TESTBNDDIR)  OBJ((TESTOBJ))
             POSITION(*LAST)

Cette commande ajoute un poste de répertoire de liage au programme de service TESTOBJ dans la bibliothèque *LIBL à la fin de la liste des postes de répertoire de liage trouvés dans le répertoire de liage TESTBNDDIR.

Exemple 2 : ajout d'un poste en début de liste

ADDBNDDIRE   BNDDIR(TESTBNDDIR)
             OBJ((TESTLIB/TESTOBJ *MODULE))  POSITION(*FIRST)

Cette commande ajoute un poste de répertoire de liage au module TESTOBJ dans la bibliothèque TESLIB au début des postes de répertoire de liage trouvés dans le répertoire de liage TESTBNDDIR.

Exemple 3 : ajout de plusieurs postes

ADDBNDDIRE   BNDDIR(TESTBNDDIR)
             OBJ((TESTLIB/TESTOBJ *MODULE) (TESTOBJ2))
             POSITION(*FIRST)

Cette commande ajoute un poste de répertoire de liage au module TESTOBJ dans la bibliothèque TESTLIB suivi d'un poste pour le programme de service TESTOBJ2 dans la liste des bibliothèques au début des postes de répertoire de liage trouvés dans le répertoire de liage TESTBNDDIR.

Exemple 4 : ajout de postes avant un poste existant

ADDBNDDIRE   BNDDIR(TESTBNDDIR)
             OBJ((TESTLIB/TESTOBJ *MODULE) (TESTOBJ2))
             POSITION(*BEFORE  *LIBL/TESTMOD *MODULE)

Cette commande ajoute un poste de répertoire de liage au module TESTOBJ dans la bibliothèque TESTLIB, suivi d'un poste pour le programme de service TESTOBJ2 dans la bibliothèque *LIBL avant le poste de répertoire de liaison pour le module TESTMOD dans la bibliothèque *LIBL trouvé dans le répertoire de liage ESTBNDDIR.

Le poste de répertoire de liage du module TESTMOD dans la bibliothèque *LIBL doit se trouver dans le répertoire de liage TESTBNDDIR pour que cette opération aboutisse.

Messages d'erreur

Messages *ESCAPE

CPF5D01: Répertoire de liage &1 de la bibliothèque &2 inutilisable.
CPF5D09: Objet &2/&1 de type &3 introuvable dans répertoire de liage &4 de la bibliothèque &5.
CPF980F: Répertoire de liage &1 introuvable dans bibliothèque &2.
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9807: Une ou plusieurs bibliothèques de la liste ont été supprimées.
CPF9808: Allocation impossible pour une ou plusieurs bibliothèques de la liste.
CPF9810: Bibliothèque &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9830: Allocation de la bibliothèque &1 impossible.