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

141 lines
11 KiB
HTML
Raw 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="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="Conversion rules for copying files" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="DC.subject" content="conversion, rules for copying files, copying file, conversion rules, field, mapping, character field, conversions, character, packed decimal field conversions, zoned decimal field conversion, floating-point, field conversions, binary field conversion, binary, with decimal positions, binary, no decimal positions, character field, character fields, numeric fields, numeric field, numeric, numeric fields, default (DFT) keyword, mapping fields" />
<meta name="keywords" content="conversion, rules for copying files, copying file, conversion rules, field, mapping, character field, conversions, character, packed decimal field conversions, zoned decimal field conversion, floating-point, field conversions, binary field conversion, binary, with decimal positions, binary, no decimal positions, character field, character fields, numeric fields, numeric field, numeric, numeric fields, default (DFT) keyword, mapping fields" />
<meta name="DC.Relation" scheme="URI" content="rbal3copydbmbrfmt.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3convr" />
<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>Conversion rules for copying files</title>
</head>
<body id="rbal3convr"><a name="rbal3convr"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Conversion rules for copying files</h1>
<div><p></p>
<p>The <a href="#rbal3convr__rbal3fldcon">Table 1</a> table below shows the
field conversions that are allowed between mapped fields in the from-file
and to-file record formats. If fields with the same name have incompatible
attributes between the from-file and to-file formats, you can only use FMTOPT(*NOCHK)
to perform the copy. An X indicates that the conversion is valid, and a blank
indicates a field mapping that is not valid.</p>
<p>When mapping character fields, the field being copied is truncated on the
right if it is longer than the field into which the copy is made. For example,
a character field of length 10 is copied into a character field of length
6; ABCDEFGHIJ becomes ABCDEF. If the field that is being copied is shorter
than the field into which it is copied, the field is padded on the right with
blanks. For example, a character field of length 10 is copied into a character
field of length 12; ABCDEFGHIJ becomes ABCDEFGHIJxx (x = blank).</p>
<p>When you are mapping numeric fields, and the field being copied is longer
than the field into which the copy is made, the field being copied is truncated
on the left and right of the decimal point. For example, a zoned decimal field
of length 9 with 4 decimal positions is copied to a zoned decimal field of
length 6 with 3 decimal positions; 00115.1109 becomes 115.110.</p>
<p>If significant digits must be truncated to the left of the decimal point,
the value is not copied, and the field is set to its default value (either
the parameter value of the DFT keyword, if specified, or zero, if the DFT
keyword is not specified). Also, if significance will be lost because a floating-point
numeric value exponent is too large, the to-file field is set to its default
value.</p>
<p>When you are mapping numeric fields for which the field that is being copied
is shorter than the field into which the copy is made, the field being copied
is padded with zeros on the left and right of the decimal point. For example,
a packed decimal field of length 7 with 5 decimal positions is copied to a
packed decimal field of length 10 with 6 decimal positions; 99.99998 becomes
0099.999980.</p>
<div class="tablenoborder"><a name="rbal3convr__rbal3fldcon"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rbal3convr__rbal3fldcon" width="100%" frame="border" border="1" rules="all"><caption>Table 1. Field conversions. (This table is not applicable to FMTOPT(*CVTFLOAT) or FMTOPT(*NULLFLAGS),
where the from-file data is defined by the to-file.)</caption><thead align="left"><tr><th align="left" valign="bottom" width="15.555555555555555%" id="d0e119">From field</th>
<th align="left" valign="bottom" width="13.333333333333334%" id="d0e121">To character, binary character or hexadecimal
field</th>
<th align="left" valign="bottom" width="14.074074074074074%" id="d0e123">To packed decimal field</th>
<th align="left" valign="bottom" width="14.444444444444443%" id="d0e125">To zoned decimal field</th>
<th align="left" valign="bottom" width="14.074074074074074%" id="d0e127">To binary (no decimals positions) field</th>
<th align="left" valign="bottom" width="14.444444444444443%" id="d0e129">To floating point field</th>
<th align="left" valign="bottom" width="14.074074074074074%" id="d0e131">To binary field (with decimals positions)</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="15.555555555555555%" headers="d0e119 ">Character, binary character or hexadecimal</td>
<td align="left" valign="top" width="13.333333333333334%" headers="d0e121 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e123 ">&nbsp;</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e125 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e127 ">&nbsp;</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e129 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e131 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="15.555555555555555%" headers="d0e119 ">Packed</td>
<td align="left" valign="top" width="13.333333333333334%" headers="d0e121 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e123 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e125 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e127 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e129 "> X</td>
<td valign="top" width="14.074074074074074%" headers="d0e131 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="15.555555555555555%" headers="d0e119 ">Zoned</td>
<td align="left" valign="top" width="13.333333333333334%" headers="d0e121 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e123 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e125 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e127 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e129 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e131 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="15.555555555555555%" headers="d0e119 ">Binary (no decimal positions)</td>
<td align="left" valign="top" width="13.333333333333334%" headers="d0e121 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e123 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e125 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e127 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e129 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e131 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="15.555555555555555%" headers="d0e119 ">Floating point</td>
<td align="left" valign="top" width="13.333333333333334%" headers="d0e121 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e123 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e125 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e127 "> X</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e129 "> X</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e131 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="15.555555555555555%" headers="d0e119 ">Binary (with decimal positions)</td>
<td align="left" valign="top" width="13.333333333333334%" headers="d0e121 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e123 ">&nbsp;</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e125 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e127 ">&nbsp;</td>
<td align="left" valign="top" width="14.444444444444443%" headers="d0e129 ">&nbsp;</td>
<td align="left" valign="top" width="14.074074074074074%" headers="d0e131 ">X<sup>1</sup></td>
</tr>
<tr><td colspan="7" align="left" valign="top" headers="d0e119 d0e121 d0e123 d0e125 d0e127 d0e129 d0e131 "> <div class="note"><span class="notetitle">Note:</span> <dl><dt class="dlterm"><sup>1</sup></dt>
<dd>A binary numeric field with one or more decimal positions can be copied
only to a binary field with the same number of decimal positions.</dd>
</dl>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3copydbmbrfmt.htm" title="When you copy from a database file to a database file, you must use the FMTOPT parameter if the record formats are not identical or if the files are different types (source or data). If either file is a device file or inline data file, the FMTOPT parameter does not apply. The records are truncated or padded with blanks or zeros when record lengths are different. A message is sent if the records are truncated.">Copying between different database record formats (FMTOPT parameter)</a></div>
</div>
</div>
</body>
</html>