ADDLNK

La commande ADDLNK (Ajouter un lien) permet d'ajouter un lien à un objet. Le paramètre NEWLNK (Nouveau lien) indique le nom du nouveau lien. Le paramètre OBJ (Objet) indique le nom en cours de l'objet auquel le nouveau lien doit être attribué. Une fois le lien établi, l'objet peut être désigné par son ancien ou son nouveau nom.

Pour plus d'informations sur les commandes du système de fichiers intégré, reportez-vous aux Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

• Cette commande ne s'applique qu'à un seul objet. Si plusieurs objets correspondent au masque indiqué au paramètre OBJ, l'utilisateur peut choisir l'objet voulu à partir d'une liste, dans le cadre d'un travail interactif. S'il s'agit d'un travail par lots, la commande n'aboutit pas et le message d'erreur CPFA08E "Plusieurs noms correspondent au masque." apparaît. Vous ne pouvez pas indiquer de masque pour le Type du lien La valeur du paramètre (LNKTYPE) est *SYMBOLIC du fait que cet objet ne doit pas nécessairement exister.
• L'utilisateur doit disposer des droits d'écriture (*W) et d'exécution (*X) sur le répertoire qui contient le nouveau lien. Si un lien fixe est ajouté, l'utilisateur doit également posséder le droit d'existence sur l'objet (*OBJEXIST) pour l'objet existant ainsi que le droit *X sur chacun des préfixes de nom de chemin correspondants (OBJ).
• Un lien fixe ne peut pas être attribué à un lien symbolique. Si vous indiquez LNKTYPE(*HARD) et que le paramètre OBJ mentionne un nom de lien symbolique, le lien est ajouté à l'objet résolu (qui doit exister).
• Un lien fixe ne peut pas être attribué à un répertoire.
• Un lien fixe ne peut pas être attribué à un objet d'un autre système de fichiers.
• Aucun lien ne peut être créé dans QSYS.LIB, QSYS.LIB d'ASP indépendant ou la partie QDLS du nom de l'espace nom.

Paramètres

Objet (OBJ)

Indique le nom de chemin de l'objet auquel l'utilisateur souhaite ajouter un lien. Cet objet doit exister, sauf si un lien symbolique doit être ajouté.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Nouveau lien (NEWLNK)

Indique le nouveau nom de chemin qu'il est possible d'utiliser pour désigner l'objet. Ce nouveau nom ne doit pas déjà exister.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Type du lien (LNKTYPE)

Indique si le lien est fixe ou symbolique.

*SYMBOLIC

Le lien attribué à l'objet est une représentation d'un nom de chemin qui se présente sous la forme d'un chemin contenu dans un fichier. Le chemin réel est recherché en fonction du contenu du fichier. Un lien symbolique est également appelé lien temporaire.

Les liens symboliques peuvent traverser des systèmes de fichiers. Il n'est pas nécessaire qu'un objet existe. La suppression d'un objet n'entraîne pas celle du lien symbolique.

*HARD

Le lien attribué à l'objet est le chemin réel d'un objet existant. Un lien fixe est établi par la création d'un poste de répertoire.

Les liens fixes ne peuvent pas traverser des systèmes de fichiers. La suppression de tous les liens fixes vers un objet libère l'espace que ce dernier occupait et vous ne pouvez plus y accéder. Tant qu'un lien fixe existe vers un objet, ce dernier ne peut pas être supprimé.

Exemples

Exemple 1 : Ajout d'un lien symbolique

ADDLNK   OBJ('DECEMBER-1994-MONTHLY-PAYROLL-FILE')
         NEWLNK('PAY')

Cette commande ajoute un lien symbolique nommé PAIE à FICHIER-PAIE-MENSUELLE_DECEMBRE-1994.

Exemple 2 : Ajout d'un lien symbolique à un fichier source

ADDLNK   OBJ('/QSYS.LIB/MABIB.LIB/F1.FILE/P1.MBR')
         NEWLNK('PGM1')  LNKTYPE(*SYMBOLIC)

Cette commande ajoute un lien symbolique nommé PGM1 à partir du profil utilisateur (ne figurant pas dans le système de fichiers QSYS.LIB, QSYS.LIB d'ASP indépendant ou QDLS) dans le membre P1 du fichier source F1 de QSYS.LIB.

Exemple 3 : Ajout d'un lien fixe

ADDLNK   OBJ('/QOpenSys/MONREP/FICH1') NEWLNK('FICH2')
         LNKTYPE(*HARD)

Cette commande ajoute, à partir du répertoire en cours de l'utilisateur, un lien fixe appelé FICH2 vers FICH1 dans /QOpenSys/MONREP.

Messages d'erreur

Messages *ESCAPE

CPFA085

Répertoire initial de l'utilisateur &1 introuvable.

CPFA089

Masque non admis dans nom de chemin.

CPFA08E

Plusieurs noms correspondent au masque.

CPFA093

Aucun nom ne correspond au masque indiqué.

CPFA09C

Aucun droit sur l'objet. L'objet est &1.

CPFA0A1

Erreur d'entrée ou de sortie.

CPFA0A7

Le nom de chemin est trop long.

CPFA0A9

Objet introuvable. L'objet est &1.

CPFA0B0

La demande ne fonctionne pas d'un système de fichiers à l'autre.