108 lines
6.9 KiB
HTML
108 lines
6.9 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="concept" />
|
||
|
|
<meta name="DC.Title" content="Copy File (CPYF) command with distributed files with DB2 Multisystem" />
|
||
|
|
<meta name="abstract" content="When the Copy File (CPYF) command is issued, the system tries to run the CPYF command as quickly as possible." />
|
||
|
|
<meta name="description" content="When the Copy File (CPYF) command is issued, the system tries to run the CPYF command as quickly as possible." />
|
||
|
|
<meta name="DC.subject" content="distributed file, using Copy File (CPYF) command with, CPYF (Copy File) command, using with distributed files, Copy File (CPYF) command, using with distributed files, command, CL, Copy File (CPYF), CPYF (Copy File)" />
|
||
|
|
<meta name="keywords" content="distributed file, using Copy File (CPYF) command with, CPYF (Copy File) command, using with distributed files, Copy File (CPYF) command, using with distributed files, command, CL, Copy File (CPYF), CPYF (Copy File)" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="cldf.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="cldf.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="cpdf" />
|
||
|
|
<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>Copy File (CPYF) command with distributed files with DB2 Multisystem</title>
|
||
|
|
</head>
|
||
|
|
<body id="cpdf"><a name="cpdf"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Copy File (CPYF) command with distributed files with DB2<sup>®</sup> Multisystem</h1>
|
||
|
|
<div><p>When the Copy File (CPYF) command is issued, the system tries to
|
||
|
|
run the CPYF command as quickly as possible.</p>
|
||
|
|
<p>The command parameters specified, the file attributes involved in the copy,
|
||
|
|
and the size and number of records to be copied all affect how fast the command
|
||
|
|
is run.</p>
|
||
|
|
<p>When copying data to distributed files, the performance of the copy command
|
||
|
|
can be improved by using only the following parameters on the CPYF command:
|
||
|
|
FROMFILE, TOFILE, FROMMBR, TOMBR, MBROPT, and FMTOPT(*NONE) or FMTOPT(*NOCHK).
|
||
|
|
Also, the from-file (FROMFILE) and the to-file (TOFILE) parameters should <strong>not</strong> specify
|
||
|
|
files that contain any null-capable fields. Generally, the simpler the syntax
|
||
|
|
of the copy command is, the greater the chance that the fastest copy operation
|
||
|
|
is obtained. When the fastest copy method is being used while copying to a
|
||
|
|
distributed file, message CPC9203 is issued, stating the number of records
|
||
|
|
copied to each node. Normally, if this message was not issued, the fastest
|
||
|
|
copy was not performed.</p>
|
||
|
|
<div class="p">When copying to a distributed file, you should consider the following differences
|
||
|
|
between when the fastest copy is and is not used:<ul><li><p>For the fastest copy, records are buffered for each node. As the buffers
|
||
|
|
become full, they are sent to a particular node. If an error occurs after
|
||
|
|
any records are placed in any of the node buffers, the system tries to send
|
||
|
|
all of the records currently in the node buffers to their correct node. If
|
||
|
|
an error occurs while the system is sending records to a particular node,
|
||
|
|
processing continues to the next node until the system has tried to send all
|
||
|
|
the node buffers.</p>
|
||
|
|
<p>In other words, records that follow
|
||
|
|
a particular record that is in error can be written to the distributed file.
|
||
|
|
This action occurs because of the simultaneous blocking done at the multiple
|
||
|
|
nodes. If you do not want the records that follow a record that is in error
|
||
|
|
to be written to the distributed file, you can force the fastest copy not
|
||
|
|
to be used by specifying on the CPYF command either ERRLVL(*NOMAX) or ERRLVL
|
||
|
|
with a value greater than or equal to 1.</p>
|
||
|
|
<p>When the fastest copy is not
|
||
|
|
used, record blocking is attempted unless the to-file open is or is forced
|
||
|
|
to become a SEQONLY(*NO) open.</p>
|
||
|
|
</li>
|
||
|
|
<li><p>When the fastest copy is used, a message is issued stating that the
|
||
|
|
opening of the member was changed to SEQONLY(*NO); however, the distributed
|
||
|
|
to-file is opened a second time to allow for the blocking of records. You
|
||
|
|
should ignore the message about the change to SEQONLY(*NO).</p>
|
||
|
|
</li>
|
||
|
|
<li><p>When the fastest copy is used, multiple messages are issued stating
|
||
|
|
the number of records copied to each node. A message is then sent stating
|
||
|
|
the total number of records copied.</p>
|
||
|
|
</li>
|
||
|
|
<li><p>When the fastest copy is not used, only the total number of records
|
||
|
|
copied message is sent. No messages are sent listing the number of records
|
||
|
|
copied to each node.</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>Consider the following restrictions when copying to or from distributed
|
||
|
|
files:</p>
|
||
|
|
<ul><li>The FROMRCD parameter can be specified only with a value of *START or
|
||
|
|
1 when copying from a distributed file. The TORCD parameter cannot be specified
|
||
|
|
with a value other than the default value *END when copying from a distributed
|
||
|
|
file.</li>
|
||
|
|
<li>The MBROPT(*UPDADD) parameter is not allowed when copying to a distributed
|
||
|
|
file.</li>
|
||
|
|
<li>The COMPRESS(*NO) parameter is not allowed when the to-file is a distributed
|
||
|
|
file and the from-file is a database delete-capable file.</li>
|
||
|
|
<li>For copy print listings, the RCDNBR value given is the position of the
|
||
|
|
record in the file on a particular node when the record is a distributed file
|
||
|
|
record. The same record number appears multiple times on the
|
||
|
|
listing, with each one being a record from a different node.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="cldf.htm" title="Some CL commands, when run, affect all the pieces of the distributed file.">CL commands: Affect all the pieces of a distributed file with DB2 Multisystem</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="cldf.htm" title="Some CL commands, when run, affect all the pieces of the distributed file.">CL commands: Affect all the pieces of a distributed file with DB2 Multisystem</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|