ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/moola.htm

152 lines
9.1 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?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="reference" />
<meta name="DC.Title" content="Move objects from one library to another" />
<meta name="abstract" content="You can use the Move Object (MOVOBJ) command to move objects between libraries." />
<meta name="description" content="You can use the Move Object (MOVOBJ) command to move objects between libraries." />
<meta name="DC.subject" content="MOVOBJ (Move Object) command, Move Object (MOVOBJ) command, command, CL, MOVOBJ (Move Object), Move Object (MOVOBJ), moving, object from one library to another, object, moving between libraries, restriction, moving object, example, moving object" />
<meta name="keywords" content="MOVOBJ (Move Object) command, Move Object (MOVOBJ) command, command, CL, MOVOBJ (Move Object), Move Object (MOVOBJ), moving, object from one library to another, object, moving between libraries, restriction, moving object, example, moving object" />
<meta name="DC.Relation" scheme="URI" content="objec.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/movobj.htm" />
<meta name="DC.Relation" scheme="URI" content="renob.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="moola" />
<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>Move objects from one library to another</title>
</head>
<body id="moola"><a name="moola"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Move objects from one library to another</h1>
<div><p>You can use the <span class="cmdname">Move Object (MOVOBJ)</span> command
to move objects between libraries. </p>
<div class="section"><p>Moving objects from one library to another is useful in that you
make an object temporarily unavailable and it lets you replace an out-of-date
version of an object with a new version. For example, a new primary file
can be created to be temporarily placed in a library other than the one containing
the old primary file. Because the data in the old primary file is normally
copied to the new primary file, the old primary file cannot be deleted until
the new primary file has been created. Then, the old primary file can be
deleted and the new primary file can be moved to the library that contained
the old primary file.</p>
<p>You can only move an object if you have object
management authority for the object, delete and execute authority for the
library the object is being moved from, and add and read authority to the
library the object is being moved to.</p>
<p>You can move an object out of
the temporary library, QTEMP, but you cannot move an object into QTEMP. Also,
you cannot move an output queue unless it is empty.</p>
<p>Moving journals
and journal receivers is limited to moving these object types back into the
library in which they were originally created. If the journal objects have
been placed into QRCL by a <span class="cmdname">Reclaim Storage (RCLSTG)</span> command,
they must be moved back into their original library to be made operational.</p>
<p>The
following is a list of objects that <em>cannot</em> be moved:</p>
<ul><li>Authorization lists (*AUTL)</li>
<li>Class-of-service descriptions (*COSD)</li>
<li>Cluster resource group (*CRG)</li>
<li>Configuration lists (*CFGL)</li>
<li>Connection lists (*CNNL)</li>
<li>Controller descriptions (*CTLD)</li>
<li>Data dictionaries (*DTADCT)</li>
<li>Device descriptions (*DEVD)</li>
<li>Display station message queues (*MSGQ)</li>
<li>Documents (*DOC)</li>
<li>Edit descriptions (*EDTD)</li>
<li>Exit registration (*EXITRG)</li>
<li>Folders (*FLR)</li>
<li>Double-Byte Character Set (DBCS) font tables (*IGCTBL)</li>
<li>Image catalog (*IMGCLG)</li>
<li>Internet Packet Exchange Description (*IPXD)</li>
<li>Job schedules (*JOBSCD)</li>
<li>Libraries (*LIB)</li>
<li>Line descriptions (*LIND)</li>
<li>Mode descriptions (*MODD)</li>
<li>NetBIOS description (*NTBD)</li>
<li>Network interface descriptions (*NWID)</li>
<li><img src="./delta.gif" alt="Start of change" />Network Server Configuration (*NWSCFG)<img src="./deltaend.gif" alt="End of change" /></li>
<li>Structured Query Language (SQL) packages (*SQLPKG)</li>
<li>System/36™ machine
descriptions (*S36)</li>
<li>The system history log (QHST)</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>
</div>
<div class="section"><p>In the following example, a file from QGPL (where it was placed
when it was created) is moved to the order entry library DISTLIB so that it
is grouped with other order entry files.</p>
<br /><img src="rbafn528.gif" alt="This example shows a file from QGPL (where it was placed when it was created) is moved to the order entry library DISTLIB so that it is grouped with other order entry files." /><br /><p>To move the object, you must
specify the to-library (TOLIB) as well as the object type (OBJTYPE): </p>
<pre>MOVOBJ OBJ(QGPL/ORDFILL) OBJTYPE(*FILE) TOLIB(DISTLIB)</pre>
<p>When you move objects, you should be careful not to move objects
that other objects depend on. For example, CL procedures may depend on the
command definitions of the commands used in the procedure to be in the same
library at run time as they were at module creation time. At compile time
and at run time, the command definitions are found either in the specified
library or in a library in the library list if *LIBL is specified. If a library
name is specified, the command definitions must be in the same library at
run time as they were at compile time. If *LIBL is specified, the command
definitions can be moved between compile time and program run time as long
as they are moved to a library in the library list. Similarly, any application
program you write can depend on certain objects being in specific libraries.</p>
</div>
<div class="section"><p>An object referring to another object may be dependent on the
location of that object (even though *LIBL can be specified for the location
of the object). Therefore, if you move an object, you should change any references
to it in other objects. The following lists examples of objects that refer
to other objects:</p>
<ul><li>Subsystem descriptions refer to job queues, classes, message queues, and
programs.</li>
<li>Command definitions refer to programs, message files, help panel groups,
and source files that are containing REXX procedures.</li>
<li>Device files refer to output queues.</li>
<li>Device descriptions refer to translation tables.</li>
<li>Job descriptions refer to job queues and output queues.</li>
<li>Database files refer to other database files.</li>
<li>Logical files refer to physical files or format selections.</li>
<li>User profiles refer to programs, menus, job descriptions, message queues,
and output queues.</li>
<li>CL programs refer to display files, data areas, and other programs.</li>
<li>Display files refer to database files.</li>
<li>Printer files refer to output queues.</li>
</ul>
<div class="note"><span class="notetitle">Note:</span> You should be careful when moving objects from 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, particularly for job and
output queues.</div>
<p>The <span class="cmdname">Move Object (MOVOBJ)</span> command
moves only one object at a time.</p>
</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="reltasks"><strong>Related tasks</strong><br />
<div><a href="renob.htm" title="You can use the Rename Object (RNMOBJ) command to rename objects.">Rename objects</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/movobj.htm">Move Object (MOVOBJ) command</a></div>
</div>
</div>
</body>
</html>