ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajq_5.4.0.1/sql7919.htm

99 lines
6.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="SQL7919 - Data conversion required on FETCH or embedded SELECT" />
<meta name="DC.Relation" scheme="URI" content="pimesodp.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="sql7919" />
<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>SQL7919 - Data conversion required on FETCH or embedded SELECT</title>
</head>
<body id="sql7919"><a name="sql7919"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SQL7919 - Data conversion required on FETCH or embedded SELECT</h1>
<div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" align="center" valign="middle" id="d0e16">SQL7919</th>
</tr>
</thead>
<tbody><tr valign="middle"><td valign="middle" width="26.02040816326531%" headers="d0e16 ">Message Text:</td>
<td valign="middle" width="73.9795918367347%" headers="d0e16 ">Data conversion required on FETCH or embedded SELECT.</td>
</tr>
<tr valign="middle"><td valign="middle" width="26.02040816326531%" headers="d0e16 ">Cause Text:</td>
<td valign="middle" width="73.9795918367347%" headers="d0e16 ">Host variable &amp;2 requires conversion. The data retrieved for the
FETCH or embedded SELECT statement cannot be directly moved to the host variables.
The statement ran correctly. Performance, however, would be improved if no
data conversion was required. The host variable requires conversion for reason &amp;1 <ul><li>Reason 1 - host variable &amp;2 is a character or graphic string of a
different length than the value being retrieved.</li>
<li>Reason 2 - host variable &amp;2 is a numeric type that is different than
the type of the value being retrieved.</li>
<li>Reason 3 - host variable &amp;2 is a C character or C graphic string that
is NUL-terminated, the program was compiled with option *CNULRQD specified,
and the statement is a multiple-row FETCH.</li>
<li>Reason 4 - host variable &amp;2 is a variable length string and the value
being retrieved is not.</li>
<li>Reason 5 - host variable &amp;2 is not a variable length string and the
value being retrieved is.</li>
<li>Reason 6 - host variable &amp;2 is a variable length string whose maximum
length is different than the maximum length of the variable length value being
retrieved.</li>
<li>Reason 7 - a data conversion was required on the mapping of the value
being retrieved to host variable &amp;2, such as a CCSID conversion</li>
<li>Reason 8 - a DRDA<sup>®</sup> connection was used to get the value being retrieved
into host variable &amp;2. The value being retrieved is either null capable
or varying-length, is contained in a partial row, or is a derived expression.</li>
<li>Reason 10 - the length of host variable &amp;2 is too short to hold a
TIME or TIMESTAMP value being retrieved.</li>
<li>Reason 11 - host variable &amp;2 is of type DATE, TIME or TIMESTAMP, and
the value being retrieved is a character string.</li>
<li>Reason 12 - too many host variables were specified and records are blocked.
Host variable &amp;2 does not have a corresponding column returned from the
query.</li>
<li>Reason 13 - a DRDA connection was used for a blocked FETCH and the
number of host variables specified in the INTO clause is less than the number
of result values in the select list.</li>
<li>Reason 14 - a LOB Locator was used and the commitment control level of
the process was not *ALL.</li>
</ul>
</td>
</tr>
<tr valign="middle"><td valign="middle" width="26.02040816326531%" headers="d0e16 ">Recovery Text:</td>
<td valign="middle" width="73.9795918367347%" headers="d0e16 ">To get better performance, attempt to use host variables of the same
type and length as their corresponding result columns.</td>
</tr>
</tbody>
</table>
</div>
<div class="section"><p>When mapping data to host variables, data conversions were required.
When these statements are run in the future, they will be slower than if no
data conversions were required. The statement ran successfully, but performance
could be improved by eliminating the data conversion. For example, a data
conversion that would cause this message to occur would be the mapping of
a character string of a certain length to a host variable character string
with a different length. You could also cause this error by mapping a numeric
value to a host variable that is a different type (decimal to integer). To
prevent most conversions, use host variables that are of identical type and
length as the columns that are being fetched.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="pimesodp.htm" title="Several of the following SQL run-time messages refer to open data paths.">Query optimization performance information messages and open data paths</a></div>
</div>
</div>
</body>
</html>