ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajp_5.4.0.1/rzajpstringrule.htm

75 lines
5.0 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="reference" />
<meta name="DC.Title" content="Rules for string assignment of host variables in SQL statements" />
<meta name="abstract" content="This topic introduces rules regarding character string assignment." />
<meta name="description" content="This topic introduces rules regarding character string assignment." />
<meta name="DC.subject" content="string assignment, rule using host variable, host variable, string assignment, rule, assignment rule, string" />
<meta name="keywords" content="string assignment, rule using host variable, host variable, string assignment, rule, assignment rule, string" />
<meta name="DC.Relation" scheme="URI" content="rzajpasnrule.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="rzajpstringrule" />
<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>Rules for string assignment of host variables in SQL statements</title>
</head>
<body id="rzajpstringrule"><a name="rzajpstringrule"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Rules for string assignment of host variables in SQL statements</h1>
<div><p>This topic introduces rules regarding character string assignment.</p>
<div class="section"><p>The rules are as follows:</p>
<ul><li>When a character or graphic string is assigned to a column, the length
of the string value must not be greater than the length attribute of the column.
(Trailing blanks are normally included in the length of the string. However,
for string assignment, trailing blanks are not included in the length of the
string.)</li>
<li>When a binary string is assigned to a column, the length of the string
value must not be greater than the length attribute of the column. (Hexadecimal
zeros are normally included in the length of the string. However, for string
assignment, hexadecimal zeros are not included in the length of the string.)</li>
<li>When a MIXED character result column is assigned to a MIXED column, the
value of the MIXED character result column must be a valid MIXED character
string.</li>
<li>When the value of a result column is assigned to a host
variable and the string value of the result column is longer than the length
attribute of the host variable, the string is truncated on the right by the
necessary number of characters. If this occurs, SQLWARN0 and SQLWARN1 (in
the SQL communication area (SQLCA)) are set to W.</li>
<li>When the value of a result column is assigned to a fixed-length character
or graphic host variable or when the value of a host variable is assigned
to a fixed-length character or graphic result column and the length of the
string value is less than the length attribute of the target, the string is
padded on the right with the necessary number of blanks.</li>
<li>When the value of a result column is assigned to a fixed-length binary
host variable or when the value of a host variable is assigned to a fixed-length
binary result column and the length of the string value is less than the length
attribute of the target, the string is padded on the right with the necessary
number of hexadecimal zeros.</li>
<li>When a MIXED character result column is truncated because the length of
the host variable into which it was being assigned was less than the length
of the string, the shift-in character at the end of the string is preserved.
The result, therefore, is still a valid MIXED character string.</li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajpasnrule.htm" title="SQL values are assigned to host variables during the running of FETCH, SELECT INTO, SET, and VALUES INTO statements. SQL values are assigned from host variables during the running of INSERT, UPDATE, and CALL statements.">Assignment rules for host variables in SQL statements</a></div>
</div>
</div>
</body>
</html>