ibm-information-center/dist/eclipse/plugins/i5OS.ic.dm_5.4.0.1/rbal3adding.htm

73 lines
4.8 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="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<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="concept" />
<meta name="DC.Title" content="How the copy function adds members to the to-file" />
<meta name="abstract" content="The copy function adds a member to the to-file when the member does not exist. The member name used is either the TOMBR parameter value from the copy command, or the member name that is specified in an override for the to-file." />
<meta name="description" content="The copy function adds a member to the to-file when the member does not exist. The member name used is either the TOMBR parameter value from the copy command, or the member name that is specified in an override for the to-file." />
<meta name="DC.Relation" scheme="URI" content="rbal3selmem.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3adding" />
<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>How the copy function adds members to the to-file</title>
</head>
<body id="rbal3adding"><a name="rbal3adding"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">How the copy function adds members to the to-file</h1>
<div><p>The copy function adds a member to the to-file when the member
does not exist. The member name used is either the TOMBR parameter value from
the copy command, or the member name that is specified in an override for
the to-file.</p>
<p>If TOMBR(*FROMMBR) or TOMBR(*FROMLABEL) is specified on the copy command
(and is not overridden), the from-file member names or label identifiers are
used for the members added to the file.</p>
<div class="p">If TOMBR(*FIRST) is specified on the copy command, or if there is an override
that specifies a TOFILE parameter with no MBR parameter, then no member name
is known. The copy function does not add a member in this case unless the
following conditions are true: <ul><li>You specified CRTFILE(*YES) on the copy command</li>
<li>The copy function must create the to-file</li>
</ul>
</div>
<p>Except for the CPYFRMQRYF command, when the copy function creates the to-file
without a specific member name specified, the from-file name is used for the
member that is added to the to-file. When using the CPYFRMQRYF command, the
member added to the physical file that is created by the copy operation has
the name specified by the TOMBR parameter. If you specify TOMBR(*FIRST), the
to-file member has the same name as the to-file file name that is specified
on the TOFILE parameter of the CPYFRMQRYF command. The copy command ignores
the MBROPT parameter value when it creates the to-file, and adds records to
the new file members.</p>
<p>If the from-file is a database file, the copy command uses the member text
and SEU source type of the from-file member for the member that is added to
the to-file. If the from-file is a device or inline data file, the copy command
takes the text from message CPX0411; the SEU source type is TXT. If both the
from-file and to-file are database source files, the SEU source type information
in the added member will be the same as the from-file member. When it adds
the to-file member, the copy command always assigns the SHARE(*NO) and EXPDATE(*NONE)
attributes to the to-file member. The copy command also sets the creation
date of the new member to the current system date (not the date when the from-file
member was added).</p>
<p>When the copy command adds a member to a to-file that is a parent file,
the constraint becomes established at that time.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3selmem.htm" title="iSeries gives you several options for copying file members.">Select members to copy</a></div>
</div>
</div>
</body>
</html>