RNMOBJ

Rebaptiser un objet

En bref

La commande RNMOBJ (Rebaptiser un objet) permet de modifier le nom d'un objet dans une bibliothèque.

RNMOBJ se lit RNM (Renommer) + OBJ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RNMOBJ OBJ(…) OBJTYPE(…) NEWOBJ(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
NEWOBJ Nouvel objet obligatoire
ASPDEV Unité ASP
SYSTEM Système

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

La commande RNMOBJ (Rebaptiser un objet) permet de modifier le nom d'un objet dans une bibliothèque. Le nouveau nom ne doit pas déjà figurer dans la bibliothèque pour ce type d'objet. Si l'objet à rebaptiser est en cours d'utilisation lorsque cette commande est lancée, l'objet n'est pas rebaptisé. Si une bibliothèque figure dans une liste des bibliothèques d'un utilisateur actif lorsque la bibliothèque est rebaptisée, la commande DSPLIBL affiche le nouveau nom. Le changement de nom d'une bibliothèque n'est pas recommandé car il peut provoquer des erreurs de programmation.

Si l'objet en cours de changement de nom est journalisé, un poste est consigné dans le journal qui enregistre les modifications. Utilisez la commande DSPOBJD (Afficher la description de l'objet) pour afficher les informations de journalisation concernant l'objet.

Remarque :Pour en savoir plus sur la journalisation, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Pour un objet autre que *FILE, vous devez disposer des droits suivants :
- Droits *OBJMGT sur l'objet à renommer,
- droits *UPD et *EXECUTE sur la bibliothèque dans laquelle se trouve l'objet.
Pour un objet *FILE, vous devez disposer des droits suivants :
- Droits *OBJMGT et *OBJOPR sur l'objet à renommer,
- droits *UPD et *EXECUTE sur la bibliothèque dans laquelle se trouve l'objet.
Vous ne pouvez pas renommer une bibliothèque contenant l'un des types d'objet suivants : *CRG, *DTADCT, *JRN, *JRNRCV, *SQLPKG, *SQLUDT et *SQLXSR.
Un programme en PL/1 ne peut pas être rebaptisé après sa création.
Les objets de configuration, tels que les descriptions de contrôleur, de ligne, d'unité ou d'interface réseau doivent être hors fonction pour être rebaptisés.
Les objets suivants ne peuvent pas être rebaptisés :
- Les bibliothèques système IBM Le message CPD2166 est envoyé si une bibliothèque système IBM est spécifiée et que la commande RNMOBJ n'est pas exécutée.
- La file d'attente de messages de l'opérateur système (QSYSOPR)
- Les files d'attente de messages de tous les postes de travail
- L'historique du système (QHST)
- Les objets de configuration (QCTL et QCONSOLE)
- Les listes de configuration (QAPPNRMT, QAPPNLCL, QASYNCLOC, QRTLPASTHR)
- Les objets de configuration des Téléservices (QESLINE, QESPAP, QESCTL, QTILINE, QTICTL, QTIDA, QTIDA2, QIADSP, QIAPRT, QQAHOST)
Une bibliothèque utilisateur ne peut pas être rebaptisée du nom d'une bibliothèque système IBM. La commande RNMOBJ n'est pas exécutée. Le message CPD2166 répertorie les noms des bibliothèques système IBM qui ne peuvent pas être spécifiées pour le nouveau nom d'objet dans la commande RNMOBJ.
Lorsque vous rebaptisez des objets de type *CSI, *GSS, *FNTRSC, *FORMDF, *OVL, *PAGDFN et *PAGSEG, le nouveau nom de celui-ci ne doit pas comporter plus de 8 caractères.
Cette commande est à unités d'exécution protégées sous certaines conditions. Les restrictions suivantes s'appliquent :
- Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution protégées pour les fichiers répartis. Elle échoue dans le cas de fichiers répartis utilisant une base de données relationnelle de type *SNA. En outre, elle n'admet pas l'utilisation d'unités d'exécution protégées pour les fichiers DDM (Gestion de fichiers éloignés ) de type *SNA lorsque SYSTEM(*RMT) ou SYSTEM(*FILETYPE) est indiqué.
- Il n'est pas possible de renommer des objets de type *CFGL, *CNNL, *CTLD, *DEVD, *LIND ou *NWID dans des travaux à unités d'exécution multiples.

