258 lines
7.0 KiB
HTML
258 lines
7.0 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<title>Using Application Development Manager/400 APIs</title>
|
||
|
|
<!-- Begin Header Records ========================================= -->
|
||
|
|
<!-- 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. -->
|
||
|
|
<!-- Change History: -->
|
||
|
|
<!-- YYMMDD USERID Change description -->
|
||
|
|
<!-- HLL1A SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
|
||
|
|
<!-- RCHVMW2 on 1 Feb 1999 at 15:12:42 -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<h2>Using Application Development Manager/400 APIs</h2>
|
||
|
|
|
||
|
|
<p>The following compilers and preprocessors use the the Application
|
||
|
|
Development Manager/400 APIs.<br>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p><strong><a name="TBLPREPROC">Table 1. Compilers and preprocessors that can
|
||
|
|
be used with the Application Development Manager/400 feature</a></strong><br>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<table border>
|
||
|
|
<tr>
|
||
|
|
<th align="left" valign="top" width="35%">
|
||
|
|
<pre>
|
||
|
|
Compiler/
|
||
|
|
Preprocessor
|
||
|
|
Language
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
</th>
|
||
|
|
<th align="left" valign="top" width="35%">Compiler/Preprocessor i5/OS<SUP>(TM)</SUP>
|
||
|
|
Command</th>
|
||
|
|
<th align="left" valign="top" width="30%">Supported if *PRV is Specified for
|
||
|
|
Target Release</th>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">RPG/400<SUP>(R)</SUP></td>
|
||
|
|
<td align="left" valign="top">CRTRPGPGM</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">ILE RPG/400</td>
|
||
|
|
<td align="left" valign="top">No</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">COBOL/400<SUP>(R)</SUP></td>
|
||
|
|
<td align="left" valign="top">CRTCBLPGM</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">ILE COBOL/400</td>
|
||
|
|
<td align="left" valign="top">No</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">ILE CL</td>
|
||
|
|
<td align="left" valign="top">No</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">ILE C</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CRTPF, CRTLF, CRTDSPF, CRTPRTF,
|
||
|
|
CRTICFF</td>
|
||
|
|
<td align="left" valign="top">Not applicable</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CL</td>
|
||
|
|
<td align="left" valign="top">CRTCLPGM</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CLD</td>
|
||
|
|
<td align="left" valign="top">CRTCLD</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CMD</td>
|
||
|
|
<td align="left" valign="top">CRTCMD</td>
|
||
|
|
<td align="left" valign="top">Not applicable</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CRTSQLRPG, CRTSQLCBL, CRTSQLCI</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CRTSQLRPGI, CRTSQLCBLI</td>
|
||
|
|
<td align="left" valign="top">No</td>
|
||
|
|
<td align="left" valign="top"><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CRTSRVPGM</td>
|
||
|
|
<td align="left" valign="top">CRTSRVPGM</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CRTPGM</td>
|
||
|
|
<td align="left" valign="top">CRTPGM</td>
|
||
|
|
<td align="left" valign="top">Yes</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">MENU</td>
|
||
|
|
<td align="left" valign="top">CRTMNU TYPE(*UIM)</td>
|
||
|
|
<td align="left" valign="top">Not applicable</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">PNLGRP</td>
|
||
|
|
<td align="left" valign="top">CRTPNLGRP</td>
|
||
|
|
<td align="left" valign="top">Not applicable</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" colspan="3"><strong>Notes:</strong>
|
||
|
|
|
||
|
|
<ol type="1">
|
||
|
|
<li>Default command is used by the <samp>BLDPART</samp> command.</li>
|
||
|
|
|
||
|
|
<li>Appropriate default compiler command is used based on the part type and the
|
||
|
|
language.</li>
|
||
|
|
</ol>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>The following diagram shows the proper usage and order in which the APIs
|
||
|
|
should be called.</p>
|
||
|
|
|
||
|
|
<p><strong><a name="FIGAPIDIAG">Overall Application Development
|
||
|
|
Manager/400 API Usage</a></strong><br>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<table border>
|
||
|
|
<tr>
|
||
|
|
<td><br>
|
||
|
|
<strong><br>
|
||
|
|
</strong>
|
||
|
|
|
||
|
|
<center><strong><img src="Rv3f090.gif" alt=
|
||
|
|
"Overall Application Development Manager/400 API Usage."></strong></center>
|
||
|
|
|
||
|
|
<strong><br>
|
||
|
|
</strong><br>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>QLYGETS should be called by the application or compiler before calling the
|
||
|
|
other three APIs: QLYSETS, QLYWRTBI, and QLYRDBI to verify that the space is
|
||
|
|
available for use.</p>
|
||
|
|
|
||
|
|
<p>The following table describes the API space status values that can be
|
||
|
|
received by calling the QLYGETS API, and the action that should be taken by the
|
||
|
|
application or compiler that is calling the API.<br>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p><strong><a name="TBLAPIGEN">Table 2. API Space Status</a></strong><br>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<table border>
|
||
|
|
<tr>
|
||
|
|
<th align="left" valign="top" width="20%">Status</th>
|
||
|
|
<th align="left" valign="top" width="50%">Application</th>
|
||
|
|
<th align="left" valign="top" width="30%">Compiler</th>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">*COMPLETE</td>
|
||
|
|
<td align="left" valign="top">The space is available for use. Call
|
||
|
|
QLYSETS to set to *READY.</td>
|
||
|
|
<td align="left" valign="top">Do not write API records.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">*NONE</td>
|
||
|
|
<td align="left" valign="top">The space does not exist. The
|
||
|
|
application calls QLYSETS to create and set the space to *READY.</td>
|
||
|
|
<td align="left" valign="top">Do not write API records.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">*READY</td>
|
||
|
|
<td align="left" valign="top">The space is in use by a compiler.
|
||
|
|
The other APIs should not be called.</td>
|
||
|
|
<td align="left" valign="top">The space is available for
|
||
|
|
writing.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<p>Compilers use the APIs to write to the space. Applications use the APIs to
|
||
|
|
read from the space.</p>
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> Unpredictable results can occur when the APIs are not
|
||
|
|
properly used or are used in the incorrect order.</p>
|
||
|
|
|
||
|
|
<p>Calling multiple API-supporting compilers simultaneously in a single
|
||
|
|
interactive session (one possible way of doing this is by pressing the
|
||
|
|
Attention key and then command key F9 to get to the command line) may cause
|
||
|
|
unpredictable results. The compiler can fail, for example, or incorrect or
|
||
|
|
incomplete information can be put in the work space.</p>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="hll.htm">High-level Language APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|