99 lines
6.0 KiB
HTML
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 &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 &1 <ul><li>Reason 1 - host variable &2 is a character or graphic string of a
|
||
|
|
different length than the value being retrieved.</li>
|
||
|
|
<li>Reason 2 - host variable &2 is a numeric type that is different than
|
||
|
|
the type of the value being retrieved.</li>
|
||
|
|
<li>Reason 3 - host variable &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 &2 is a variable length string and the value
|
||
|
|
being retrieved is not.</li>
|
||
|
|
<li>Reason 5 - host variable &2 is not a variable length string and the
|
||
|
|
value being retrieved is.</li>
|
||
|
|
<li>Reason 6 - host variable &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 &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 &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 &2 is too short to hold a
|
||
|
|
TIME or TIMESTAMP value being retrieved.</li>
|
||
|
|
<li>Reason 11 - host variable &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 &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>
|