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

79 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="Use host variables in C and C++ applications that use SQL" />
<meta name="abstract" content="All host variables used in SQL statements must be explicitly declared prior to their first use." />
<meta name="description" content="All host variables used in SQL statements must be explicitly declared prior to their first use." />
<meta name="DC.subject" content="host variable, C, C++, C program, C++ program, coding requirement, C program, C++ program, host variable, BEGIN DECLARE SECTION statement, END DECLARE SECTION statement, BEGIN/END DECLARE SECTION, : (colon), C host variable, colon, in C host variable, C++ host variable, in C++ host variable, union elements, union" />
<meta name="keywords" content="host variable, C, C++, C program, C++ program, coding requirement, C program, C++ program, host variable, BEGIN DECLARE SECTION statement, END DECLARE SECTION statement, BEGIN/END DECLARE SECTION, : (colon), C host variable, colon, in C host variable, C++ host variable, in C++ host variable, union elements, union" />
<meta name="DC.Relation" scheme="URI" content="rzajpc.htm" />
<meta name="DC.Relation" scheme="URI" content="rzajpdeclaringhostc.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="rzajphostsqlc" />
<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>Use host variables in C and C++ applications that use
SQL</title>
</head>
<body id="rzajphostsqlc"><a name="rzajphostsqlc"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Use host variables in C and C++ applications that use
SQL</h1>
<div><p>All host variables used in SQL statements must be explicitly declared
prior to their first use.</p>
<div class="section"><p>In C, the C statements that are used to define the host variables
should be preceded by a BEGIN DECLARE SECTION statement and followed by an
END DECLARE SECTION statement. If a BEGIN DECLARE SECTION and END DECLARE
SECTION are specified, all host variable declarations used in SQL statements
must be between the BEGIN DECLARE SECTION and the END DECLARE SECTION statements.
Host variables declared using a typedef identifier also require a BEGIN DECLARE
SECTION and END DECLARE SECTION; however, the typedef declarations do not
need to be between these two sections.</p>
</div>
<div class="section"><p>In C++, the C++ statements that are used to define the host variables
must be preceded by a BEGIN DECLARE SECTION statement and followed by an END
DECLARE SECTION statement. You cannot use any variable that is not between
the BEGIN DECLARE SECTION statement and the END DECLARE SECTION statement
as a host variable.</p>
</div>
<div class="section"><p>All host variables within an SQL statement must be preceded by
a colon (:).</p>
</div>
<div class="section"><p>The names of host variables must be unique within the program,
even if the host variables are in different blocks or procedures.</p>
</div>
<div class="section"><p>An SQL statement that uses a host variable must be within the
scope of the statement in which the variable was declared.</p>
</div>
<div class="section"><p>Host variables cannot be union elements.</p>
</div>
<div class="section"><p>Host variables cannot contain continuation characters within the
name.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rzajpdeclaringhostc.htm">Declare host variables in C and C++ applications that use SQL</a></strong><br />
The C and C++ precompilers recognize only a subset of valid C and C++ declarations as valid host variable declarations.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajpc.htm" title="This topic describes the unique application and coding requirements for embedding SQL statements in a C or C++ program.">Code SQL statements in C and C++ applications</a></div>
</div>
</div>
</body>
</html>