friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0332907f0f
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajp_5.4.0.1/rzajpsqldairpg.htm

120 lines
7.7 KiB
HTML
Raw Normal View History

Add readme and dist folders
2024-04-02 14:02:31 +00:00
<?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="Define SQL descriptor areas in ILE RPG applications that use SQL" />
<meta name="abstract" content="There are two types of SQL descriptor areas. One is defined with the ALLOCATE DESCRIPTOR statement. The other is defined using the SQLDA structure. In this section, only the SQLDA form is discussed." />
<meta name="description" content="There are two types of SQL descriptor areas. One is defined with the ALLOCATE DESCRIPTOR statement. The other is defined using the SQLDA structure. In this section, only the SQLDA form is discussed." />
<meta name="DC.subject" content="SQLDA (SQL descriptor area), ILE RPG, application program, SQLDA, ILE RPG program, SQLDA, declaring, dynamic SQL coding, dynamic SQL, coding in ILE RPG" />
<meta name="keywords" content="SQLDA (SQL descriptor area), ILE RPG, application program, SQLDA, ILE RPG program, SQLDA, declaring, dynamic SQL coding, dynamic SQL, coding in ILE RPG" />
<meta name="DC.Relation" scheme="URI" content="rzajprpgi.htm" />
<meta name="DC.Relation" scheme="URI" content="../sqlp/rbafydynmic.htm" />
<meta name="DC.Relation" scheme="URI" content="../db2/rbafzmstsqldda.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="rzajpsqldairpg" />
<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>Define SQL descriptor areas in ILE RPG applications that use SQL</title>
</head>
<body id="rzajpsqldairpg"><a name="rzajpsqldairpg"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Define SQL descriptor areas in ILE RPG applications that use SQL</h1>
<div><p><span><img src="./delta.gif" alt="Start of change" />There are two types of SQL descriptor areas.
One is defined with the ALLOCATE DESCRIPTOR statement. The other is defined
using the SQLDA structure. In this section, only the SQLDA form is discussed.<img src="./deltaend.gif" alt="End of change" /></span></p>
<div class="section"> <p><img src="./delta.gif" alt="Start of change" />The following statements can use an SQLDA:<img src="./deltaend.gif" alt="End of change" /></p>
<ul><li>EXECUTE…USING DESCRIPTOR <span class="synph"><span class="var">descriptor-name</span></span></li>
<li>FETCH…USING DESCRIPTOR <span class="synph"><span class="var">descriptor-name</span></span></li>
<li>OPEN…USING DESCRIPTOR <span class="synph"><span class="var">descriptor-name</span></span></li>
<li>CALL…USING DESCRIPTOR <span class="synph"><span class="var">descriptor-name</span></span></li>
<li>DESCRIBE <span class="synph"><span class="var">statement-name</span></span> INTO <span class="synph"><span class="var">descriptor-name</span></span></li>
<li><img src="./delta.gif" alt="Start of change" />DESCRIBE INPUT <span class="synph"><span class="var">statement-name</span></span> INTO <span class="synph"><span class="var">descriptor-name</span></span><img src="./deltaend.gif" alt="End of change" /></li>
<li>DESCRIBE TABLE <span class="synph"><span class="var">host-variable</span></span> INTO <span class="synph"><span class="var">descriptor-name</span></span></li>
<li>PREPARE <span class="synph"><span class="var">statement-name</span></span> INTO <span class="synph"><span class="var">descriptor-name</span></span></li>
</ul>
</div>
<div class="section"><p><img src="./delta.gif" alt="Start of change" />Unlike the SQLCA, there can be more than one
SQLDA in a program and an SQLDA can have any valid name.<img src="./deltaend.gif" alt="End of change" /></p>
<p>Dynamic SQL
is a programming technique.With
dynamic SQL, your program can develop and then run SQL statements while the
program is running. A SELECT statement with a variable SELECT list (that is,
a list of columns to be returned as part of the query) that runs dynamically
requires an SQL descriptor area (SQLDA). This is because you cannot know in
advance how many or what type of variables to allocate in order to receive
the results of the SELECT.</p>
</div>
<div class="section"><p><img src="./delta.gif" alt="Start of change" />You can specify an INCLUDE SQLDA statement in
an ILE RPG program; however, it is not allowed in free format. The format
of the statement is:<img src="./deltaend.gif" alt="End of change" /></p>
<pre>C/EXEC SQL <strong>INCLUDE SQLDA</strong>
C/END-EXEC</pre>
</div>
<div class="section"><p>The INCLUDE SQLDA generates the following data structure.</p>
<pre>D* SQL Descriptor area
D SQLDA DS
D SQLDAID 1 8A
D SQLDABC 9 12B 0
D SQLN 13 14B 0
D SQLD 15 16B 0
D SQL_VAR 80A DIM(SQL_NUM)
D 17 18B 0
D 19 20B 0
D 21 32A
D 33 48*
D 49 64*
D 65 66B 0
D 67 96A
D*
D SQLVAR DS
D SQLTYPE 1 2B 0
D SQLLEN 3 4B 0
D SQLRES 5 16A
D SQLDATA 17 32*
D SQLIND 33 48*
D SQLNAMELEN 49 50B 0
D SQLNAME 51 80A
D* End of SQLDA
</pre>
</div>
<div class="section"><p>The user is responsible for the definition of SQL_NUM. SQL_NUM
must be defined as a numeric constant with the dimension required for SQL_VAR.</p>
</div>
<div class="section"><p>The INCLUDE SQLDA generates two data structures. The second data
structure is used to setup and reference the part of the SQLDA that contains
the field descriptions.</p>
</div>
<div class="section"><p>To set the field descriptions of the SQLDA the program sets up
the field description in the subfields of SQLVAR and then assigns SQLVAR to
SQL_VAR(n), where n is the number of the field in the SQLDA. This is repeated
until all the field descriptions are set.</p>
</div>
<div class="section"><p>When the SQLDA field descriptions are to be referenced the user
assigns SQLVAR(n) to SQL_VAR where n is the number of the field description
to be processed.</p>
</div>
</div>
<div>
<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 class="relinfo"><strong>Related information</strong><br />
<div><a href="../sqlp/rbafydynmic.htm">Dynamic SQL applications</a></div>
<div><a href="../db2/rbafzmstsqldda.htm">SQL descriptor area</a></div>
</div>
</div>
</body>
</html>
Reference in New Issue Copy Permalink