REMARQUES :

Après changement du nom d'un objet de configuration, il pourra être nécessaire que l'utilisateur mette à jour les références aux éléments suivants :
- Listes de connexion
- Postes écran
- Postes de communication
- Fichiers écran
- Fichiers imprimante
- Fichiers bande
- Fichiers disquette
- Fichiers ICF
- Profils utilisateur
- Descriptions de travail
- Programmes CL
- Valeur système QPRTDEV
- Descriptions d'écran référençant l'écran en tant qu'imprimante secondaire
- Objets CSI
- Fichiers de gestion de données réparties (nom d'unité APPC)
- Descriptions de contrôleur RNIS (Réseau numérique à intégration de services) faisant référence à une liste de connexion (CNNL) rebaptisée
- Descriptions de ligne RNIS faisant référence à une liste de connexion rebaptisée
- Certains autres objets de configuration - exemple : lignes, contrôleurs et autres unités faisant référence aux objets de configuration rebaptisés
Après changement du nom d'un objet *AUTL (Liste d'autorisations), il pourra être nécessaire que l'utilisateur mette à jour les références aux éléments suivants :
- Bibliothèques faisant référence à l'objet *AUTL dans la valeur CRTAUT (Créer droits) pour la bibliothèque.
Après un changement de nom, les références que les éléments ci-après font aux objets rebaptisés sont automatiquement modifiées par le système. Les modifications reflètent celles qui sont apportées aux objets de configuration rebaptisés.
- Valeur système QCONSOLE
- Files d'attente de messages associées à des unités écran
- Tables d'unité en environnement 36
- Files d'attente en sortie associées à l'ancienne unité imprimante

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Objet	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OBJTYPE	Type d'objet	ALRTBL, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DTAARA, DTAQ, EDTD, FCT, FILE, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IGCSRT, IMGCLG, IPXD, JOBD, JOBQ, LIB, LIND, LOCALE, MEDDFN, MENU, MGTCOL, MODULE, MSGF, MSGQ, M36, M36CFG, NODGRP, NODL, NTBD, NWID, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PRDAVL, PRDDFN, PRDLOD, PSFCFG, QMFORM, QMQRY, QRYDFN, RCT, SBSD, SCHIDX, SPADCT, SRVPGM, SSND, TBL, USRIDX, USRQ, USRSPC, VLDL, *WSCST	Obligatoire, positionnel 2
NEWOBJ	Nouvel objet	Nom	Obligatoire, positionnel 3
ASPDEV	Unité ASP	Nom, , CURASPGRP, *SYSBAS	Facultatif
SYSTEM	Système	LCL, RMT, *FILETYPE	Facultatif, positionnel 4

Objet (OBJ)

Indique l'objet à rebaptiser. Si la bibliothèque (qualificatif 2) n'est pas indiquée, *LIBL est utilisée. Vous pouvez définir un nom de bibliothèque pour le qualificatif 2 pour vous assurer que l'objet correct est rebaptiser.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

nom: Indiquez le nom de l'objet à rebaptiser.

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. Si l'invite Unité ASP (paramètre ASPDEV) est indiquée lorsque cette valeur est utilisée, ASPDEV(*) est la seule valeur admise.

*CURLIB: La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

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

Type d'objet (OBJTYPE)

Indique le type de l'objet à rebaptiser.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

type-objet: Indiquez le type de l'objet à rebaptiser.

Nouvel objet (NEWOBJ)

Indique le nouveau nom de l'objet à rebaptiser. L'objet reste dans sa bibliothèque d'origine.

Ce paramètre est obligatoire.

nom: Indiquez le nouveau nom de l'objet.

Unité ASP (ASPDEV)

Indique le nom de l'unité ASP dans laquelle de la mémoire est allouée à la bibliothèque contenant l'objet à rebaptiser. Si la bibliothèque est située dans un ASP qui ne fait pas partie de l'espace de nom de la bibliothèque de l'unité d'exécution, ce paramètre doit être indiqué pour être sûr que l'objet à rebaptiser est correct. Si la bibliothèque à rebaptiser est située dans une unité ASP qui ne fait pas partie de l'espace de nom de la bibliothèque de l'unité d'exécution, indiquez la valeur OBJ(QSYS/nom) à la bibliothèque, la valeur OBJTYPE(*LIB) au type d'objet et la valeur ASPDEV(nom) à l'unité ASP.

