660 lines
23 KiB
HTML
660 lines
23 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 RPG II Program (CRTS36RPG)</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="CRTS36RPG.Top_Of_Page"></a>
|
|
<h2>Create RPG II Program (CRTS36RPG)</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="#CRTS36RPG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTS36RPG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTS36RPG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTS36RPG"></a>
|
|
<p>The command Create System/36 RPG Program (CRTS36RPG) is used to call the System/36-compatible RPG II compiler.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTS36RPG.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="#CRTS36RPG.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">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Program</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CTLSPEC</u></b></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="#CRTS36RPG.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>QS36SRC</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="#CRTS36RPG.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="#CRTS36RPG.GENLVL"><b>GENLVL</b></a></td>
|
|
<td valign="top">Generation severity level</td>
|
|
<td valign="top">0-99, <b><u>21</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.NEP"><b>NEP</b></a></td>
|
|
<td valign="top">Never ending program</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.MRTMAX"><b>MRTMAX</b></a></td>
|
|
<td valign="top">Maximum MRT devices</td>
|
|
<td valign="top">0-99, <b><u>0</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.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"><a href="#CRTS36RPG.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Source listing options</td>
|
|
<td valign="top">Values (up to 10 repetitions): *SOURCE, *NOSOURCE, *SRC, *NOSRC, *XREF, *NOXREF, *GEN, *NOGEN, *DUMP, *NODUMP, *SECLVL, *NOSECLVL, *CONSOLE, *NOCONSOLE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.GENOPT"><b>GENOPT</b></a></td>
|
|
<td valign="top">Generation options</td>
|
|
<td valign="top">Values (up to 10 repetitions): *LIST, *NOLIST, *XREF, *NOXREF, *ATR, *NOATR, *DUMP, *NODUMP, *PATCH, *NOPATCH, *OPTIMIZE, *NOOPTIMIZE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTS36RPG.PRTFILE"><b>PRTFILE</b></a></td>
|
|
<td valign="top">Print file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Print file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QSYSPRT</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="#CRTS36RPG.ICFLIB"><b>ICFLIB</b></a></td>
|
|
<td valign="top">Library for ICF files</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace program</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.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"><a href="#CRTS36RPG.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="#CRTS36RPG.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="#CRTS36RPG.PHSTRC"><b>PHSTRC</b></a></td>
|
|
<td valign="top">Phase trace</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.ITDUMP"><b>ITDUMP</b></a></td>
|
|
<td valign="top">Intermediate text dump</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="#CRTS36RPG.SNPDUMP"><b>SNPDUMP</b></a></td>
|
|
<td valign="top">Snap dump</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="#CRTS36RPG.CODELIST"><b>CODELIST</b></a></td>
|
|
<td valign="top">Codelist</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPG.FIXDECDTA"><b>FIXDECDTA</b></a></td>
|
|
<td valign="top">Fix decimal data</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTS36RPG.PGM"></a>
|
|
<h3>Program (PGM)</h3>
|
|
<p>Specifies the library and program name by which the compiled RPG program is to be known.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CTLSPEC</u></b></dt>
|
|
<dd>Specifies the program name used by the system, in positions 75 - 80 of the control specification.
|
|
</dd>
|
|
<dt><b><i>program-name</i></b></dt>
|
|
<dd>Enter the name by which the program object will be known.
|
|
</dd>
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, #LIBRARY will be used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library in which the compiled program is to be stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.SRCFILE"></a>
|
|
<h3>Source file (SRCFILE)</h3>
|
|
<p>Specifies the name of the file that contains the source program and the name of the library that contains the file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QS36SRC</u></b></dt>
|
|
<dd>Specifies the default file name.
|
|
</dd>
|
|
<dt><b><i>source-file-name</i></b></dt>
|
|
<dd>Enter the name of the source file containing the program to be compiled.
|
|
</dd>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>Causes the system to search the library list to find the library containing the source file.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, #LIBRARY will be used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library in which the source file is stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.SRCMBR"></a>
|
|
<h3>Source member (SRCMBR)</h3>
|
|
<p>Specifies the name of the member of the source file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PGM</u></b></dt>
|
|
<dd>Specifies the member name for the source program to be compiled.
|
|
</dd>
|
|
<dt><b><i>source-file-member-name</i></b></dt>
|
|
<dd>Enter the name of the member containing the source program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.GENLVL"></a>
|
|
<h3>Generation severity level (GENLVL)</h3>
|
|
<p>Specifies whether or not a program object is to be generated depending on the severity of the errors encountered.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>21</u></b></dt>
|
|
<dd>Does not generate a program object if error messages have a severity level of 21 or greater.
|
|
</dd>
|
|
<dt><b><i>severity-level-value</i></b></dt>
|
|
<dd>Enter a number from 0 through 99. The severity level value of RPG messages does not exceed 50.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.NEP"></a>
|
|
<h3>Never ending program (NEP)</h3>
|
|
<p>Specifies whether the current program is to be a never-ending program.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Specifies that this is not a never-ending program.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Specifies that this is a never-ending program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.MRTMAX"></a>
|
|
<h3>Maximum MRT devices (MRTMAX)</h3>
|
|
<p>Specifies the maximum number of requesting display stations.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>0</u></b></dt>
|
|
<dd>This is a SRT program.
|
|
</dd>
|
|
<dt><b><i>maximum-terminals</i></b></dt>
|
|
<dd>Enter a number from 0 through 99 to show the maximum number of requesting terminals.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Allows the user to enter text that describes the program and its function.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRCMBRTXT</u></b></dt>
|
|
<dd>Uses the text in the source program.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>Omits the text.
|
|
</dd>
|
|
<dt><b><i>text</i></b></dt>
|
|
<dd>Enter the description, enclosed in apostrophes, in 50 characters or less.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.OPTION"></a>
|
|
<h3>Source listing options (OPTION)</h3>
|
|
<p>Specifies the options to use when the source program is compiled.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SOURCE</u> or <u>*SRC</u></b></dt>
|
|
<dd>Produces a source listing with compile-time errors.
|
|
</dd>
|
|
<dt><b>*NOSOURCE or *NOSRC</b></dt>
|
|
<dd>Does not produce a source listing.
|
|
</dd>
|
|
<dt><b><u>*XREF</u></b></dt>
|
|
<dd>Produces a cross-reference listing and key-field information table.
|
|
</dd>
|
|
<dt><b>*NOXREF</b></dt>
|
|
<dd>Does not produce a cross-reference listing and key-field information table. This is the default when *NOSOURCE is specified.
|
|
</dd>
|
|
<dt><b><u>*GEN</u></b></dt>
|
|
<dd>Creates a program that can be run.
|
|
</dd>
|
|
<dt><b>*NOGEN</b></dt>
|
|
<dd>Does not create a program that can be run.
|
|
</dd>
|
|
<dt><b><u>*NODUMP</u></b></dt>
|
|
<dd>Does not print the program template when an error occurs.
|
|
</dd>
|
|
<dt><b>*DUMP</b></dt>
|
|
<dd>Prints a program template when an error occurs.
|
|
</dd>
|
|
<dt><b><u>*NOSECLVL</u></b></dt>
|
|
<dd>Does not print second-level messages.
|
|
</dd>
|
|
<dt><b>*SECLVL</b></dt>
|
|
<dd>Prints second-level messages following first-level messages.
|
|
</dd>
|
|
<dt><b><u>*CONSOLE</u></b></dt>
|
|
<dd>Creates display formats for a CONSOLE file if the program being compiled contains a CONSOLE file.
|
|
</dd>
|
|
<dt><b>*NOCONSOLE</b></dt>
|
|
<dd>Does not create display formats for a CONSOLE file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.GENOPT"></a>
|
|
<h3>Generation options (GENOPT)</h3>
|
|
<p>Specifies the options to use when the program object is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOLIST</u></b></dt>
|
|
<dd>Does not produce a listing of the intermediate representation of a program (IRP).
|
|
</dd>
|
|
<dt><b>*LIST</b></dt>
|
|
<dd>Produces a listing of the intermediate representation of a program (IRP).
|
|
</dd>
|
|
<dt><b><u>*NOXREF</u></b></dt>
|
|
<dd>Does not print a cross-reference listing for the IRP.
|
|
</dd>
|
|
<dt><b>*XREF</b></dt>
|
|
<dd>Prints a cross-reference listing for the IRP.
|
|
</dd>
|
|
<dt><b><u>*NOATR</u></b></dt>
|
|
<dd>Does not produce an attribute listing for the IRP.
|
|
</dd>
|
|
<dt><b>*ATR</b></dt>
|
|
<dd>Produces an attribute listing for the IRP.
|
|
</dd>
|
|
<dt><b><u>*NODUMP</u></b></dt>
|
|
<dd>Does not print the program template when an error occurs.
|
|
</dd>
|
|
<dt><b>*DUMP</b></dt>
|
|
<dd>Prints a program template when an error occurs.
|
|
</dd>
|
|
<dt><b><u>*NOPATCH</u></b></dt>
|
|
<dd>Does not reserve a program patch area in the compiled program.
|
|
</dd>
|
|
<dt><b>*PATCH</b></dt>
|
|
<dd>Reserves a program patch area in the compiled program.
|
|
</dd>
|
|
<dt><b><u>*NOOPTIMIZE</u></b></dt>
|
|
<dd>Does not improve a program for more efficient processing.
|
|
</dd>
|
|
<dt><b>*OPTIMIZE</b></dt>
|
|
<dd>Improves a program for more efficient processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.PRTFILE"></a>
|
|
<h3>Print file (PRTFILE)</h3>
|
|
<p>Specifies the name of the file in which the compiler listing is to be placed and the library in which the file is located.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QSYSPRT</u></b></dt>
|
|
<dd>If a file name is not specified, the compiler listing is placed in QSYSPRT file.
|
|
</dd>
|
|
<dt><b><i>print-file-name</i></b></dt>
|
|
<dd>Enter the name of the file in which the compiler listing is to be placed.
|
|
</dd>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The system searches the library list to find the library.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library will be used. If you have not specified a current library, #LIBRARY will be used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Enter the name of the library in which the file is stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.ICFLIB"></a>
|
|
<h3>Library for ICF files (ICFLIB)</h3>
|
|
<p>Specifies the library containing the ICF record format definitions to be used with the program.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>ICF-library-name</i></b></dt>
|
|
<dd>Enter the name of the library for ICF files.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.REPLACE"></a>
|
|
<h3>Replace program (REPLACE)</h3>
|
|
<p>Specifies whether or not a new program object is to be created if a program with the same name already exists in the specified library.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>A new program object will be created and any existing program object of the same name in the specified library will be moved to library QRPLOBJ.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>A new program object will not be created if a program object of the same name exists in the specified library.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.TGTRLS"></a>
|
|
<h3>Target release (TGTRLS)</h3>
|
|
<p>Specifies the release of the operating system on which you intend to use the object being created. In the examples given for the *CURRENT and *PRV values, and when specifying the <u> target-release</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, V2R3M0 is version 2, release 3, modification level 0.
|
|
</p>
|
|
<p>Valid values for this parameter change every release.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The object is to be used on the release of the operating system currently running on your system. For example, if V2R3M5 is running on the system, *CURRENT means that you intend to use the object on a system with V2R3M5 installed. You can can also use the object on a system with any subsequent release of the operating system installed.
|
|
</dd>
|
|
<dt><b>*PRV</b></dt>
|
|
<dd>The object is to be used on the previous release with modification level 0 of the operating system. For example, if V2R3M5 is running on your system, *PRV means you intend to use the object on a system with V2R2M0 installed. You can also use the object on a system with any subsequent release of the operating system installed.
|
|
</dd>
|
|
<dt><b><i>target-release</i></b></dt>
|
|
<dd>Specify the release in the format VxRxMx. You can use the object 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, and they change with each new release. If you specify a release-level that is earlier than the earliest release level supported by this command, an error message is sent indicating the earliest supported release.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>The program may be able to be restored on a release level earlier than the one you specified on the create command. Use DSPPGM to determine the earliest release the program can run.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.USRPRF"></a>
|
|
<h3>User profile (USRPRF)</h3>
|
|
<p>Specifies the user profile that the compiled RPG program is to run under.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*USER</u></b></dt>
|
|
<dd>Uses the program user's profile when the program runs.
|
|
</dd>
|
|
<dt><b>*OWNER</b></dt>
|
|
<dd>Uses the user profiles of both the program's owner and user when the program runs. The USRPRF parameter will not be updated if the program already exists.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies what authority is granted for the program.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
|
<dd>The default public authority for created objects is taken from the CRTAUT keyword which is associated with the target library. The value is determined at create time. If the value of the CRTAUT keyword of the library changes after the create, the new value will not affect any existing objects.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Complete authority for the program except for transferal of object ownership.
|
|
</dd>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>All operations are permitted except those dealing with the object's existence and its management.
|
|
</dd>
|
|
<dt><b>*USE</b></dt>
|
|
<dd>Permission to read or run the compiled program, but not to debug or to change it.
|
|
<p>
|
|
<b>Note: </b>A user must have *USE authority to a program to obtain a formatted dump of the variables of the program. To dump variables, the program must also have observable information.
|
|
</p>
|
|
<p>If you do not want some users to be able to dump the variables, then give them only *OBJOPR plus *EXECUTE authority to the program. This will allow them to call the program but not dump its variables.
|
|
</p>
|
|
<p>If you do not want any users to be able to dump the variables, then use Change Program (CHGPGM) to remove the program's observable information.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>No authority.
|
|
</dd>
|
|
<dt><b><i>authorization-list</i></b></dt>
|
|
<dd>The name of the authorization list which secures the object. The public authority will be *AUTL.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.PHSTRC"></a>
|
|
<h3>Phase trace (PHSTRC)</h3>
|
|
<p>Specifies whether trace information about the compiler phases will be included in the listing.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Does not provide compiler phase information.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Provides compiler phase information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.ITDUMP"></a>
|
|
<h3>Intermediate text dump (ITDUMP)</h3>
|
|
<p>Produces a dynamic listing of intermediate text for the specified compiler phases.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Does not produce an intermediate text dump.
|
|
</dd>
|
|
<dt><b><i>phase-name</i></b></dt>
|
|
<dd>Enter the fourth and fifth characters of from 1 to 25 phase names.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.SNPDUMP"></a>
|
|
<h3>Snap dump (SNPDUMP)</h3>
|
|
<p>Produces a listing of major data areas and intermediate text following compilation of one or more specified phases.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Does not produce a snap dump.
|
|
</dd>
|
|
<dt><b><i>phase-name</i></b></dt>
|
|
<dd>Enter the fourth and fifth characters of from 1 to 25 phase names.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.CODELIST"></a>
|
|
<h3>Codelist (CODELIST)</h3>
|
|
<p>Causes dynamic listing of the intermediate representation of a program (IRP) for the specified compiler phases.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Does not produce IRP listings.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Produces an IRP listing for each compiler phase.
|
|
</dd>
|
|
<dt><b><i>phase-name</i></b></dt>
|
|
<dd>Enter the fourth and fifth characters of from 1 to 25 phase names.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPG.FIXDECDTA"></a>
|
|
<h3>Fix decimal data (FIXDECDTA)</h3>
|
|
<p>Specifies whether decimal data which is not valid is corrected or an error is signaled.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Corrects data which is not valid by setting digit values in the range A through F to zero, and not valid signs to plus.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Signals an error to the program without correcting the data which is not valid.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTS36RPG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Compiling a Source Program into a Program Object </b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTS36RPG PGM(MYLIB/XMPLE1)
|
|
SRCFILE(MYLIB/QS36SRC) SRCMBR(XMPLE1)
|
|
OPTION(*SOURCE) TEXT('My RPG II program')
|
|
</pre>
|
|
</p>
|
|
<p>This command calls the System/36 Compatible RPG II compiler to create a program named XMPLE1. The source program is in member XMPLE1 of source file QS36SRC in library MYLIB. A compiler listing is created.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTS36RPG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>QRG9001</b></dt>
|
|
<dd>Compilation failed. Program is not created.
|
|
</dd>
|
|
<dt><b>QRG9004</b></dt>
|
|
<dd>The release &1 specified on the TGTRLS option is not supported.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|