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

73 lines
4.4 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="Key string comparisons made by the copy operation" />
<meta name="abstract" content="When the TOKEY value is specified, the check made by the copy operation is a logical character comparison between the key string for each record retrieved. The key strings can be specified explicitly using the first TOKEY parameter format or built implicitly by the copy operation that uses the list of values that are given." />
<meta name="description" content="When the TOKEY value is specified, the check made by the copy operation is a logical character comparison between the key string for each record retrieved. The key strings can be specified explicitly using the first TOKEY parameter format or built implicitly by the copy operation that uses the list of values that are given." />
<meta name="DC.Relation" scheme="URI" content="rbal3copyrrk.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3keystring" />
<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>Key string comparisons made by the copy operation</title>
</head>
<body id="rbal3keystring"><a name="rbal3keystring"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Key string comparisons made by the copy operation</h1>
<div><p>When the TOKEY value is specified, the check made by the copy operation
is a logical character comparison between the key string for each record retrieved.
The key strings can be specified explicitly using the first TOKEY parameter
format or built implicitly by the copy operation that uses the list of values
that are given.</p>
<p>A warning message is sent (but the copy operation continues) if this comparison
gives different results than the ordering in which the database identifies
the records in the keyed access path. The order might be different if:</p>
<ul><li>The key contains mixed ascending and descending fields</li>
<li>The key contains fields for which a sort sequence other than *HEX is in
effect OR</li>
<li>The key contains any of the following DDS keywords: <dl><dt class="dlterm">ABSVAL</dt>
<dd>Absolute value</dd>
<dt class="dlterm">ALTSEQ</dt>
<dd>Alternative collating sequence</dd>
<dt class="dlterm">ALWNULL</dt>
<dd>Allow null</dd>
<dt class="dlterm">DATFMT</dt>
<dd>Date format (*MDY, *DMY, *YMD, *JUL, SAA<sup>®</sup> *EUR, or SAA *USA)</dd>
<dt class="dlterm">DIGIT</dt>
<dd>Digit force</dd>
<dt class="dlterm">SIGNED</dt>
<dd>Signed numeric</dd>
<dt class="dlterm">TIMFMT</dt>
<dd>Time format (*USA)</dd>
<dt class="dlterm">ZONE</dt>
<dd>Zone force</dd>
</dl>
</li>
</ul>
<p>If there are both ascending and descending fields in the file key, the
first (the far left) key field determines whether the copy operation uses
an ascending or descending key test to look for the last record to copy.</p>
<p>Using *BLDKEY is the easiest way to specify (and ensure correct padding)
values for packed, binary, and floating-point fields.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3copyrrk.htm" title="You can specify record keys to copy only from a keyed database file. Note that you can use this parameter on the CPYF command only.">Select records by record keys (FROMKEY and TOKEY Parameters)</a></div>
</div>
</div>
</body>
</html>