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

70 lines
4.1 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="Declare binary host variables in ILE RPG applications that use SQL" />
<meta name="abstract" content="ILE RPG does not have variables that correspond to the SQL binary data types." />
<meta name="description" content="ILE RPG does not have variables that correspond to the SQL binary data types." />
<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="rzajpirpgbin" />
<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>Declare binary host variables in ILE RPG applications that use SQL</title>
</head>
<body id="rzajpirpgbin"><a name="rzajpirpgbin"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Declare binary host variables in ILE RPG applications that use SQL</h1>
<div><p>ILE RPG does not have variables that correspond to the SQL binary
data types.</p>
<div class="section"><p>To create host variables that can be used with these data types,
use the SQLTYPE keyword. The SQL precompiler replaces this declaration with
an ILE RPG language declaration in the output source member. Binary declarations
can be either standalone or within a data structure.</p>
</div>
<div class="section"><h4 class="sectiontitle"><em>BINARY example</em></h4><p>The following declaration: </p>
<pre>D MYBINARY S SQLTYPE(BINARY:50)</pre>
</div>
<div class="section"><p>results in the generation of the following code: </p>
<pre>D MYBINARY S 50A</pre>
</div>
<div class="section"><h4 class="sectiontitle"><em>VARBINARY example</em></h4><p>The following declaration:</p>
<pre>D MYVARBINARY S SQLTYPE(VARBINARY:100)</pre>
</div>
<div class="section"><p>results in the generation of the following code:</p>
<pre>D MYVARBINARY S 100A VARYING</pre>
</div>
<div class="section"> <div class="note"><span class="notetitle">Notes:</span> <ol><li>For BINARY host variables, the length must be in the range 1 to 32766.</li>
<li>For VARBINARY host variables, the length must be in the range 1 to 32740.</li>
<li>BINARY and VARBINARY host variables are allowed to be declared in host
structures.</li>
<li>SQLTYPE, BINARY, and VARBINARY can be in mixed case.</li>
<li>SQLTYPE must be between positions 44 to 80.</li>
<li>When a BINARY or VARBINARY is declared as a standalone host variable,
position 24 must contain the character <strong>S</strong> and position 25 must be blank.</li>
<li>The standalone field indicator <strong>S</strong> in position 24 should be omitted
when a BINARY or VARBINARY host variable is declared in a host structure.</li>
</ol>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajpdeclaringirpg.htm" title="The SQL ILE RPG precompiler only recognizes a subset of valid ILE RPG declarations as valid host variable declarations.">Declare host variables in ILE RPG applications that use SQL</a></div>
</div>
</div>
</body>
</html>