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

135 lines
7.6 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="Create duplicate objects" />
<meta name="abstract" content="You can use the Create Duplicate Object (CRTDUPOBJ) command to create a copy of an existing object." />
<meta name="description" content="You can use the Create Duplicate Object (CRTDUPOBJ) command to create a copy of an existing object." />
<meta name="DC.subject" content="CRTDUPOBJ (Create Duplicate Object) command, Create Duplicate Object (CRTDUPOBJ) command, command, CL, CRTDUPOBJ (Create Duplicate Object), Create Duplicate Object (CRTDUPOBJ), duplicate object, creating, object, duplicate, restriction, duplicating, duplicating objects" />
<meta name="keywords" content="CRTDUPOBJ (Create Duplicate Object) command, Create Duplicate Object (CRTDUPOBJ) command, command, CL, CRTDUPOBJ (Create Duplicate Object), Create Duplicate Object (CRTDUPOBJ), duplicate object, creating, object, duplicate, restriction, duplicating, duplicating objects" />
<meta name="DC.Relation" scheme="URI" content="objec.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtdupobj.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="cdupo" />
<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>Create duplicate objects</title>
</head>
<body id="cdupo"><a name="cdupo"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Create duplicate objects</h1>
<div><p>You can use the <span class="cmdname">Create Duplicate Object (CRTDUPOBJ)</span> command
to create a copy of an existing object. </p>
<div class="section"> <p>The duplicate object has the same object type and authorization
as the original object and is created into the same auxiliary storage pool
(ASP) as the original object. The user who issues the command owns the duplicate
object.</p>
<div class="note"><span class="notetitle">Note:</span> <ol><li>If you create a duplicate object of a journaled file, the duplicate object
(file) will not have journaling active. However, you can select this object
for journaling later. If you create a duplicate object and the object (file)
has no members, the last used date field is blank and the count for number
of days used is zero.</li>
</ol>
</div>
<p>You can duplicate an object if you have object management
and use authority for the object, use and add authority for the library in
which the duplicate object is to be placed, use authority for the library
in which the original object exists, and add authority for the process user
profile.</p>
<p>To duplicate an authorization list, you must have authorization
list management authority for the object and both add and object operational
authority for library QSYS.</p>
<p> Only the definitions of job queues, message
queues, output queues and data queues are duplicated. Job queues and output
queues cannot be duplicated into the temporary library (QTEMP). For a physical
file or a save file, you can specify whether the data in the file is also
to be duplicated.</p>
<p>The following objects <em>cannot</em> be duplicated:
</p>
<ul><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>Data queues (*DTAQ)</li>
<li>Documents (*DOC)</li>
<li>Edit descriptions (*EDTD)</li>
<li>Exit registration (*EXITRG)</li>
<li>Folders (*FLR)</li>
<li>DBCS font tables (*IGCTBL)</li>
<li>Image catalog (*IMGCLG)</li>
<li>Internet Packet Exchange Description (*IPXD)</li>
<li>Job schedules (*JOBSCD)</li>
<li>Journals (*JRN)</li>
<li>Journal receivers (*JRNRCV)</li>
<li>Libraries (*LIB)</li>
<li>Line descriptions (*LIND)</li>
<li>Mode descriptions (*MODD)</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>Network server descriptions (*NWSD)</li>
<li>Reference code translation tables (*RCT)</li>
<li>Server storage space (*SVRSTG)</li>
<li>Spelling aid dictionaries (*SPADCT)</li>
<li>SQL packages (*SQLPKG)</li>
<li>System/36™ machine
descriptions (*S36)</li>
<li>System operator message queue (QSYSOPR)</li>
<li>System history log (QHST)</li>
<li>Time zone description (*TIMZON)</li>
<li>User-defined SQL type (*SQLUDT)</li>
<li>User profiles (*USRPRF)</li>
<li>User queues. (*USRQ)</li>
</ul>
<p>In some cases, you may want to duplicate only some of the data in
a file by following the <span class="cmdname">Create Duplicate Object (CRTDUPOBJ)</span> command
with a <span class="cmdname">Copy File (CPYF)</span> command that specifies the selection
values.</p>
<p>The following command creates a duplicate copy of the order
header physical file, and duplicates the data in the file: </p>
<pre>CRTDUPOBJ OBJ(ORDHDRP) FROMLIB(DSTPRODLIB) OBJTYPE(*FILE) +
TOLIB(DISTLIB2) NEWOBJ(*SAME) DATA(*YES)</pre>
<p>When you create a duplicate object, you should consider the
consequences of creating a duplicate of an object that refers to another object.
Many objects refer to other objects by name, and many of these references
are qualified by a specific library name. Therefore, the duplicate object
could contain a reference to an object that exists in a library different
from the one in which the duplicate object resides. For all object types
other than files, references to other objects are duplicated in the duplicate
object. For files, the duplicate objects share the formats of the original
file.</p>
<p>Any physical files which exist in the from-library, and on which
a logical file is based, must also exist in the to-library. The record format
name and record level ID of the physical files in the to- and from-libraries
are compared; if the physical files do not match, the logical file is not
duplicated.</p>
<p>If a logical file uses a format selection that exists in
the from-library, it is assumed that the format selection also exists in the
to-library.</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="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/crtdupobj.htm">Create Duplicate Object (CRTDUPOBJ) command</a></div>
</div>
</div>
</body>
</html>