118 lines
6.7 KiB
HTML
118 lines
6.7 KiB
HTML
<?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> |