539 lines
23 KiB
HTML
539 lines
23 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 xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="dc.language" scheme="rfc1766" 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. -->
|
||
|
|
<meta name="dc.date" scheme="iso8601" content="2005-09-19" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<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="keywords" content="values for CONNECT, SQLERRMC field of SQLCA,
|
||
|
|
values for SET CONNECTION" />
|
||
|
|
<title>Field descriptions</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
||
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
|
||
|
|
|
||
|
|
<a name="fielddescsqlca"></a>
|
||
|
|
<h2 id="fielddescsqlca"><a href="rbafzmst02.htm#ToC_1494">Field descriptions</a></h2>
|
||
|
|
<p>The names in the following table are those provided by the SQL INCLUDE
|
||
|
|
statement. For the most part, C (and C++), COBOL, FORTRAN and PL/I use the
|
||
|
|
same names. RPG names are different, because in RPG/400®, they are limited to 6 characters.
|
||
|
|
In ILE RPG, both a long name and the short 6 character name is supported.
|
||
|
|
Note one instance where PL/I names differ from the COBOL names.</p>
|
||
|
|
<a name="wq1951"></a>
|
||
|
|
<table id="wq1951" width="100%" summary="" border="1" frame="hsides" rules="rows">
|
||
|
|
<caption>Table 88. Names Provided by the SQL INCLUDE Statement</caption>
|
||
|
|
<thead valign="bottom">
|
||
|
|
<tr>
|
||
|
|
<th id="wq1952" width="14%" align="left" valign="bottom">
|
||
|
|
<div class="lines">C Name<br />
|
||
|
|
COBOL Name<br />
|
||
|
|
PL/I Name <br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1953" width="15%" align="left" valign="bottom">
|
||
|
|
<div class="lines">FORTRAN<sup>1</sup><br />
|
||
|
|
Name<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1954" width="14%" align="left" valign="bottom">
|
||
|
|
<div class="lines">ILE RPG Name<br />
|
||
|
|
RPG/400 Name<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1955" width="14%" align="left" valign="bottom">
|
||
|
|
<div class="lines">Field<br />
|
||
|
|
Data Type<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1956" width="40%" align="left" valign="bottom">Field Value</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody valign="top">
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLCAID sqlcaid</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">Not used SQLCAID</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLCAID SQLAID</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">CHAR(8)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">An "eye catcher" for storage dumps,
|
||
|
|
containing 'SQLCA'.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLCABC sqlcabc</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">Not used SQLCABC</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLCABC SQLABC</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">INTEGER</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">Contains the length of the SQLCA, 136.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLCODE sqlcode</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLCOD SQLCODE</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLCODE SQLCOD</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">INTEGER</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">Contains an SQL return code.
|
||
|
|
<dl>
|
||
|
|
<dt class="bold">Code</dt>
|
||
|
|
<dd class="bold">Meaning</dd>
|
||
|
|
<dt class="bold">0</dt>
|
||
|
|
<dd>Successful execution although SQLWARN indicators might have been set.
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">positive</dt>
|
||
|
|
<dd>Successful execution, but with a warning condition.
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">negative</dt>
|
||
|
|
<dd>Error condition.
|
||
|
|
</dd>
|
||
|
|
</dl></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLERRML<sup>2</sup> sqlerrml</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLTXL SQLERRML</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLERRML SQLERL</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">SMALLINT</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">Length indicator for SQLERRMC, in the range
|
||
|
|
0 through 70. 0 means that the value of SQLERRMC is not pertinent.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLERRMC<sup>2</sup> sqlerrmc</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLTXT SQLERRMC</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLERRMC SQLERM</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">CHAR (70)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">Contains message replacement text associated
|
||
|
|
with the SQLCODE. For CONNECT and SET CONNECTION, the SQLERRMC field contains
|
||
|
|
information about the connection, see <a href="rbafzmstfielddescsqlca.htm#newxxj">Table 91</a> for a description
|
||
|
|
of the replacement text.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLERRP sqlerrp</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLERP SQLERRP</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLERRP SQLERP</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">CHAR(8)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">Contains the name of the product and module
|
||
|
|
returning the error or warning. The first three characters identify the product:
|
||
|
|
<ul class="simple">
|
||
|
|
<li>ARI for DB2 for VM and VSE</li>
|
||
|
|
<li>DSN for DB2 UDB for z/OS</li>
|
||
|
|
<li>QSQ for DB2 UDB for iSeries</li>
|
||
|
|
<li>SQL for all other DB2® products</li></ul>See <a href="rbafzmstconj1.htm#conj1">CONNECT (Type 1)</a> or <a href="rbafzmstcon2t.htm#con2t">CONNECT (Type 2)</a> for
|
||
|
|
additional information.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLERRD sqlerrd</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLERR SQLERRD</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLERRD SQLERR<sup>3</sup></td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">Array</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">Contains six INTEGER variables that provide
|
||
|
|
diagnostic information, see <a href="rbafzmstfielddescsqlca.htm#newxxk">Table 90</a> for a description of the
|
||
|
|
diagnostic information.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLWARN sqlwarn</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLWRN SQLWARN</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLWARN SQLWRN<sup>4</sup></td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">CHAR(11)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">A set of 11 CHAR(1) warning indicators, each
|
||
|
|
containing blank or 'W' or 'N'.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1952">SQLSTATE sqlstate</td>
|
||
|
|
<td align="left" valign="top" headers="wq1953">SQLSTT SQLSTATE</td>
|
||
|
|
<td align="left" valign="top" headers="wq1954">SQLSTATE SQLSTT</td>
|
||
|
|
<td align="left" valign="top" headers="wq1955">CHAR(5)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1956">A return code that indicates the outcome
|
||
|
|
of the most recently executed SQL statement.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td colspan="5" align="left" valign="top" headers="wq1952 wq1953 wq1954 wq1955 wq1956">
|
||
|
|
<a name="wq1957"></a>
|
||
|
|
<div class="notetitle" id="wq1957">Notes:</div>
|
||
|
|
<div class="notebody">
|
||
|
|
<dl>
|
||
|
|
<dt class="bold"><sup>1</sup></dt>
|
||
|
|
<dd>The first name indicates the IBM® SQL SQLCA names for the FORTRAN SQLCA.
|
||
|
|
The second name indicates an alternative name that is available due to the DB2 UDB for iSeries implementation
|
||
|
|
of the SQLCA in FORTRAN.
|
||
|
|
</dd>
|
||
|
|
<dt class="bold"><sup>2</sup></dt>
|
||
|
|
<dd>In COBOL, SQLERRM includes SQLERRML and SQLERRMC. In PL/I, the varying-length
|
||
|
|
string SQLERRM is equivalent to SQLERRML prefixed to SQLERRMC.
|
||
|
|
</dd>
|
||
|
|
<dt class="bold"><sup>3</sup></dt>
|
||
|
|
<dd>In RPG/400, SQLERR is defined as 24 characters (not an array) that are redefined
|
||
|
|
by the fields SQLER1 through SQLER6. The fields are full-word binary. In ILE
|
||
|
|
RPG, SQLERR is also redefined as an array. The name of the array is SQLERRD.
|
||
|
|
</dd>
|
||
|
|
<dt class="bold"><sup>4</sup></dt>
|
||
|
|
<dd>In RPG/400, SQLWRN is defined as 11 characters (not an array) that are redefined
|
||
|
|
by the fields SQLWN0 through SQLWNA. The fields are full-word binary. In ILE
|
||
|
|
RPG, SQLWRN is also redefined as an array. The name of the array is SQLWARN.
|
||
|
|
</dd>
|
||
|
|
</dl></div></td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
<a name="wq1958"></a>
|
||
|
|
<table id="wq1958" width="100%" summary="" border="1" frame="hsides" rules="rows">
|
||
|
|
<caption>Table 89. SQLWARN Diagnostic Information</caption>
|
||
|
|
<thead valign="bottom">
|
||
|
|
<tr>
|
||
|
|
<th id="wq1959" width="16%" align="left" valign="bottom">
|
||
|
|
<div class="lines">C Name<br />
|
||
|
|
COBOL Name<br />
|
||
|
|
PL/I Name <br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1960" width="16%" align="left" valign="bottom">
|
||
|
|
<div class="lines">FORTRAN<sup>1</sup><br />
|
||
|
|
Name<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1961" width="16%" align="left" valign="bottom">
|
||
|
|
<div class="lines">ILE RPG Name<br />
|
||
|
|
RPG/400 Name<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1962" width="50%" align="left" valign="bottom">Field Value</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody valign="top">
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN0<br />
|
||
|
|
sqlwarn[0]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(0) SQLWARN(1:1)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(1) SQLWN0</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if at least one other
|
||
|
|
indicator contains 'W' or 'N', it is blank if all other indicators
|
||
|
|
are blank.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN1<br />
|
||
|
|
sqlwarn[1]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(1) SQLWARN(2:2)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(2) SQLWN1</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if the value of a string
|
||
|
|
column was truncated when assigned to a host variable. Contains 'N' if *NOCNULRQD
|
||
|
|
was specified an the CRTSQLCI or CRTSQLCPPI command (or CNULRQD(*NO) on the
|
||
|
|
SET OPTION statement) and if the value of a string column was assigned to
|
||
|
|
a C NUL-terminated host variable and if the host variable was large enough
|
||
|
|
to contain the result but not large enough to contain the NUL-terminator.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN2<br />
|
||
|
|
sqlwarn[2]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(2) SQLWARN(3:3)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(3) SQLWN2</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if the null values were
|
||
|
|
eliminated from the argument of a function; not necessarily set to 'W'
|
||
|
|
for the MIN function because its results are not dependent on the elimination
|
||
|
|
of null values.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN3<br />
|
||
|
|
sqlwarn[3]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(3) SQLWARN(4:4)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(4) SQLWN3</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if the number of columns
|
||
|
|
is larger than the number of host variables.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN4<br />
|
||
|
|
sqlwarn[4]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(4) SQLWARN(5:5)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(5) SQLWN4</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if a prepared UPDATE
|
||
|
|
or DELETE statement does not include a WHERE clause.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN5<br />
|
||
|
|
sqlwarn[5]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(5) SQLWARN(6:6)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(6) SQLWN5</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Reserved</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN6<br />
|
||
|
|
sqlwarn[6]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(6) SQLWARN(7:7)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(7) SQLWN6</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if date arithmetic results in
|
||
|
|
an end-of-month adjustment.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN7<br />
|
||
|
|
sqlwarn[7]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRN(7) SQLWARN(8:8)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(8) (SQLWN7</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Reserved</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN8<br />
|
||
|
|
sqlwarn[8]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRX(1) SQLWARN(9:9)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(9) SQLWN8</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Contains 'W' if the result of a character
|
||
|
|
conversion contains the substitution character.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARN9<br />
|
||
|
|
sqlwarn[9]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRX(2) SQLWARN(10:10)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(10) SQLWN9</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Reserved</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1959">
|
||
|
|
<div class="lines">SQLWARNA<br />
|
||
|
|
sqlwarn[10]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1960">SQLWRX(3) SQLWARN(11:11)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1961">SQLWARN(11) SQLWNA</td>
|
||
|
|
<td align="left" valign="top" headers="wq1962">Reserved</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
<a name="newxxk"></a>
|
||
|
|
<table id="newxxk" width="100%" summary="" border="1" frame="hsides" rules="rows">
|
||
|
|
<caption>Table 90. SQLERRD Diagnostic Information</caption>
|
||
|
|
<thead valign="bottom">
|
||
|
|
<tr>
|
||
|
|
<th id="wq1963" width="16%" align="left" valign="bottom">
|
||
|
|
<div class="lines">C Name<br />
|
||
|
|
COBOL Name<br />
|
||
|
|
PL/I Name <br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1964" width="16%" align="left" valign="bottom">
|
||
|
|
<div class="lines">FORTRAN<sup>1</sup><br />
|
||
|
|
Name<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1965" width="16%" align="left" valign="bottom">
|
||
|
|
<div class="lines">ILE RPG Name<br />
|
||
|
|
RPG/400 Name<br />
|
||
|
|
</div></th>
|
||
|
|
<th id="wq1966" width="50%" align="left" valign="bottom">Field Value</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody valign="top">
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1963">
|
||
|
|
<div class="lines">SQLERRD(1)<br />
|
||
|
|
sqlerrd[0]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1964">SQLERR(1)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1965">SQLERRD(1) SQLER1</td>
|
||
|
|
<td align="left" valign="top" headers="wq1966">Contains the last four characters of the
|
||
|
|
CPF escape message if SQLCODE is less than 0. For example, if the message
|
||
|
|
is CPF5715, <span class="hex">X'F5F7F1F5'</span> is placed in SQLERRD(1).<sup>1</sup>
|
||
|
|
<p>For a call to a procedure, contains the return status value specified
|
||
|
|
on the RETURN statement. If a return status value is not specified on the
|
||
|
|
RETURN statement, </p>
|
||
|
|
<ul>
|
||
|
|
<li>0 is returned if the CALL statement is successful, or</li>
|
||
|
|
<li>–200 is returned if the CALL statement is not successful.</li></ul></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1963">
|
||
|
|
<div class="lines">SQLERRD(2)<br />
|
||
|
|
sqlerrd[1]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1964">SQLERR(2)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1965">SQLERRD(2) SQLER2</td>
|
||
|
|
<td align="left" valign="top" headers="wq1966">Contains the last four characters of a CPD
|
||
|
|
diagnostic message if the SQL code is less than 0.<sup>1</sup>
|
||
|
|
<p>For a CALL statement, SQLERRD(2) contains the number of result sets.</p>
|
||
|
|
<p>For an OPEN statement, if the cursor is insensitive to changes, SQLERRD(2)
|
||
|
|
contains the actual number of rows in the result set. If the cursor is sensitive
|
||
|
|
to changes, SQLERRD(2) contains an estimated number of rows in the result
|
||
|
|
set.</p></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1963">
|
||
|
|
<div class="lines">SQLERRD(3)<br />
|
||
|
|
sqlerrd[2]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1964">SQLERR(3)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1965">SQLERRD(3) SQLER3</td>
|
||
|
|
<td align="left" valign="top" headers="wq1966">For a CONNECT for status statement, SQLERRD(3)
|
||
|
|
contains information on the connection status. See <a href="rbafzmstcon2t.htm#con2t">CONNECT (Type 2)</a> for
|
||
|
|
more information.
|
||
|
|
<p>For INSERT, UPDATE, REFRESH, and DELETE, shows the number
|
||
|
|
of rows affected.</p>
|
||
|
|
<p>For a FETCH statement, SQLERRD(3) contains the number
|
||
|
|
of rows fetched.</p>
|
||
|
|
<p>For the PREPARE statement, contains the estimated number
|
||
|
|
of rows selected. If the number of rows is greater than 2 147 483 647, then
|
||
|
|
2 147 483 647 is returned.</p></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1963">
|
||
|
|
<div class="lines">SQLERRD(4)<br />
|
||
|
|
sqlerrd[3]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1964">SQLERR(4)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1965">SQLERRD(4) SQLER4</td>
|
||
|
|
<td align="left" valign="top" headers="wq1966">For the PREPARE statement, contains a relative
|
||
|
|
number estimate of the resources required for every execution. This number
|
||
|
|
varies depending on the current availability of indexes, file sizes, CPU model,
|
||
|
|
etc. It is an estimated cost for the access plan chosen by the DB2 UDB for iSeries Query
|
||
|
|
Optimizer.
|
||
|
|
<p>For a CONNECT and SET CONNECTION statement, SQLERRD(4) contains
|
||
|
|
the type of conversation used and whether or not committable updates can be
|
||
|
|
performed. See <a href="rbafzmstcon2t.htm#con2t">CONNECT (Type 2)</a> for more information.</p>
|
||
|
|
<p>For a CALL statement, SQLERRD(4) contains the message key of the error that
|
||
|
|
caused the procedure to fail. The QMHRTVPM API can be used to return the message
|
||
|
|
description for the message key.</p>
|
||
|
|
<p>For a trigger error in a DELETE,
|
||
|
|
INSERT or UPDATE statement, SQLERRD(4) contains the message key of the error
|
||
|
|
that was signaled from the trigger program. The QMHRTVPM API can be used to
|
||
|
|
return the message description for the message key.</p>
|
||
|
|
<p>For a FETCH statement,
|
||
|
|
SQLERRD(4) contains the length of the row retrieved.</p></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1963">
|
||
|
|
<div class="lines">SQLERRD(5)<br />
|
||
|
|
sqlerrd[4]<br />
|
||
|
|
</div>
|
||
|
|
<div class="lines"><br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1964">SQLERR(5)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1965">SQLERRD(5) SQLER5</td>
|
||
|
|
<td align="left" valign="top" headers="wq1966"><span>For a CALL statement, SQLERRD(5) contains
|
||
|
|
the number of result sets returned from the procedure.</span>
|
||
|
|
<p>For a CONNECT
|
||
|
|
or SET CONNECTION statement, SQLERRD(5) contains: </p>
|
||
|
|
<ul>
|
||
|
|
<li>-1 if the connection is unconnected</li>
|
||
|
|
<li> 0 if the connection is local</li>
|
||
|
|
<li> 1 if the connection is remote</li></ul>
|
||
|
|
<p>For a DELETE statement, shows the number of rows affected by referential
|
||
|
|
constraints.</p>
|
||
|
|
<p>For an EXECUTE IMMEDIATE or PREPARE statement, may contain
|
||
|
|
the position of a syntax error.</p>
|
||
|
|
<p>For a multiple-row FETCH statement,
|
||
|
|
SQLERRD(5) contains +100 if the last row currently in the table has been fetched.</p>
|
||
|
|
<p>For a PREPARE statement, SQLERRD(5) contains the number of parameter
|
||
|
|
markers in the prepared statement.</p></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1963">
|
||
|
|
<div class="lines">SQLERRD(6)<br />
|
||
|
|
sqlerrd[5]<br />
|
||
|
|
</div></td>
|
||
|
|
<td align="left" valign="top" headers="wq1964">SQLERR(6)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1965">SQLERRD(6) SQLER6</td>
|
||
|
|
<td align="left" valign="top" headers="wq1966">Contains the SQL completion message identifier
|
||
|
|
when the SQLCODE is 0.
|
||
|
|
<p>In all other cases, it is undefined.</p></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td colspan="4" align="left" valign="top" headers="wq1963 wq1964 wq1965 wq1966">
|
||
|
|
<a name="wq1967"></a>
|
||
|
|
<div class="notetitle" id="wq1967">Note:</div>
|
||
|
|
<div class="notebody">
|
||
|
|
<dl>
|
||
|
|
<dt class="bold"><sup>1</sup></dt>
|
||
|
|
<dd>SQLERRD(1) and SQLERRD(2) are set only if appropriate and only if the
|
||
|
|
current server is DB2 UDB for iSeries.
|
||
|
|
</dd>
|
||
|
|
</dl></div></td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table><a id="idx3414" name="idx3414"></a><a id="idx3415" name="idx3415"></a>
|
||
|
|
<a name="newxxj"></a>
|
||
|
|
<table id="newxxj" width="100%" summary="" border="1" frame="hsides" rules="rows">
|
||
|
|
<caption>Table 91. SQLERRMC Replacement Text for CONNECT and SET CONNECTION</caption>
|
||
|
|
<thead valign="bottom">
|
||
|
|
<tr>
|
||
|
|
<th id="wq1968" width="59%" align="left" valign="bottom">Description</th>
|
||
|
|
<th id="wq1969" width="40%" align="left" valign="bottom">Data type</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody valign="top">
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1968">Relational Database Name</td>
|
||
|
|
<td align="left" valign="top" headers="wq1969">CHAR(18)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1968">Product Identification (same as SQLERRP)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1969">CHAR(8)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1968">User ID of the server job</td>
|
||
|
|
<td align="left" valign="top" headers="wq1969">CHAR(10)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1968">Connection method (*DUW or *RUW)</td>
|
||
|
|
<td align="left" valign="top" headers="wq1969">CHAR(10)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1968">DDM server class name
|
||
|
|
<dl>
|
||
|
|
<dt class="bold">QAS</dt>
|
||
|
|
<dd>DB2 UDB for iSeries
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QDB2</dt>
|
||
|
|
<dd>DB2 UDB for z/OS
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QDB2/6000</dt>
|
||
|
|
<dd>DB2 UDB for AIX®
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QDB2/HPUX</dt>
|
||
|
|
<dd>DB2 UDB for HP-UX**
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QDB2/LINUX</dt>
|
||
|
|
<dd>DB2 UDB for Linux®
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QDB2/NT</dt>
|
||
|
|
<dd>DB2 UDB for Windows** NT, 2000, and XP
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QDB2/SUN</dt>
|
||
|
|
<dd>DB2 UDB for SUN** Solaris**
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QSQLDS/VM</dt>
|
||
|
|
<dd>DB2 Server for VM
|
||
|
|
</dd>
|
||
|
|
<dt class="bold">QSQLDS/VSE</dt>
|
||
|
|
<dd>DB2 Server for VSE
|
||
|
|
</dd>
|
||
|
|
</dl></td>
|
||
|
|
<td align="left" valign="top" headers="wq1969">CHAR(10)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq1968">Connection type (same as SQLERRD(4))</td>
|
||
|
|
<td align="left" valign="top" headers="wq1969">SMALLINT</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
<hr /><br />
|
||
|
|
[ <a href="#Top_Of_Page">Top of Page</a> | <a href="rbafzmstsqlcca.htm">Previous Page</a> | <a href="rbafzmstincludesqlca.htm">Next Page</a> | <a href="rbafzmst02.htm#wq1">Contents</a> |
|
||
|
|
<a href="rbafzmstindex.htm#index">Index</a> ]
|
||
|
|
|
||
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
||
|
|
</body>
|
||
|
|
</html>
|