Remarque :ASPDEV(*) est la seule valeur admise si *LIBL ou *CURLIB est indiqué pour la bibliothèque (qualificatif 2) du paramètre Objet (OBJ).

*: La recherche de la bibliothèque s'effectue dans tous les ASP présents dans l'espace de nom de bibliothèque de l'unité d'exécution. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis(ASP 2 à 32) et, si l'unité d'exécution dispose d'un groupe d'ASP, des ASP principaux et secondaires du groupe d'ASP de l'unité d'exécution.

*CURASPGRP: Si l'unité d'exécution dispose d'un groupe ASP, la recherche portera sur les ASP primaire et secondaire du groupe ASP de l'unité pour trouver la bibliothèque. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32). Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.

*SYSBAS: La bibliothèque est recherchée dans l'ASP système (ASP 1) et dans tous les ASP utilisateur de base définis (ASP 2-32). Les ASP principaux et secondaires ne sont pas concernés par cette recherche, même si l'unité d'exécution possède un groupe d'ASP.

nom: Indiquez le nom de l'ASP principal ou secondaire dans lequel rechercher la bibliothèque. L'ASP principal ou secondaire doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Actif' ou 'Disponible'. La recherche ne s'effectue ni sur l'ASP système (1) ni sur les ASP utilisateur de base (2-32).
Remarque :Pour indiquer un nom d'ASP spécifique, vous devez disposer du droit d'utilisation (*USE) sur chaque ASP du groupe d'ASP.

Système (SYSTEM)

Indique, lorsqu'il s'agit d'un fichier DDM (Gestion de fichiers éloignés), si l'attribution d'un nouveau nom au fichier doit être effectuée sur le système local ou éloigné.

*LCL: Le fichier est rebaptisé sur le système local.
*RMT: Le fichier éloigné référencé par le fichier DDM source est rebaptisé.
Remarque :Pour rebaptiser un fichier éloigné, vous devez utiliser deux fichiers DDM. L'ancien nom et le nouveau doivent être indiqués pour les paramètres Objet (OBJ) et Nouvel objet (NEWOBJ). Ces deux fichiers doivent figurer dans la même bibliothèque. L'opération consiste à attribuer un nouveau nom de fichier au fichier éloigné DDM existant.
*FILETYPE: Si le nom apparaissant dans le paramètre OBJ concerne un fichier DDM, le nouveau nom désignera également un fichier DDM. Si le nom apparaissant dans le paramètre OBJ ne concerne pas un fichier DDM, le nouveau nom désignera un fichier local.

Exemples

RNMOBJ  OBJ(PAYROLL/FILEX)  OBJTYPE(*FILE)  NEWOBJ(MSTR)

Le fichier FILEX est recherché dans la bibliothèque PAYROLL. Si le fichier est trouvé et que vous disposez des droits appropriés sur ce fichier, FILEX est renommé en MSTR.

Messages d'erreur

Messages *ESCAPE

