RNM

Rebaptiser un objet

En bref

La commande Rebaptiser un objet (RNM) permet de modifier le nom d'un objet dans un répertoire.

Syntaxe minimale

RNM OBJ(…) NEWOBJ(…)

Paramètres

OBJ Objet obligatoire
NEWOBJ Nouvel objet obligatoire

Astuce : dans une session 5250, tapez RNM 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 Rebaptiser un objet (RNM) permet de modifier le nom d'un objet dans un répertoire.

Cette commande est équivalente à la commande suivante :

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 Objet (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.
Pour rebaptiser un objet dans le système de fichiers racine (/), QOpenSys ou défini par l'utilisateur, ce dernier doit disposer du droit de gestion (*OBJMGT) sur l'objet concerné ainsi que du droit d'écriture et d'exécution (*WX) sur le répertoire contenant cet objet. Si l'objet à renommer est un répertoire, l'utilisateur doit également disposer du droit d'écriture (*W) sur ce répertoire.
L'utilisateur doit disposer du droit d'exécution (*X) sur chacun des répertoires du chemin.
Un utilisateur ne peut pas rebaptiser un objet dans un répertoire du système de fichiers racine (/), QOpenSys ou défini par l'utilisateur, dans lequel l'attribut de restriction des opérations de changement de nom et de suppression de lien est activé (cet attribut est identique au bit mode S_ISVTX), sauf si une ou plusieurs des conditions suivantes sont remplies :
- L'utilisateur est le propriétaire de l'objet.
- L'utilisateur est le propriétaire du répertoire.
- L'utilisateur dispose des droits spéciaux sur tous les objets (*ALLOBJ).
Les droits requis et les restrictions relatifs à la commande Rebaptiser un objet (RNMOBJ) existante et à la commande Rebaptiser document ou dossier (RNMDLO) s'appliquent aux objets des systèmes de fichiers QSYS.LIB, QSYS.LIB d'ASP indépendant et QDLS
Dans les système de fichiers QSYS.LIB et QSYS.LIB d'ASP indépendant, le nouveau nom doit contenir le même suffixe de type d'objet.
Certains objets ne peuvent pas être rebaptisés. Si vous tentez d'effectuer une telle opération, un message d'erreur est émis.
Le fichier ne peut pas être rebaptisé s'il correspond à une colonne de liaisons de données dans une table SQL et lorsqu'une ligne de cette table SQL fait référence à ce fichier.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Chemin d'accès	Obligatoire, positionnel 1
NEWOBJ	Nouvel objet	Valeur caractère	Obligatoire, positionnel 2

Objet (OBJ)

Indique le nom de chemin de l'objet à rebaptiser.

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/.

Nouvel objet (NEWOBJ)

Indique le nouveau nom de l'objet à rebaptiser. Ce nom ne peut pas comporter de qualificatif de répertoire et doit être placé dans le même répertoire que l'objet existant.

Exemples

Exemple 1 : Modification du nom d'un lien d'objet

RNM   OBJ('FICHIER-PAIE-MENSUELLE_DECEMBRE-1994')
      NEWOBJ('FICHIER-PAIE-MENSUELLE_JANVIER-1995')

Cette commande rebaptise le fichier FICHIER-PAIE-MENSUELLE_DECEMBRE-1994 en FICHIER-PAIE-MENSUELLE_JANVIER-1995.

Messages d'erreur

Messages *ESCAPE

CPFA085: Répertoire initial de l'utilisateur &1 introuvable.
CPFA08E: Plusieurs noms correspondent au masque.
CPFA093: Aucun nom ne correspond au masque indiqué.
CPFA09C: Aucun droit sur l'objet. L'objet est &1.
CPFA09D: Erreur dans le programme &1.
CPFA09E: L'objet est en cours d'utilisation. L'objet est &1.
CPFA0A1: Erreur d'entrée ou de sortie.
CPFA0A3: La résolution du nom de chemin provoque une boucle.
CPFA0A6: Le nombre de liens dépasse la limite admise par le système de fichiers.
CPFA0A7: Le nom de chemin est trop long.
CPFA0A9: Objet introuvable. L'objet est &1.
CPFA0AA: Une erreur s'est produite pendant l'allocation d'espace.
CPFA0AB: Erreur d'opération pour l'objet. L'objet est &1.
CPFA0B1: Opération demandée non admise. Incident d'accès.
CPFA0B2: Aucun objet ne correspond à la demande.
CPFA0B4: Le paramètre NEWOBJ ne peut pas commencer par une barre oblique.
CPFA0B5: Le paramètre NEWOBJ ne peut pas contenir de nom de chemin.
CPFA0C4: L'objet n'est pas un fichier. L'objet est &1.