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

225 lines
13 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="reference" />
<meta name="DC.Title" content="Copy nonspooled DBCS files" />
<meta name="abstract" content="You can use the Copy File (CPYF) command to copy double-byte data from one file to another." />
<meta name="description" content="You can use the Copy File (CPYF) command to copy double-byte data from one file to another." />
<meta name="DC.subject" content="copying file, DBCS, nonspooled, Copy File (CPYF) command, double-byte data, command, CL, CPYF (Copy File), mapping, DBCS fields, conversion rules" />
<meta name="keywords" content="copying file, DBCS, nonspooled, Copy File (CPYF) command, double-byte data, command, CL, CPYF (Copy File), mapping, DBCS fields, conversion rules" />
<meta name="DC.Relation" scheme="URI" content="rbal3ptr6.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3cpynsdbcsf" />
<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 nonspooled DBCS files</title>
</head>
<body id="rbal3cpynsdbcsf"><a name="rbal3cpynsdbcsf"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Copy nonspooled DBCS files</h1>
<div><p>You can use the Copy File (CPYF) command to copy double-byte data
from one file to another.</p>
<div class="section"><div class="p">When copying data from a double-byte database file to an alphanumeric
database file, specify one of the following parameters on the
CPYF command: <ul><li>If both files are source files or if both files are database files, you
can specify either the FMTOPT(*MAP) parameter or the FMTOPT(*NOCHK) parameter.</li>
<li>If one file is a source file and the other file is a database file, specify
the FMT(*CVTSRC) parameter.</li>
</ul>
</div>
</div>
<div class="section"><p>When you copy DBCS files to alphanumeric files, the server sends
you an informational message describing the difference in file types.</p>
<p>Either
the FMTOPT(*MAP) or FMTOPT(*NOCHK) option of the copy file function must be
specified for copies from a physical or logical file to a physical file when
there are fields with the same name in the from-file and to-file, but the
data type for fields is as shown in the following table.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="hsides" border="0" rules="none"><thead align="left"><tr><th align="left" valign="top" width="50%" id="d0e55">From-File Field Data Type</th>
<th align="left" valign="top" width="50%" id="d0e57">To-File Field Data Type</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (character)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">O (DBCS-open)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">O (DBCS-open)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">E (DBCS-either)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">E (DBCS-either)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">J (DBCS-only)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (DBCS-graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">O (DBCS-open)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (DBCS-graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">E (DBCS-either)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (DBCS-graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (DBCS-graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (DBCS-graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">O (DBCS-open)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (DBCS-graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">E (DBCS-either)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (Character (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">O (DBCS-open (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">E (DBCS-either (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (DBCS-graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (Character (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">O (DBCS-open (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">E (DBCS-either (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">J (DBCS-only (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (DBCS-graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (Character (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">O (DBCS-open (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">E (DBCS-either (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (DBCS-graphic non-65535)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (UTF-8)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (Character (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">O (DBCS-open (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">E (DBCS-either (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">J (DBCS-only (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (DBCS-graphic non-65535)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (Character (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">O (DBCS-open (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">E (DBCS-either (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">J (DBCS-only (CCSID non-65535))</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (DBCS-graphic non-65535)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">A (UTF-8)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UTF-16)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UCS-2 graphic)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">A (Character (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">O (DBCS-open (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">E (DBCS-either (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">J (DBCS-only (CCSID non-65535))</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (DBCS-graphic non-65535)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
<tr><td align="left" valign="top" width="50%" headers="d0e55 ">G (UCS-2 graphic)</td>
<td align="left" valign="top" width="50%" headers="d0e57 ">G (UTF-16)</td>
</tr>
</tbody>
</table>
</div>
<div class="p">When you use FMTOPT(*MAP) on the CPYF command to copy data to a
DBCS-only field or DBCS-graphic field, the corresponding field in the from-file
must <em>not</em> be: <ul><li>Less than a 2-byte character field</li>
<li>An odd-byte-length character field</li>
<li>An odd-byte-length DBCS-open field</li>
</ul>
</div>
<div class="note"><span class="notetitle">Note:</span> DBCS-graphic is the only type allowed to be CCSID 65535 when
using FMTOPT(*MAP) copying from or to a UCS-2 graphic field. UCS-2 graphic <em>cannot
be</em> CCSID 65535.</div>
<p>If you attempt to copy with one of these specified
in the from-field, an error message is sent.</p>
<p>When you copy double-byte
data from one database file to another with the FMTOPT(*MAP) parameter specified,
double-byte data will be copied correctly. The server will perform correct
padding and truncation of double-byte data to ensure data integrity.</p>
<p>When
using the CPYF command with FMTOPT(*MAP) to copy a DBCS-open field to a graphic
field, a conversion error occurs if the DBCS-open field contains any SBCS
data (including blanks).</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3ptr6.htm" title="You can copy both spooled and nonspooled DBCS files.">Copy DBCS files</a></div>
</div>
</div>
</body>
</html>