CPFA030: Objet déjà en cours d'utilisation.
CPFB8ED: La description d'unité &1 est incorrecte pour l'opération.
CPF0601: Opération sur le fichier &1 de &2 non autorisée.
CPF0602: Le fichier &1 existe déjà dans la bibliothèque &2.
CPF0605: Fichier unité &1 dans &2 sauvegardé avec libération mémoire.
CPF0610: Fichier &1 de &2 non disponible.
CPF0678: Opération non effectuée pour nom de fichier &1 dans &2.
CPF1763: Impossible d'allouer une ou plusieurs bibliothèques.
CPF180B: Fonction &1 non admise.
CPF210F: L'opération n'a pas abouti pour &1, &2, type *&3.
CPF2105: Objet &1 de &2 type *&3 non trouvé.
CPF2110: Bibliothèque &1 non trouvée.
CPF2111: La bibliothèque &1 existe déjà.
CPF2112: L'objet &1 de type *&3 existe déjà dans &2.
CPF2113: Impossible d'allouer la bibliothèque &1.
CPF2114: Impossible d'allouer objet &1 de &2 type *&3.
CPF2132: L'objet &1 existe déjà dans la bibliothèque &2.
CPF2136: Erreur lors du changement de nom de la bibliothèque &1.
CPF2139: Erreur lors du changement de nom de la bibliothèque &1.
CPF2140: Erreur lors du précédent changement de nom de la bibliothèque &1.
CPF2150: Erreur dans la fonction d'informations sur objet.
CPF2151: Erreur de l'opération sur &2 de &1 type *&3.
CPF2160: Objet de type *&1 incorrect pour la fonction demandée.
CPF2164: Changement de nom de la bibliothèque &2 non effectué.
CPF2166: Le nom de bibliothèque &1 n'est pas valide. Library name &1 not valid.
CPF2173: Valeur pour ASPDEV incorrecte avec valeur spéciale pour bibliothèque.
CPF2176: Bibliothèque &1 endommagée.
CPF218C: &1 n'est pas un ASP principal ou secondaire.
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2189: Utilisation de l'objet &1 de &2, type *&3 non autorisée.
CPF2190: La suppression ou le changement de nom ne peut pas être demandé à distance.
CPF22BC: L'objet &1 type &3 n'est pas défini dans les programmes.
CPF2451: File d'attente de messages &1 allouée à un autre travail.
CPF2512: Opération non admise pour la file d'attente de messages &1.
CPF2691: L'objet &2 de type *&5 n'a pas été rebaptisé.
CPF2692: L'objet &2 de type *&5 doit être mis hors fonction.
CPF2693: &2 ne peut être utilisé pour rebaptiser un objet de type *&5.
CPF2694: L'objet &2 de type *&5 ne peut être rebaptisé.
CPF2696: L'objet &2 de type *&5 n'a pas été rebaptisé.
CPF320B: Opération incorrecte pour le fichier base de données &1.
CPF3201: Le fichier &1 existe déjà dans la bibliothèque &2.
CPF3202: Fichier &1 de &2 en cours d'utilisation.
CPF3203: Allocation de l'objet impossible pour le fichier &1 de &2.
CPF322D: Opération non effectuée pour fichier base de données &1.
CPF3220: Impossible d'effectuer l'opération sur le fichier &1 de &2.
CPF323C: Impossible d'allouer la bibliothèque QRECOVERY.
CPF323D: L'utilisateur ne dispose pas des droits appropriés.
CPF324C: Opération en cours sur dépositaire de droits ; déplacement, changement de nom ou restauration impossible.
CPF3245: Opération sur fichier &3 impossible : fichier &1, membre &6, endommagé.
CPF326A: L'opération a échoué pour le fichier &1 de la bibliothèque &2.
CPF327F: L'opération a échoué pour le fichier &1 de la bibliothèque &2.
CPF329D: L'opération a échoué pour le fichier &1 de la bibliothèque &2.
CPF3323: La file d'attente de travaux &1 de &2 existe déjà.
CPF3330: Ressource nécessaire non disponible.
CPF3353: File d'attente en sortie &1 de &2 existe déjà.
CPF3375: File d'attente de travaux &1 de &2 non rebaptisée car utilisée.
CPF3376: File d'attente en sortie &1 de &2 non rebaptisée. En cours d'utilisation.
CPF3467: File d'attente en sortie &1 supprimée, puis recréée.
CPF3469: Opération non admise pour cette file d'attente en sortie.
CPF5702: Ce fichier n'est pas un fichier DDM ou est introuvable.
CPF7003: Poste non journalisé dans &1. Code raison &3.
CPF8D05: La bibliothèque &1 existe déjà.
CPF88C4: La valeur &1 du nouvel objet comprend plus de 8 caractères.
CPF9801: Objet &2 non trouvé dans la bibliothèque &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.
CPF9809: Accès à la bibliothèque &1 impossible.
CPF9814: Unité &1 non trouvée.
CPF9825: Accès non autorisé à l'unité &1.
CPF9830: Allocation de la bibliothèque &1 impossible.
CPF9833: *CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.
CPF9876: La bibliothèque protégée &2 ne peut pas être modifiée.