1505 lines
60 KiB
HTML
1505 lines
60 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">
|
||
|
|
<title>Create Bound C++ Program (CRTBNDCPP)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="CRTBNDCPP.Top_Of_Page"></a>
|
||
|
|
<h2>Create Bound C++ Program (CRTBNDCPP)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CRTBNDCPP.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTBNDCPP.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTBNDCPP.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTBNDCPP"></a>
|
||
|
|
<p>The Create Bound C++ Program (CRTBNDCPP) command starts the ILE C++ compiler. You can use this command in either batch or interactive mode, or from a CL program. The compiler attempts to create a program object based on the ILE C++ statements in the source code.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When the CRTBNDCPP command is invoked, a temporary module object is created in the QTEMP library. The name of the temporary module object is the same as the name you specified on the PGM parameter of the CRTBNDCPP command. If a module object with that name already exists in QTEMP, an error message is generated and compilation stops. The temporary module object, which is used with the CRTBNDCPP command, is deleted after compilation stops whether or not compilation is successful.
|
||
|
|
</p>
|
||
|
|
<h3>Error messages for CRTBNDCPP</h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CZS1613</b></dt>
|
||
|
|
<dd>The compilation failed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTBNDCPP.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTBNDCPP.PGM"><b>PGM</b></a></td>
|
||
|
|
<td valign="top">Program</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Program</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTBNDCPP.SRCFILE"><b>SRCFILE</b></a></td>
|
||
|
|
<td valign="top">Source file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Source file</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QCPPSRC</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.SRCMBR"><b>SRCMBR</b></a></td>
|
||
|
|
<td valign="top">Source member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PGM</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.SRCSTMF"><b>SRCSTMF</b></a></td>
|
||
|
|
<td valign="top">Source stream file</td>
|
||
|
|
<td valign="top"><i>Path name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SRCMBRTXT</u></b>, *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTBNDCPP.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output options</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, '*none'<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Output file name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i>, *PRINT, '*print'</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Title</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Subtitle</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Compiler options</td>
|
||
|
|
<td valign="top">Values (up to 35 repetitions): *NOBITSIGN, *BITSIGN, *NOEVENTF, *EVENTF, *NOEXPMAC, *EXPMAC, *NOLOGMSG, *LOGMSG, *NOLONGLONG, *LONGLONG, *NORTTI, *RTTIALL, *RTTITYPE, *RTTICAST, *NOSHOWINC, *SHOWINC, *NOSHOWSRC, *SHOWSRC, *NOSHOWSYS, *SHOWSYS, *NOSHOWUSR, *SHOWUSR, *NOSYSINCPATH, *SYSINCPATH, *NOSTDINC, *STDINC, *NOINCDIRFIRST, *INCDIRFIRST, *NOXREF, *XREF, *NOXREFREF, *XREFREF, *NOFULL, *FULL, *NOSTDLOGMSG, *STDLOGMSG</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.CHECKOUT"><b>CHECKOUT</b></a></td>
|
||
|
|
<td valign="top">Checkout options</td>
|
||
|
|
<td valign="top">Values (up to 45 repetitions): <b><u>*NONE</u></b>, *USAGE, *ALL, *NOCLASS, *CLASS, *NOCOND, *COND, *NOEFFECT, *EFFECT, *NOGENERAL, *GENERAL, *NOLANG, *LANG, *NOPARM, *PARM, *NOPORT, *PORT, *NOREACH, *REACH, *NOTEMP, *TEMP, *NOTRUNC, *TRUNC, *NOUNUSED, *UNUSED</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.OPTIMIZE"><b>OPTIMIZE</b></a></td>
|
||
|
|
<td valign="top">Optimization</td>
|
||
|
|
<td valign="top"><b><u>10</u></b>, 20, 30, 40</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="6"><a href="#CRTBNDCPP.INLINE"><b>INLINE</b></a></td>
|
||
|
|
<td valign="top">Inline options</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="6">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Inliner</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*OFF</u></b>, *ON</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Mode</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NOAUTO</u></b>, *AUTO</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Threshold</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-65535, <b><u>250</u></b>, *NOLIMIT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Limit</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-65535, <b><u>2000</u></b>, *NOLIMIT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 5: Report</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NO</u></b>, *YES</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.DBGVIEW"><b>DBGVIEW</b></a></td>
|
||
|
|
<td valign="top">Debugging view</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL, *STMT, *SOURCE, *LIST</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.DEFINE"><b>DEFINE</b></a></td>
|
||
|
|
<td valign="top">Define names</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 32 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.LANGLVL"><b>LANGLVL</b></a></td>
|
||
|
|
<td valign="top">Language level</td>
|
||
|
|
<td valign="top"><b><u>*EXTENDED</u></b>, *ANSI, *LEGACY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.ALIAS"><b>ALIAS</b></a></td>
|
||
|
|
<td valign="top">Alias</td>
|
||
|
|
<td valign="top">Values (up to 3 repetitions): <b><u>*ANSI</u></b>, *NOANSI, *ADDRTAKEN, *NOADDRTAKEN, *ALLPTRS, *NOALLPTRS, *TYPEPTR, *NOTYPEPTR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.SYSIFCOPT"><b>SYSIFCOPT</b></a></td>
|
||
|
|
<td valign="top">System interface options</td>
|
||
|
|
<td valign="top"><b><u>*IFS64IO</u></b>, *IFSIO, *NOIFSIO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.LOCALETYPE"><b>LOCALETYPE</b></a></td>
|
||
|
|
<td valign="top">Locale object type</td>
|
||
|
|
<td valign="top"><b><u>*LOCALE</u></b>, *LOCALEUCS2, *LOCALEUTF</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.FLAG"><b>FLAG</b></a></td>
|
||
|
|
<td valign="top">Message flagging level</td>
|
||
|
|
<td valign="top"><b><u>0</u></b>, 10, 20, 30</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTBNDCPP.MSGLMT"><b>MSGLMT</b></a></td>
|
||
|
|
<td valign="top">Compiler messages</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Message limit</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-32767, <b><u>*NOMAX</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Message limit severity</td>
|
||
|
|
<td valign="top">
|
||
|
|
0, 10, 20, <b><u>30</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.REPLACE"><b>REPLACE</b></a></td>
|
||
|
|
<td valign="top">Replace program object</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.USRPRF"><b>USRPRF</b></a></td>
|
||
|
|
<td valign="top">User profile</td>
|
||
|
|
<td valign="top"><b><u>*USER</u></b>, *OWNER</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *ALL, *CHANGE, *USE, *EXCLUDE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top"><i>Simple name</i>, <b><u>*CURRENT</u></b>, *PRV</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTBNDCPP.ENBPFRCOL"><b>ENBPFRCOL</b></a></td>
|
||
|
|
<td valign="top">Enable performance collection</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Collection level</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*PEP</u></b>, *ENTRYEXIT, *FULL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Procedures</td>
|
||
|
|
<td valign="top">
|
||
|
|
*NONLEAF, *ALLPRC</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.PFROPT"><b>PFROPT</b></a></td>
|
||
|
|
<td valign="top">Performance options</td>
|
||
|
|
<td valign="top">Values (up to 2 repetitions): *SETFPCA, *NOSETFPCA, *NOSTRDONLY, *STRDONLY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.PRFDTA"><b>PRFDTA</b></a></td>
|
||
|
|
<td valign="top">Profiling data</td>
|
||
|
|
<td valign="top"><b><u>*NOCOL</u></b>, *COL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTBNDCPP.TERASPACE"><b>TERASPACE</b></a></td>
|
||
|
|
<td valign="top">Teraspace options</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NO</u></b><br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Teraspace enabled</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*YES</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Use teraspace interfaces</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NOTSIFC</u></b>, *TSIFC</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.STGMDL"><b>STGMDL</b></a></td>
|
||
|
|
<td valign="top">Storage model</td>
|
||
|
|
<td valign="top"><b><u>*SNGLVL</u></b>, *TERASPACE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.DTAMDL"><b>DTAMDL</b></a></td>
|
||
|
|
<td valign="top">Data model</td>
|
||
|
|
<td valign="top"><b><u>*P128</u></b>, *LLP64</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.RTBND"><b>RTBND</b></a></td>
|
||
|
|
<td valign="top">Run time Binding</td>
|
||
|
|
<td valign="top"><b><u>*DEFAULT</u></b>, *LLP64</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.PACKSTRUCT"><b>PACKSTRUCT</b></a></td>
|
||
|
|
<td valign="top">Pack structure</td>
|
||
|
|
<td valign="top"><b><u>*NATURAL</u></b>, 1, 2, 4, 8, 16</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.ENUM"><b>ENUM</b></a></td>
|
||
|
|
<td valign="top">Enum size</td>
|
||
|
|
<td valign="top"><b><u>*SMALL</u></b>, 1, 2, 4, *INT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.MAKEDEP"><b>MAKEDEP</b></a></td>
|
||
|
|
<td valign="top">Dependency information</td>
|
||
|
|
<td valign="top"><i>Path name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.INCDIR"><b>INCDIR</b></a></td>
|
||
|
|
<td valign="top">Include directory</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 32 repetitions): <i>Path name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.CSOPT"><b>CSOPT</b></a></td>
|
||
|
|
<td valign="top">Compiler services option</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.LICOPT"><b>LICOPT</b></a></td>
|
||
|
|
<td valign="top">Licensed internal code options</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.DFTCHAR"><b>DFTCHAR</b></a></td>
|
||
|
|
<td valign="top">Default char type</td>
|
||
|
|
<td valign="top"><b><u>*UNSIGNED</u></b>, *SIGNED</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTBNDCPP.TGTCCSID"><b>TGTCCSID</b></a></td>
|
||
|
|
<td valign="top">Target CCSID</td>
|
||
|
|
<td valign="top">1-65535, <b><u>*SOURCE</u></b>, *JOB, *HEX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTBNDCPP.TEMPLATE"><b>TEMPLATE</b></a></td>
|
||
|
|
<td valign="top">Template options</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Temporary include directory</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Path name</i>, <b><u>*NONE</u></b>, *TEMPINC</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Maximum generated headers</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-99999, <b><u>1</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Template validity checking</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NO</u></b>, *WARN, *ERROR</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTBNDCPP.PGM"></a>
|
||
|
|
<h3>Program (PGM)</h3>
|
||
|
|
<p>Specifies the name and library for the created program object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>program-name</i></b></dt>
|
||
|
|
<dd>Enter a name for the program object.
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
|
<dd>The program object is stored in the current library. If a job does not have a current library, the program object is created in the QGPL library.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the program object being created will be stored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.SRCFILE"></a>
|
||
|
|
<h3>Source file (SRCFILE)</h3>
|
||
|
|
<p>Specifies the source file name and library of the file containing the ILE C++ source code that you want to compile.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QCPPSRC</u></b></dt>
|
||
|
|
<dd>The source file named QCPPSRC contains the member with the ILE C++ source code that you want to compile.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>source-file-name</i></b></dt>
|
||
|
|
<dd>Enter the name of the source file that contains the member with the ILE C++ source code.
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>The library list is searched to find the library where the source file is located.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library is searched for the source file. If a job does not have a current library, QGPL is searched for the source file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Enter the name of the library that contains the source file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.SRCMBR"></a>
|
||
|
|
<h3>Source member (SRCMBR)</h3>
|
||
|
|
<p>Specifies the name of the member containing the source code to be compiled.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PGM</u></b></dt>
|
||
|
|
<dd>The program name supplied on the PGM parameter is used as the source member name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Enter the name of the member that contains the source code.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.SRCSTMF"></a>
|
||
|
|
<h3>Source stream file (SRCSTMF)</h3>
|
||
|
|
<p>Specifies the path name of the stream file containing the source code that you want to compile.
|
||
|
|
</p>
|
||
|
|
<p>The path name can be either absolutely or relatively qualified. An absolute path name starts with '/'; a relative path name starts with a character other than '/'. If absolutely-qualified, the path name is complete. If relatively-qualified, the path name is completed by pre-pending the job's current working directory to the path name.
|
||
|
|
</p>
|
||
|
|
<p>The SRCMBR and SRCFILE parameters cannot be specified with the SRCSTMF parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the program object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRCMBRTXT</u></b></dt>
|
||
|
|
<dd>The text description associated with the source file member is used for the program object. If the source file is an inline file, a stream file, or a device file, the text will be blank.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>Specifies that no text appears.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'description'</i></b></dt>
|
||
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.OUTPUT"></a>
|
||
|
|
<h3>Output options (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether a compiler listing is produced.
|
||
|
|
</p>
|
||
|
|
<p><b>Single Value</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Does not generate the compiler listing. When a listing is not required, this parameter value should be used to improve compile-time performance. When *NONE is specified, any listing-related parameter values specified for the OPTION parameter are ignored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Output File Name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>Generates a spooled file containing the listing.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'path-name'</i></b></dt>
|
||
|
|
<dd>Specify the path name of a stream file to hold the listing.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Title</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>Specifies that no text appears.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'title'</i></b></dt>
|
||
|
|
<dd>Specify a title string for the listing file (maximum 80 characters).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Subtitle</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>Specifies that no text appears.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'subtitle'</i></b></dt>
|
||
|
|
<dd>Specify a subtitle string for the listing file (maximum 80 characters).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.OPTION"></a>
|
||
|
|
<h3>Compiler options (OPTION)</h3>
|
||
|
|
<p>Specifies the options to use when the ILE C++ source code is compiled. You can specify them in any order, separated by one or more blanks. When an option is specified more than once, or when two options conflict, the last one specified is used.
|
||
|
|
</p>
|
||
|
|
<p>The possible options are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOBITSIGN</u></b></dt>
|
||
|
|
<dd>Specify bitfields as unsigned.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BITSIGN</b></dt>
|
||
|
|
<dd>Specify bitfields as signed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOEVENTF</u></b></dt>
|
||
|
|
<dd>Do not create an event file for use by CoOperative Development Environment/400 (CODE/400).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EVENTF</b></dt>
|
||
|
|
<dd>Create an event file for use by CoOperative Development Environment/400 (CODE/400). The event file is created as a member in file EVFEVENT in the library where the module or program object being created will be stored. If the file EVFEVENT does not exist, it is automatically created. The event file member name is the same as the name of the object being created. CODE/400 uses this file to provide error feedback integrated with the CODE/400 editor. An Event File is normally created when you create a module or program object from within CODE/400.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOEXPMAC</u></b></dt>
|
||
|
|
<dd>Macros are not expanded in the listing unless a syntax error is encountered within the macro.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EXPMAC</b></dt>
|
||
|
|
<dd>Expand all macros in the listing.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOFULL</u></b></dt>
|
||
|
|
<dd>Do not turn on all listing options.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FULL</b></dt>
|
||
|
|
<dd>Turn on all listing options.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOINCDIRFIRST</u></b></dt>
|
||
|
|
<dd>Include directories specified as INCDIR parameters are not included before the standard header file include path.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INCDIRFIRST</b></dt>
|
||
|
|
<dd>Include directories specified as INCDIR parameters are included before the standard header file include path.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*LOGMSG</u></b></dt>
|
||
|
|
<dd>Puts the compilation messages in the job log.
|
||
|
|
<p>When you specify this option and the FLAG parameter, messages with the severity specified on the FLAG parameter (and higher) are placed in the job log.
|
||
|
|
</p>
|
||
|
|
<p>When you specify this option and a maximum number of messages on the MSGLMT parameter, compilation stops when the number of messages, at the specified severity, have been placed in the job log.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOLOGMSG</b></dt>
|
||
|
|
<dd>Does not put the compilation messages in the job log.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*LONGLONG</u></b></dt>
|
||
|
|
<dd>Allows the use of the long long data type.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOLONGLONG</b></dt>
|
||
|
|
<dd>Do not allow the use of the long long data type.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NORTTI</u></b></dt>
|
||
|
|
<dd>Do not generate run-time type identification (RTTI) information.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTTIALL</b></dt>
|
||
|
|
<dd>Generate the information needed for the RTTI typeid and the dynamic_cast operator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTTITYPE</b></dt>
|
||
|
|
<dd>Generate the information needed for the RTTI typeid operator only.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTTICAST</b></dt>
|
||
|
|
<dd>Generate the information needed for the dynamic_cast operator only.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOSHOWINC</u></b></dt>
|
||
|
|
<dd>Does not expand the user include files or the system include files in the source section of the listing or in the debug views.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SHOWINC</b></dt>
|
||
|
|
<dd>Expands both the user include files and the system include files in the source section of the listing or in the debug views. An OUTPUT option, or DBGVIEW parameter value of *ALL, *SOURCE or *LIST must be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*SHOWSRC</u></b></dt>
|
||
|
|
<dd>Show the source code in the listing. This option can be modified by the *SHOWINC, *SHOWSYS or *SHOWUSR options.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSHOWSRC</b></dt>
|
||
|
|
<dd>Does not show the source code in the listing. This option may be modified by the *EXPMAC, *SHOWINC, *SHOWSYS or *SHOWUSR options.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOSHOWSYS</u></b></dt>
|
||
|
|
<dd>Do not expand the system include files on the #include directive in the source section of the listing or in the debug views. System include files are enclosed in angle brackets (< >) following the #include directive.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SHOWSYS</b></dt>
|
||
|
|
<dd>Expands the system include files on the #include directive in the source section of the listing or in the debug views. An output option, or DBGVIEW parameter of *ALL, *SOURCE or *LIST must be specified. System include files are enclosed in angle brackets (< >) following the #include directive.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOSHOWUSR</u></b></dt>
|
||
|
|
<dd>Do not expand user include files in the listing or debug views. User include files are enclosed in double quotation marks (" ") following the #include directive.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SHOWUSR</b></dt>
|
||
|
|
<dd>Expands the user include files on the #include directive in the source section of the listing or in the debug views. An OUTPUT option, or DBGVIEW parameter value of *ALL, *SOURCE or *LIST must be specified. User include files are enclosed in double quotation marks (" ") following the #include directive.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*STDINC</u></b></dt>
|
||
|
|
<dd>The system-supplied header files are included in the search path for the compile.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSTDINC</b></dt>
|
||
|
|
<dd>The system-supplied header files are not included in the search path for the compile.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOSTDLOGMSG</u></b></dt>
|
||
|
|
<dd>Compilation messages are not sent to the stdout stream.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STDLOGMSG</b></dt>
|
||
|
|
<dd>Compilation messages are sent to the stdout stream.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOSYSINCPATH</u></b></dt>
|
||
|
|
<dd>The search path for user includes is not affected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSINCPATH</b></dt>
|
||
|
|
<dd>Changes the search path of user includes to the system include search path. In function this option is equivalent to changing the double-quotes in the user #include directive (#include "file_name") to angle brackets (#include <file_name>).
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOXREF</u></b></dt>
|
||
|
|
<dd>Does not generate the cross-reference table in the listing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*XREF</b></dt>
|
||
|
|
<dd>Generates the cross-reference table containing a list of the identifiers in the source code together with the numbers of the lines in which they appear. An OUTPUT option must be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOXREFREF</u></b></dt>
|
||
|
|
<dd>Do not produce a cross-reference table of referenced identifiers in the listing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*XREFREF</b></dt>
|
||
|
|
<dd>Produce a cross-reference table of referenced variables, structures, and function names in the listing file. The table shows the line numbers where the identifiers are declared. An OUTPUT option must be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.CHECKOUT"></a>
|
||
|
|
<h3>Checkout options (CHECKOUT)</h3>
|
||
|
|
<p>Specifies options you may select to generate informational messages that indicate possible programming errors. When you specify an option more than once, or when two options conflict, the last one specified is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Disables all of the options for CHECKOUT.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USAGE</b></dt>
|
||
|
|
<dd>This is equivalent to specifying *COND.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Enables all of the options for CHECKOUT.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOCLASS</u></b></dt>
|
||
|
|
<dd>Do not display information about class use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CLASS</b></dt>
|
||
|
|
<dd>Display information about class use.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOCOND</u></b></dt>
|
||
|
|
<dd>Do not warn about possible redundancies or problems in conditional expressions.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*COND</b></dt>
|
||
|
|
<dd>Warn about possible redundancies or problems in conditional expressions.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOEFFECT</u></b></dt>
|
||
|
|
<dd>Do not warn about statements with no effect.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EFFECT</b></dt>
|
||
|
|
<dd>Warn about statements with no effect.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOGENERAL</u></b></dt>
|
||
|
|
<dd>Do not generate general checkout messages.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GENERAL</b></dt>
|
||
|
|
<dd>Generate general checkout messages.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOLANG</u></b></dt>
|
||
|
|
<dd>Do not display information about the effects of the language level.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANG</b></dt>
|
||
|
|
<dd>Display information about the effects of the language level.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOPARM</u></b></dt>
|
||
|
|
<dd>Do not warn about unused parameters.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PARM</b></dt>
|
||
|
|
<dd>Warn about unused parameters.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOPORT</u></b></dt>
|
||
|
|
<dd>Do not warn about non-portable language constructs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PORT</b></dt>
|
||
|
|
<dd>Warn about non-portable language constructs.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOREACH</u></b></dt>
|
||
|
|
<dd>Do not warn about unreachable statements.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REACH</b></dt>
|
||
|
|
<dd>Warn about unreachable statements.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOTEMP</u></b></dt>
|
||
|
|
<dd>Do not generate messages if the compiler creates temporary variables.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TEMP</b></dt>
|
||
|
|
<dd>Generate messages if the compiler creates temporary variables.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOTRUNC</u></b></dt>
|
||
|
|
<dd>Do not warn about the possible truncation or loss of data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TRUNC</b></dt>
|
||
|
|
<dd>Warn about the possible truncation or loss of data.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOUNUSED</u></b></dt>
|
||
|
|
<dd>Do not check for unused auto or static variables.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UNUSED</b></dt>
|
||
|
|
<dd>Check for unused auto or static variables.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.OPTIMIZE"></a>
|
||
|
|
<h3>Optimization (OPTIMIZE)</h3>
|
||
|
|
<p>Specifies the levels of optimization of the generated object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>10</u></b></dt>
|
||
|
|
<dd>Generated code is not optimized. This level has the shortest compile time. This level allows variables to be displayed and modified while debugging.
|
||
|
|
</dd>
|
||
|
|
<dt><b>20</b></dt>
|
||
|
|
<dd>Some optimization is performed on the code. This level allows user variables to be displayed but not modified while debugging.
|
||
|
|
</dd>
|
||
|
|
<dt><b>30</b></dt>
|
||
|
|
<dd>Full optimization is performed on the generated code. During a debug session, user variables may not be modified but may be displayed. The presented values may not be the current value of the variable.
|
||
|
|
</dd>
|
||
|
|
<dt><b>40</b></dt>
|
||
|
|
<dd>All optimizations done at level 30 are performed on the generated code. In addition, code is eliminated from procedure prologue and epilogue routines that enable instruction trace and call trace system functions. Eliminating this code enables the creation of leaf procedures. A leaf procedure is a procedure that contains no calls to other procedures. Procedure call performance to a leaf procedure is significantly faster than to a normal procedure.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.INLINE"></a>
|
||
|
|
<h3>Inline options (INLINE)</h3>
|
||
|
|
<p>Specifies whether the compiler should consider replacing a function call with the called function's instructions. Inlining a function eliminates the overhead of a call and can result in better optimization. Small functions that are called many times are good candidates for inlining.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Inliner</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies whether or not inlining will be used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*OFF</u></b></dt>
|
||
|
|
<dd>Specifies that inlining will not be performed on the compilation unit.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ON</b></dt>
|
||
|
|
<dd>Specifies that inlining will be performed on the compilation unit. If a debug view is specified, the inliner is turned off.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Mode</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies whether or not the inliner should attempt to automatically inline functions depending on their Threshold and Limit values.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOAUTO</u></b></dt>
|
||
|
|
<dd>Specifies that only the functions that have been specified with the #pragma inline directive should be considered candidates for inlining.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AUTO</b></dt>
|
||
|
|
<dd>Specifies that the inliner should determine if a function can be inlined based on the Threshold and Limit values specified. The #pragma noinline directive overrides *AUTO.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Threshold </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the maximum size of a function that can be a candidate for automatic inlining. The size is measured in Abstract Code Units (ACUs). ACUs are proportional in size to the executable code in the function. Source code is translated into ACUs by the compiler.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>250</u></b></dt>
|
||
|
|
<dd>Specifies a threshold of 250.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-ACUs</i></b></dt>
|
||
|
|
<dd>Specifies a threshold from 1 to 65535 ACUs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOLIMIT</b></dt>
|
||
|
|
<dd>Defines the threshold as the maximum size of the program object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 4: Limit </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the maximum relative size a function can grow before auto-inlining stops.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>2000</u></b></dt>
|
||
|
|
<dd>Specifies a limit of 2000 ACUs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOLIMIT</b></dt>
|
||
|
|
<dd>Limit is defined as the maximum size of the program object. System limits may be encountered.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-ACUs</i></b></dt>
|
||
|
|
<dd>A limit from 1 to 65535 ACUs may be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 5: Report</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies whether or not to produce an inliner report with the compiler listing.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The inliner report is not produced.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The inliner report is produced as part of the compiler listing. An OUTPUT option must be specified to produce the inliner report.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.DBGVIEW"></a>
|
||
|
|
<h3>Debugging view (DBGVIEW)</h3>
|
||
|
|
<p>Specifies which level of debugging is available for the module in the created program object. It also specifies which source views are available for source level debugging. Requesting a debug view will turn inlining off.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Debug capability is not inserted into the program object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Enables all of the debug options (*STMT, *SOURCE and *LIST)
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STMT</b></dt>
|
||
|
|
<dd>Allows the program object to be debugged using program statement numbers and symbolic identifiers.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To debug a module object using the *STMT option you need a listing.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SOURCE</b></dt>
|
||
|
|
<dd>Generates the source view for debugging the program object. OPTION parameter values *NOSHOWINC, *SHOWINC, *SHOWSYS, and *SHOWUSR determine the content of the source view created.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>In order to use this view for debugging, the root source file should not be modified, renamed or moved after the program object is created.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIST</b></dt>
|
||
|
|
<dd>Generates the listing view for debugging the program object. OPTION parameter values *SHOWINC, *SHOWUSR, *SHOWSYS, and *NOSHOWINC determine the content of the listing view created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.DEFINE"></a>
|
||
|
|
<h3>Define names (DEFINE)</h3>
|
||
|
|
<p>Specifies preprocessor macros that take effect before the file is processed by the compiler. Using the format DEFINE(macro) is equivalent to DEFINE('macro=1').
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No macro is defined.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'name'</i> or <i>'name=value'</i></b></dt>
|
||
|
|
<dd>A maximum of 32 macros may be defined. Each macro name is enclosed in apostrophes. The maximum length of a macro name is 80 characters. The apostrophes are not part of the 80 character string. The apostrophes are required for case-sensitive macro names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Macros defined in the command override any macro definition of the same name in the source but a warning message is generated by the compiler. Function-like macros such as #define max(a,b) ((a)>(b):(a)?(b)) cannot be defined on the command line.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.LANGLVL"></a>
|
||
|
|
<h3>Language level (LANGLVL)</h3>
|
||
|
|
<p>Specifies the capabilities of the compiler and which prototypes are declared when the source is created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*EXTENDED</u></b></dt>
|
||
|
|
<dd>Defines the preprocessor variable __EXTENDED__ and undefines other language-level variables. This parameter should be used when all the capabilities of ILE C++ are required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANSI</b></dt>
|
||
|
|
<dd>Defines the preprocessor variables __ANSI__, __STDC__ and __cplusplus98_interface__, and undefines other language-level variables. Only ANSI-standard C++ is made available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LEGACY</b></dt>
|
||
|
|
<dd>This option allows some of the source constructs acceptable to earlier compilers.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.ALIAS"></a>
|
||
|
|
<h3>Alias (ALIAS)</h3>
|
||
|
|
<p>Specifies the aliasing assertion to be applied in the program object being created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ANSI</u></b></dt>
|
||
|
|
<dd>The program object will only allow pointers to point to an object of the same type.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOANSI</b></dt>
|
||
|
|
<dd>The program object will not use the *ANSI aliasing rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADDRTAKEN</b></dt>
|
||
|
|
<dd>The program object will have its class of variables disjoint from pointers unless their address is taken.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOADDRTAKEN</b></dt>
|
||
|
|
<dd>The program object will not use the *ADDRTAKEN aliasing rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLPTRS</b></dt>
|
||
|
|
<dd>The program object will not allow any two pointers to be aliased.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOALLPTRS</b></dt>
|
||
|
|
<dd>The program object will not use the *ALLPTRS aliasing rules.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TYPEPTR</b></dt>
|
||
|
|
<dd>The program object will not allow any two pointers of different types to be aliased.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOTYPEPTR</b></dt>
|
||
|
|
<dd>The program object will not use the *TYPEPTR aliasing rules.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.SYSIFCOPT"></a>
|
||
|
|
<h3>System interface options (SYSIFCOPT)</h3>
|
||
|
|
<p>Specifies which system interface options will be used for the program object being created. You can specify them in any order, separated by one or more blanks. When an option is specified more than once, or when two options conflict, the last one specified is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*IFS64IO</u></b></dt>
|
||
|
|
<dd>The program object will use the Integrated File System for 64-bit C stream I/O operations.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IFSIO</b></dt>
|
||
|
|
<dd>The program object will use the Integrated File System for C stream I/O operations.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOIFSIO</b></dt>
|
||
|
|
<dd>The program object will use the iSeries Data Management file system for C stream I/O operations.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.LOCALETYPE"></a>
|
||
|
|
<h3>Locale object type (LOCALETYPE)</h3>
|
||
|
|
<p>Specifies the type of locale support to be used by the program object being created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOCALE</u></b></dt>
|
||
|
|
<dd>Program objects created with this option use the locale support provided by *LOCALE objects.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOCALEUCS2</b></dt>
|
||
|
|
<dd>Program objects created with this option use the locale support provided by *LOCALE objects. Wide-character types will contain two-byte universal character set values.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOCALEUTF</b></dt>
|
||
|
|
<dd>Program objects created with this option use the locale support provided by *LOCALE objects. Wide-character types will contain four-byte utf-32 values. Narrow character types will contain utf-8 values.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.FLAG"></a>
|
||
|
|
<h3>Message flagging level (FLAG)</h3>
|
||
|
|
<p>Specifies the level of messages that are to be displayed in the listing.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>0</u></b></dt>
|
||
|
|
<dd>All messages starting at the informational level are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>10</b></dt>
|
||
|
|
<dd>All messages starting at the warning level are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>20</b></dt>
|
||
|
|
<dd>All messages starting at the error level are displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>30</b></dt>
|
||
|
|
<dd>All messages starting at the severe error level are displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.MSGLMT"></a>
|
||
|
|
<h3>Message limit (MSGLMT)</h3>
|
||
|
|
<p>Specifies the maximum number of messages at the given message severity that can occur before the compilation is stopped.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Message Limit </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the maximum number of messages that can occur at, or above, the message severity level specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOMAX</u></b></dt>
|
||
|
|
<dd>Compilation continues regardless of the number of messages that have occurred at the message severity level specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>message-limit</i></b></dt>
|
||
|
|
<dd>Specify the number of messages that can occur. The valid range is 0 to 32767.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Message Severity </b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies the message severity that can stop the compilation if the <i>message-limit</i> number of messages at the specified severity or above occur.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>30</u></b></dt>
|
||
|
|
<dd>Specifies that a <i>message-limit</i> of messages at severity 30 can occur before compilation stops.
|
||
|
|
</dd>
|
||
|
|
<dt><b>0</b></dt>
|
||
|
|
<dd>Specifies that a <i>message-limit</i> of messages at severity 0 or above can occur before compilation stops.
|
||
|
|
</dd>
|
||
|
|
<dt><b>10</b></dt>
|
||
|
|
<dd>Specifies that a <i>message-limit</i> of messages at severity 10 or above can occur before compilation stops.
|
||
|
|
</dd>
|
||
|
|
<dt><b>20</b></dt>
|
||
|
|
<dd>Specifies that a <i>message-limit</i> of messages at severity 20 or above can occur before compilation stops.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.REPLACE"></a>
|
||
|
|
<h3>Replace program object (REPLACE)</h3>
|
||
|
|
<p>Specifies whether the existing version of the object will be replaced by the current version.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The existing object is replaced by the new version. The old version is moved to the QRPLOBJ library and renamed based on the system date and time. The text description of the replaced object is changed to the name of the original object. The old object is deleted at the next IPL if it has not been explicitly deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The existing object is not replaced. When an object with the same name is found in the specified library, a message is displayed and compilation stops.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.USRPRF"></a>
|
||
|
|
<h3>User profile (USRPRF)</h3>
|
||
|
|
<p>Specifies the user profile that is used when the created program object is run, including the authority that the program object has for each object. The profile of either the program owner or the program user is used to control which objects can be used by the program object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*USER</u></b></dt>
|
||
|
|
<dd>The profile of the user running the program object is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OWNER</b></dt>
|
||
|
|
<dd>The user profiles of both the program's owner and the program's user are used when the program object is processed. The collective sets of object authority in both user profiles are used to find and access objects during program processing. Authority from the owning user profile's group profile is not included in the authority for the running program object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority granted to users who do not have specific authority to the object, who are not on the authorization list, or whose group has no specific authority to the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
||
|
|
<dd>Public authority for the object is taken from the CRTAUT keyword of the target library (the library that contains the created object). This value is determined when the object is created. When the CRTAUT value for the library changes after the object is created, the new value does not affect any existing objects in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Provides authority for all operations on the object except those limited to the owner or controlled by authorization list management authority. Any user can control the object's existence, specify the security for it, change it, and perform basic functions on it, including transfer its ownership.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHANGE</b></dt>
|
||
|
|
<dd>Provides all data authority and the authority to perform all operations on the object except those limited to the owner or controlled by object authority and object management authority. The object can be changed and basic functions can be performed on it.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USE</b></dt>
|
||
|
|
<dd>Provides object operational authority; read authority; and authority for basic read-only operations on the object, such as binding of a module object. Users without specific authority are prevented from changing the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>Users without special authority cannot access the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>authorization-list-name</i></b></dt>
|
||
|
|
<dd>Enter the name of an authorization list of users and authorities to which the object is added. The object is secured by this authorization list, and the public authority for the object is set to *AUTL. The authorization list must exist on the system when the command is issued.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the release of the operating system on which the user intends to use the object being created.
|
||
|
|
</p>
|
||
|
|
<p>In the examples given for the *CURRENT and *PRV values, and when specifying the <u> release-level</u> value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V4R5M0 is version 4, release 5, modification level 0.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The object will be used on the release of the operating system currently running on the user's system. For example, if V4R5M5 is running on the system, *CURRENT means the user intends to use the object on a system with V4R5M5 installed. The user can also use the object on a system with any subsequent release of the operating system installed.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If V4R5M5 is running on the system, and the object will be used on a system with V4R5M0 installed, specify TGTRLS(V4R5M0) not TGTRLS(*CURRENT).
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The object will be used on the previous release with modification level 0 of the operating system. For example, if V4R5M5 is running on the user's system, *PRV means the user intends to use the object on a system with V4R4M0 installed. The user can also use the object on a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>release-level</i></b></dt>
|
||
|
|
<dd>Specify the release in the format VxRxMx. The object can be used on a system with the specified release or with any subsequent release of the operating system installed.
|
||
|
|
<p>Valid values depend on the current version, release, and modification level. They change with each new release. If you specify a release level which is earlier than the earliest release level supported by this command, an error message is sent.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.ENBPFRCOL"></a>
|
||
|
|
<h3>Enable performance collection (ENBPFRCOL)</h3>
|
||
|
|
<p>Specifies whether performance measurement code should be generated in the object. The data collected can be used by the system performance tool to profile an application's performance. Generating performance measurement code in a created object will result in slightly larger objects and may affect performance.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PEP</u></b></dt>
|
||
|
|
<dd>Performance statistics are gathered on the entry and exit of the program entry procedure only. Choose this value when you want to gather overall performance information for an application.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ENTRYEXIT *NONLEAF</b></dt>
|
||
|
|
<dd>Performance statistics are gathered on the entry and exit of all procedures of the program object that are not leaf procedures. This includes the program PEP routine.
|
||
|
|
<p>This choice would be useful if you only wanted to capture information on those routines that invoke other routines in your application.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ENTRYEXIT *ALLPRC</b></dt>
|
||
|
|
<dd>Performance statistics are gathered on the entry and exit of all the procedures of the program object (including those that are leaf procedures). This includes the program PEP routine.
|
||
|
|
<p>This choice would be useful if you wanted to capture information on all routines. Use this option when you know that all the program objects called by your application were created with either the *PEP, *ENTRYEXIT or *FULL option. Otherwise, if your application calls other program objects that are not enabled for performance measurement, the performance tool will charge their use of resources against your application. This would make it difficult for you to determine where resources are actually being used.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FULL *NONLEAF</b></dt>
|
||
|
|
<dd>Performance statistics are gathered on entry and exit of all procedures that are not leaf procedures. Also, statistics are gathered before and after each call to an external procedure.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FULL *ALLPRC</b></dt>
|
||
|
|
<dd>Performance statistics are gathered on the entry and exit of all procedures including leaf procedures. Also statistics are gathered before and after each call to an external procedure.
|
||
|
|
<p>Use this option when you think that your application will call other program objects that were not created with either *PEP, *ENTRYEXIT or *FULL. This option allows the performance tools to distinguish between resources that are used by your application and those used by program objects it calls (even if those program objects are not enabled for performance measurement). This option is the most expensive but allows for selectively analyzing various program objects in an application.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.PFROPT"></a>
|
||
|
|
<h3>Performance options (PFROPT)</h3>
|
||
|
|
<p>Specifies various options available to boost performance. You can specify them in any order, separated by one or more blanks. When an option is specified more than once, or when two options conflict, the last one specified is used.
|
||
|
|
</p>
|
||
|
|
<p>The possible options are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SETFPCA </u></b></dt>
|
||
|
|
<dd>Causes the compiler to set the floating point computational attributes to achieve ANSI semantics for floating point computations.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSETFPCA</b></dt>
|
||
|
|
<dd>No computational attributes will be set. This option should only be used when the object being created does not have any floating point computations in it.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*NOSTRDONLY </u></b></dt>
|
||
|
|
<dd>Specifies that the compiler must place strings into writeable memory.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STRDONLY</b></dt>
|
||
|
|
<dd>Specifies that the compiler may place strings into read-only memory.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.PRFDTA"></a>
|
||
|
|
<h3>Profiling data (PRFDTA)</h3>
|
||
|
|
<p>Specifies the program profiling data attribute for the program object. Program profiling is an advanced optimization technique used to reorder procedures and code within the procedures based on statistical data (profiling data).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOCOL</u></b></dt>
|
||
|
|
<dd>The program object is not enabled to collect profiling data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*COL</b></dt>
|
||
|
|
<dd>The program object is enabled to collect profiling data. *COL can be specified only when the optimization level is 30 or greater.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.TERASPACE"></a>
|
||
|
|
<h3>Teraspace options (TERASPACE)</h3>
|
||
|
|
<p>Specifies whether the program object is enabled to work with teraspace storage. This includes teraspace storage allocated by the program object and parameters passed from other teraspace-enabled program and service program objects.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Teraspace Enabled</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The program object is not enabled to handle addressing of storage allocated from teraspace.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The program object is enabled to handle addressing of storage allocated from teraspace, including parameters passed from other teraspace-enabled program and service program objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Use Teraspace Interfaces</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOTSIFC</u></b></dt>
|
||
|
|
<dd>The program object will default to use the non-teraspace versions of the storage functions.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TSIFC</b></dt>
|
||
|
|
<dd>The program object will default to use the teraspace versions of the storage functions. The compiler will define macro variable __TERASPACE__.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.STGMDL"></a>
|
||
|
|
<h3>Storage model (STGMDL)</h3>
|
||
|
|
<p>Specifies the type of storage to be used by the object created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SNGLVL</u></b></dt>
|
||
|
|
<dd>The object created will use single-level storage.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TERASPACE</b></dt>
|
||
|
|
<dd>The object created will use teraspace storage.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.DTAMDL"></a>
|
||
|
|
<h3>Data model (DTAMDL)</h3>
|
||
|
|
<p>Specifies the sizes (in bytes) of variables declared as int, long, pointer.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*P128</u></b></dt>
|
||
|
|
<dd>Causes the sizes of int, long, pointer to be 4, 4, 16 respectively.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LLP64</b></dt>
|
||
|
|
<dd>Causes the sizes of int, long, pointer to be 4, 4, 8 respectively. The compiler will define the macro __LLP64_IFC__.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.RTBND"></a>
|
||
|
|
<h3>Run time Binding (RTBND)</h3>
|
||
|
|
<p>Specifies the run time binding directory for the object created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEFAULT</u></b></dt>
|
||
|
|
<dd>The object created will use the default binding directory.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LLP64</b></dt>
|
||
|
|
<dd>The object created will use the 64-bit run time binding directory. This value is only available in conjunction with teraspace storage model, 64-bit data model and teraspace storage functions interface options. The compiler will define the macro __LLP64_RTBND__.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.PACKSTRUCT"></a>
|
||
|
|
<h3>Pack structure (PACKSTRUCT)</h3>
|
||
|
|
<p>Specifies the alignment boundary to use for members of a structure.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NATURAL</u></b></dt>
|
||
|
|
<dd>Structure members are aligned on their natural boundaries. For example, a short integer will be two-byte aligned. 16-byte pointers will always align on 16-byte boundaries.
|
||
|
|
</dd>
|
||
|
|
<dt><b>1</b></dt>
|
||
|
|
<dd>Pack structure members on a 1-byte alignment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>2</b></dt>
|
||
|
|
<dd>Pack structure members on a 2-byte alignment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>4</b></dt>
|
||
|
|
<dd>Pack structure members on a 4-byte alignment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>8</b></dt>
|
||
|
|
<dd>Pack structure members on a 8-byte alignment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>16</b></dt>
|
||
|
|
<dd>Pack structure members on a 16-byte alignment.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.ENUM"></a>
|
||
|
|
<h3>Enum size (ENUM)</h3>
|
||
|
|
<p>Specifies the number of bytes the compiler uses to represent an enumeration.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SMALL</u></b></dt>
|
||
|
|
<dd>Make all enum variables the smallest size that can represent the range of values.
|
||
|
|
</dd>
|
||
|
|
<dt><b>1</b></dt>
|
||
|
|
<dd>Make all enum variables 1 byte.
|
||
|
|
</dd>
|
||
|
|
<dt><b>2</b></dt>
|
||
|
|
<dd>Make all enum variables 2 bytes.
|
||
|
|
</dd>
|
||
|
|
<dt><b>4</b></dt>
|
||
|
|
<dd>Make all enum variables 4 bytes.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INT</b></dt>
|
||
|
|
<dd>Use the ANSI-standard enum size, which is 4 bytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.MAKEDEP"></a>
|
||
|
|
<h3>Dependency information (MAKEDEP)</h3>
|
||
|
|
<p>Specifies whether or not to generate dependency information into a file. This information can be used by a make tool.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Do not generate dependency information.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'path-name'</i></b></dt>
|
||
|
|
<dd>Specify a path name for the stream file in which to store the dependency information.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.INCDIR"></a>
|
||
|
|
<h3>Include directory (INCDIR)</h3>
|
||
|
|
<p>Specifies one or more directories to add to the search path used by the compiler to find include files.
|
||
|
|
</p>
|
||
|
|
<p>The search path can be further modified by using the following parameters on the OPTION keyword:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*INCDIRFIRST or *NOINCDIRFIRST
|
||
|
|
</li>
|
||
|
|
<li>*SYSINCPATH or *NOSYSINCPATH
|
||
|
|
</li>
|
||
|
|
<li>*STDINC or *NOSTDINC
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Unless modified, the default system include directory and the source directory will be searched for user include files.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'directory'</i></b></dt>
|
||
|
|
<dd>Specify up to 32 directories in which to search for include files. In addition to the specified directories, the source directory is searched for user include files.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.CSOPT"></a>
|
||
|
|
<h3>Compiler services option (CSOPT)</h3>
|
||
|
|
<p>Specifies one or more compiler service options. This parameter allows IBM to provide switchable compiler capability between releases.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No compiler service option is selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'compiler-service-options-string'</i></b></dt>
|
||
|
|
<dd>The selected compiler service options are used when creating the module object. Valid strings will be described in PTF cover letters or in release notes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.LICOPT"></a>
|
||
|
|
<h3>Licensed internal code options (LICOPT)</h3>
|
||
|
|
<p>Specifies one or more Licensed Internal Code compile-time options. This parameter allows individual compile-time options to be selected, and is intended for the advanced programmer who understands the potential benefits and drawbacks of each selected type of compiler option.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No compile-time options are selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'Licensed-Internal-Code-options-string'</i></b></dt>
|
||
|
|
<dd>The selected Licensed Internal Code compile-time options are used when creating the module object. Certain options may reduce your ability to debug the created module object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.DFTCHAR"></a>
|
||
|
|
<h3>Default char type (DFTCHAR)</h3>
|
||
|
|
<p>Specifies the default sign for the char data type.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*UNSIGNED</u></b></dt>
|
||
|
|
<dd>Make default char type unsigned.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SIGNED</b></dt>
|
||
|
|
<dd>Make default char type signed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.TGTCCSID"></a>
|
||
|
|
<h3>Target CCSID (TGTCCSID)</h3>
|
||
|
|
<p>Specifies the target coded character set identifier used to describe data stored into the resulting program object.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SOURCE</u></b></dt>
|
||
|
|
<dd>The root source file's CCSID is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOB</b></dt>
|
||
|
|
<dd>The current job's CCSID is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>The CCSID 65535 is used, which indicates that character data is treated as binary data and is not converted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>coded-character-set-identifier</i></b></dt>
|
||
|
|
<dd>Specify the CCSID to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTBNDCPP.TEMPLATE"></a>
|
||
|
|
<h3>Template options (TEMPLATE)</h3>
|
||
|
|
<p>Specifies template options to the compiler.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Template Include Directory </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Templates are not generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TEMPINC</b></dt>
|
||
|
|
<dd>Templates are generated into a directory named tempinc which is created in the directory where the root source file was found. If the source file is not a stream file, a file named TEMPINC will be created in the library where the source file resides. The TEMPLATE(*TEMPINC) and TMPLREG parameters are mutually exclusive.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'directory'</i></b></dt>
|
||
|
|
<dd>Specify the directory where the compiler will generate templates.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Maximum Generated Headers </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>1</u></b></dt>
|
||
|
|
<dd>The maximum number of generated headers that contain templates.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-header-files</i></b></dt>
|
||
|
|
<dd>Specify an integer value from 1 to 99999 for the maximum number of generated header files.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Template Validity Checking </b>
|
||
|
|
</p>
|
||
|
|
<p>Controls whether parsing and semantic checking are applied to template definition implementations or only to template instantiations. The compiler has the option to producte warning or error messages. Available parameters are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Do not parse to reduce the number of errors issued in code written for previous versions of the compiler.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*WARN</b></dt>
|
||
|
|
<dd>Issue warning messages for semantic errors. Issue error messages for errors found while parsing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ERROR</b></dt>
|
||
|
|
<dd>Treat problems in template implementations as errors, even if the template is not instantiated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTBNDCPP.COMMAND.EXAMPLES">Examples</a></h3>None
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTBNDCPP.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CZS1613</b></dt>
|
||
|
|
<dd>The compilation failed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTBNDCPP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|