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

71 lines
4.5 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 ILE RPG applications that use SQL" />
<meta name="abstract" content="All host variables used in SQL statements must be explicitly declared." />
<meta name="description" content="All host variables used in SQL statements must be explicitly declared." />
<meta name="DC.subject" content="host variable, ILE RPG, ILE RPG program, coding requirement, requirement for ILE RPG, BEGIN DECLARE SECTION statement, END DECLARE SECTION statement, : (colon), colon, in ILE RPG host variable" />
<meta name="keywords" content="host variable, ILE RPG, ILE RPG program, coding requirement, requirement for ILE RPG, BEGIN DECLARE SECTION statement, END DECLARE SECTION statement, : (colon), colon, in ILE RPG host variable" />
<meta name="DC.Relation" scheme="URI" content="rzajprpgi.htm" />
<meta name="DC.Relation" scheme="URI" content="rzajpdeclaringirpg.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="rzajphostvariablesirpg" />
<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 ILE RPG applications that use SQL</title>
</head>
<body id="rzajphostvariablesirpg"><a name="rzajphostvariablesirpg"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Use host variables in ILE RPG applications that use SQL</h1>
<div><p>All host variables used in SQL statements must be explicitly declared.</p>
<div class="section"><p>SQL embedded in ILE RPG does not use the SQL BEGIN DECLARE SECTION
and END DECLARE SECTION statements to identify host variables. Do not put
these statements in the source program.</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 procedures. However, if a data
structure has the QUALIFIED keyword, then the subfields of that data structure
can have the same name as a subfield in a different data structure or as a
stand-alone variable. The subfield of a data structure with the QUALIFIED
keyword must be referenced using the data structure name to qualify the subfield
name. </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>If an error stating that a host variable is not defined or not
usable is issued, look at the cross-reference in the precompiler listing to
see how the precompiler defined the variable. To generate a cross-reference
in the listing, run the precompile command with *XREF specified on the OPTIONS
parameter. </p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rzajpdeclaringirpg.htm">Declare host variables in ILE RPG applications that use SQL</a></strong><br />
The SQL ILE RPG precompiler only recognizes a subset of valid ILE RPG declarations as valid host variable declarations.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajprpgi.htm" title="This topic describes the unique application and coding requirements for embedding SQL statements in an ILE RPG program. The coding requirements for host variables are defined.">Code SQL statements in ILE RPG applications</a></div>
</div>
</div>
</body>
</html>