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

79 lines
4.7 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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="LOB host variables in ILE RPG applications that use SQL" />
<meta name="abstract" content="The following are examples of LOB host variables in ILE RPG." />
<meta name="description" content="The following are examples of LOB host variables in ILE RPG." />
<meta name="DC.subject" content="CLOB host variable, ILE RPG, host variable, CLOB, ILE RPG program, DBCLOB host variable, DBCLOB, BLOB host variable, host variable, BLOB" />
<meta name="keywords" content="CLOB host variable, ILE RPG, host variable, CLOB, ILE RPG program, DBCLOB host variable, DBCLOB, BLOB host variable, host variable, BLOB" />
<meta name="DC.Relation" scheme="URI" content="rzajplobvar.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="rzajpirpglobhost" />
<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>LOB host variables in ILE RPG applications that use SQL</title>
</head>
<body id="rzajpirpglobhost"><a name="rzajpirpglobhost"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">LOB host variables in ILE RPG applications that use SQL</h1>
<div><p>The following are examples of LOB host variables in ILE RPG.</p>
<div class="section"><h4 class="sectiontitle"><em>CLOB example</em></h4><p>The following declaration:</p>
<pre>D MYCLOB S SQLTYPE(CLOB:1000)</pre>
<p>results in the generation of the following structure:</p>
<pre>D MYCLOB DS
D MYCLOB_LEN 10U
D MYCLOB_DATA 1000A </pre>
</div>
<div class="section"><h4 class="sectiontitle"><em>DBCLOB example</em></h4><p>The following declaration: </p>
<pre>D MYDBCLOB S SQLTYPE(DBCLOB:400)</pre>
<p>results in the generation of the following structure:</p>
<pre>D MYDBCLOB DS
D MYDBCLOB_LEN 10U
D MYDBCLOB_DATA 400G </pre>
</div>
<div class="section"><h4 class="sectiontitle"><em>BLOB example</em></h4><p>The following declaration:</p>
<pre>D MYBLOB S SQLTYPE(BLOB:500)</pre>
<p>results in the generation of the following structure:</p>
<pre>D MYBLOB DS
D MYBLOB_LEN 10U
D MYBLOB_DATA 500A </pre>
</div>
<div class="section"> <div class="note"><span class="notetitle">Notes:</span> <ol><li><img src="./delta.gif" alt="Start of change" />For BLOB and CLOB, 1 ≤ lob-length ≤ 65 531<img src="./deltaend.gif" alt="End of change" /></li>
<li>For DBCLOB, 1≤ lob-length ≤ 16 383</li>
<li>LOB host variables are allowed to be declared in host structures.</li>
<li>LOB host variables are not allowed in host structure arrays. LOB locators
should be used instead.</li>
<li>LOB host variables declared in structure arrays cannot be used as standalone
host variables.</li>
<li>SQLTYPE, BLOB, CLOB, DBCLOB can be in mixed case.</li>
<li>SQLTYPE must be between positions 44 to 80.</li>
<li>When a LOB is declared as a stand-alone host variable, position 24 must
contain the character 'S' and position 25 must be blank.</li>
<li>The stand-alone field indicator S in position 24 should be omitted when
a LOB is declared in a host structure.</li>
<li>LOB host variables cannot be initialized.</li>
</ol>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajplobvar.htm" title="ILE RPG does not have variables that correspond to the SQL data types for LOBs (large objects).">Declare LOB host variables in ILE RPG applications that use SQL</a></div>
</div>
</div>
</body>
</html>