<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="security" content="public" /> <meta name="Robots" content="index,follow" /> <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' /> <meta name="DC.Type" content="task" /> <meta name="DC.Title" content="Rename objects" /> <meta name="abstract" content="You can use the Rename Object (RNMOBJ) command to rename objects." /> <meta name="description" content="You can use the Rename Object (RNMOBJ) command to rename objects." /> <meta name="DC.subject" content="RNMOBJ (Rename Object) command, Rename Object (RNMOBJ) command, command, CL, RNMOBJ (Rename Object), Rename Object (RNMOBJ), renaming, object, library, renaming consideration, renaming object, restriction" /> <meta name="keywords" content="RNMOBJ (Rename Object) command, Rename Object (RNMOBJ) command, command, CL, RNMOBJ (Rename Object), Rename Object (RNMOBJ), renaming, object, library, renaming consideration, renaming object, restriction" /> <meta name="DC.Relation" scheme="URI" content="objec.htm" /> <meta name="DC.Relation" scheme="URI" content="moola.htm" /> <meta name="DC.Relation" scheme="URI" content="../cl/rnmobj.htm" /> <meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" /> <meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" /> <meta name="DC.Format" content="XHTML" /> <meta name="DC.Identifier" content="renob" /> <meta name="DC.Language" content="en-us" /> <!-- All rights reserved. Licensed Materials Property of IBM --> <!-- US Government Users Restricted Rights --> <!-- Use, duplication or disclosure restricted by --> <!-- GSA ADP Schedule Contract with IBM Corp. --> <link rel="stylesheet" type="text/css" href="./ibmdita.css" /> <link rel="stylesheet" type="text/css" href="./ic.css" /> <title>Rename objects</title> </head> <body id="renob"><a name="renob"><!-- --></a> <!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script> <h1 class="topictitle1">Rename objects</h1> <div><p>You can use the <span class="cmdname">Rename Object (RNMOBJ)</span> command to rename objects. </p> <div class="section"> <p>However, you can rename an object only if you have object management authority for the object and update and execute authority for the library containing the object.</p> <p>To rename an authorization list, you must have authorization list management authority, and both update and read authority for library QSYS.</p> <p>The following objects <em>cannot</em> be renamed: </p> <ul><li>Class-of-service descriptions (*COSD)</li> <li>Cluster resource group (*CRG)</li> <li>Data dictionaries (*DTADCT)</li> <li>DBCS font tables (*IGCTBL)</li> <li>Display station message queues (*MSGQ)</li> <li>Documents (*DOC)</li> <li>Exit Registration (*EXITRG)</li> <li>Folders (*FLR)</li> <li>Job schedules (*JOBSCD)</li> <li>Journals (*JRN)</li> <li>Journal receivers (*JRNRCV)</li> <li>Mode descriptions (*MODD)</li> <li><img src="./delta.gif" alt="Start of change" />Network Server Configuration (*NWSCFG)<img src="./deltaend.gif" alt="End of change" /></li> <li>Network Server Description (*NWSD)</li> <li>SQL packages (*SQLPKG)</li> <li>System/36™ machine descriptions (*S36)</li> <li>The system history log (QHST)</li> <li>The system library, QSYS, and the temporary library, QTEMP</li> <li>The system operator message queue (QSYSOPR)</li> <li>Time zone description (*TIMZON)</li> <li>User-defined SQL type (*SQLUDT)</li> <li>User profiles (*USRPRF)</li> </ul> <p>Also, you cannot rename an output queue unless it is empty. You should not rename IBM-supplied commands because the licensed programs also use IBM-supplied commands.</p> <p>To rename an object, you must specify the current name of the object, the name to which the object is to be renamed, and the object type.</p> <p>The following RNMOBJ command renames the object ORDERL to ORDFILL: </p> <pre>RNMOBJ OBJ(QGPL/ORDERL) OBJTYPE(*FILE) NEWOBJ(ORDFILL)</pre> <p>You cannot specify a qualified name for the new object name because the object remains in the same library. If the object you want to rename is in use when you issue the <span class="cmdname">Rename Object (RNMOBJ)</span> command, the command runs, but does not rename the object. As a result, the system sends you a message.</p> <p>When you rename objects, you should be careful not to rename objects that other objects depend on. For example, CL programs depend on the command definitions of the commands used in the program to be named the same at run time as they were at compile time. Therefore, if the command definition is renamed in between these two times, the program cannot be run because the commands will not be found. Similarly, any application program you write depends on certain objects being named the same at both times.</p> <p>You cannot rename a library that contains a journal, journal receiver, data dictionary, cluster resource group, or SQL package.</p> <p>An object referring to another object may be dependent on the object and library names (even though *LIBL can be specified for the library name). Therefore, if you rename an object, you should change any references to it in other objects. </p> <p>If you rename a physical or logical file, the members in the file are not renamed. However, you can use the Rename Member (RNMM) command to rename a physical or logical file member. </p> <div class="note"><span class="notetitle">Note:</span> You should be careful when renaming objects in the system library QSYS. These objects are necessary for the system to perform effectively and the system must be able to find the objects. This is also true for some of the objects in the general-purpose library QGPL.</div> </div> </div> <div> <div class="familylinks"> <div class="parentlink"><strong>Parent topic:</strong> <a href="objec.htm" title="This provides tasks and concepts specific to objects and libraries, including functions performed on objects, creating libraries, and specifying object authority.">Objects and libraries</a></div> </div> <div class="relref"><strong>Related reference</strong><br /> <div><a href="moola.htm" title="You can use the Move Object (MOVOBJ) command to move objects between libraries.">Move objects from one library to another</a></div> </div> <div class="relinfo"><strong>Related information</strong><br /> <div><a href="../cl/rnmobj.htm">Rename Object (RNMOBJ) command</a></div> </div> </div> </body> </html>