666 lines
27 KiB
HTML
666 lines
27 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 CL Program (CRTCLPGM)</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="CRTCLPGM.Top_Of_Page"></a>
|
|
<h2>Create CL Program (CRTCLPGM)</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="#CRTCLPGM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTCLPGM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTCLPGM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTCLPGM"></a>
|
|
<p>The Create CL Program (CRTCLPGM) command creates a Control Language (CL) program from the specified CL source program.
|
|
</p>
|
|
<p><b>Restrictions:</b> The amount of auxiliary storage occupied by a compiled program varies with the number of commands in the program, the kinds of functions performed by the commands (for example: display, create, add, and call), and the kinds of parameter values specified (variables versus constants). Some combinations of these factors can cause the system internal size limits for the program to be exceeded (an unlikely occurrence). When the limits are exceeded, the program must be rewritten, usually as multiple programs instead of one program.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTCLPGM.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="#CRTCLPGM.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="#CRTCLPGM.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>QCLSRC</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="#CRTCLPGM.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="#CRTCLPGM.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="#CRTCLPGM.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Source listing options</td>
|
|
<td valign="top">Values (up to 6 repetitions): *SOURCE, *NOSOURCE, *SRC, *NOSRC, *XREF, *NOXREF, *GEN, *NOGEN, *SECLVL, *NOSECLVL, *SRCDBG, *NOSRCDBG, *LSTDBG, *NOLSTDBG</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCLPGM.GENOPT"><b>GENOPT</b></a></td>
|
|
<td valign="top">Generation options</td>
|
|
<td valign="top">Values (up to 3 repetitions): *NOLIST, *LIST, *NOXREF, *XREF, *NOPATCH, *PATCH</td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCLPGM.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="#CRTCLPGM.LOG"><b>LOG</b></a></td>
|
|
<td valign="top">Log commands</td>
|
|
<td valign="top"><b><u>*JOB</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCLPGM.ALWRTVSRC"><b>ALWRTVSRC</b></a></td>
|
|
<td valign="top">Allow RTVCLSRC</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCLPGM.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="#CRTCLPGM.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="#CRTCLPGM.AUT"><b>AUT</b></a></td>
|
|
<td valign="top">Authority</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTCLPGM.SRTSEQ"><b>SRTSEQ</b></a></td>
|
|
<td valign="top">Sort sequence</td>
|
|
<td valign="top">Single values: <b><u>*HEX</u></b>, *JOB, *JOBRUN, *LANGIDUNQ, *LANGIDSHR<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Sort sequence</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>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTCLPGM.LANGID"><b>LANGID</b></a></td>
|
|
<td valign="top">Language ID</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOBRUN</u></b>, *JOB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTCLPGM.PGM"></a>
|
|
<h3>Program (PGM)</h3>
|
|
<p>Specifies the program to be created.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Program</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the program to be created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
|
<dd>The program is stored in the current library for the job. If no current library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the program is to be stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.SRCFILE"></a>
|
|
<h3>Source file (SRCFILE)</h3>
|
|
<p>Specifies the source file that contains the CL source member to be compiled.
|
|
</p>
|
|
<p><b>Qualifier 1: Source file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QCLSRC</u></b></dt>
|
|
<dd>The source file named QCLSRC, that contains the CL source member to be compiled, is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the source file that contains the CL source member to be compiled. The source file can be a database file, a device file, or an inline data file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the source file. If no library is specified as the current library for the thread, the QGPL library is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.SRCMBR"></a>
|
|
<h3>Source member (SRCMBR)</h3>
|
|
<p>Specifies the name of the source member (of the source file) that contains the CL source program to be compiled.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PGM</u></b></dt>
|
|
<dd>The job name is the same as the program name specified for the <b>Program (PGM)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>If the member name is not the same as the name of the program to be created, specify the name of the member that contains the CL source program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRCMBRTXT</u></b></dt>
|
|
<dd>The text is taken from the source file member used to create the CL program.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>character-value</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="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.OPTION"></a>
|
|
<h3>Source listing options (OPTION)</h3>
|
|
<p>Specifies the types of output listings created when this command is processed, and if a program is created when this command is processed. Multiple option values can be specified in any order on this parameter. If neither or both of the values in each group are specified, the underlined value will be used.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The underlined values for this parameter are <i>similar</i> to, but not <i>actually</i> default values, and therefore, cannot be changed with the Change Command Default (CHGCMDDFT) command.
|
|
</p>
|
|
<p><b>Source Listing Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRC or *SOURCE</u></b></dt>
|
|
<dd>The compiler creates a listing of the source input used to compile the program.
|
|
</dd>
|
|
<dt><b>*NOSRC or *NOSOURCE</b></dt>
|
|
<dd>A complete compiler source listing is not created; only compiler errors are listed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Cross Reference Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*XREF</u></b></dt>
|
|
<dd>The compiler creates a cross-reference listing of references to variables or labels in the source. If *NOSOURCE is specified, *NOXREF is always assumed.
|
|
</dd>
|
|
<dt><b>*NOXREF</b></dt>
|
|
<dd>No cross-reference listing of references to variables and data items in the source is created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Program Creation Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*GEN</u></b></dt>
|
|
<dd>The compiler creates a program and places it in the appropriate library.
|
|
</dd>
|
|
<dt><b>*NOGEN</b></dt>
|
|
<dd>No program is created. The compiler is to syntax check the source and (if *SOURCE or *SRC option is specified) produce a source listing.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Second-Level Message Text Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOSECLVL</u></b></dt>
|
|
<dd>No second-level message text will be printed.
|
|
</dd>
|
|
<dt><b>*SECLVL</b></dt>
|
|
<dd>Second-level text will be printed, along with first-level text, for compiler errors.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Source-Level Debug Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOSRCDBG</u></b></dt>
|
|
<dd>Source-level debug information is not generated. Source-level error information will not be generated unless *LSTDBG is specified.
|
|
</dd>
|
|
<dt><b>*SRCDBG</b></dt>
|
|
<dd>The compiler generates source-level error and debug information for use with CoOperative Development Environment/400 (CODE/400). Source-level or listing-level debugging information is also necessary if you want to use the source-level debug function of the system debugger (STRDBG OPMSRC(*YES)) to debug OPM programs. An event file is created even if the compiler completes the process without error.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Listing-Level Debug Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOLSTDBG</u></b></dt>
|
|
<dd>A listing view or listing-level debugging information is not generated. Source-level error information will not be created unless *SRCDBG is specified.
|
|
</dd>
|
|
<dt><b>*LSTDBG</b></dt>
|
|
<dd>The compiler generates a listing view, source-level error information, and listing-level debugging information for use with CoOperative Development Environment/400 (CODE/400). Source-level or listing-level debugging information is also necessary if you want to use the source-level debug function of the system debugger (STRDBG OPMSRC(*YES)) to debug OPM programs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.GENOPT"></a>
|
|
<h3>Generation options (GENOPT)</h3>
|
|
<p>Specifies the program generation options to be used. These values are ignored if OPTION(*NOGEN) is specified. Multiple option values can be specified in any order on this parameter. If neither or both of the values in each group are specified, the underlined value will be used.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The underlined values for this parameter are <i>similar</i> to, but not <i>actually</i> default values, and therefore, cannot be changed with the Change Command Default (CHGCMDDFT) command.
|
|
</p>
|
|
<p><b>IRP/MI Listing Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOLIST</u></b></dt>
|
|
<dd>No listing of the intermediate representation of the program (IRP) is created.
|
|
</dd>
|
|
<dt><b>*LIST</b></dt>
|
|
<dd>A listing of the intermediate representation of the program (IRP), including the generated machine interface (MI) instructions, is created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>IRP/MI Cross-Reference Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOXREF</u></b></dt>
|
|
<dd>No cross-reference listing of variable and data item references in the intermediate representation of the program is created.
|
|
</dd>
|
|
<dt><b>*XREF</b></dt>
|
|
<dd>A cross-reference listing of variable and data item references in the intermediate representation of the program is created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Program Patch Area Option</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOPATCH</u></b></dt>
|
|
<dd>No space is to be reserved in the compiled program for a program patch area.
|
|
</dd>
|
|
<dt><b>*PATCH</b></dt>
|
|
<dd>Space is reserved in the compiled CL program for a program patch area.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.USRPRF"></a>
|
|
<h3>User profile (USRPRF)</h3>
|
|
<p>Specifies whether the authority checking done while this program is running should include only the user who is running the program (*USER) or both the user who is running the program and the program owner (*OWNER). The profiles of the program user or both the program user and the program owner are used to control which objects can be used by the program, including the authority the program has for each object. Only the program owner or a user with QSECOFR authority can change the user profile attribute.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if REPLACE(*YES) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*USER</u></b></dt>
|
|
<dd>The program runs under the user profile of the program's user.
|
|
</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 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.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.LOG"></a>
|
|
<h3>Log commands (LOG)</h3>
|
|
<p>Specifies the logging options for a created CL program. *YES or *NO specified here takes precedence over any value specified in the Change Job (CHGJOB) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*JOB</u></b></dt>
|
|
<dd>Logging of commands in a running CL program depends on the status of the job's logging flag (see the LOGCLPGM parameter of the Change Job (CHGJOB) command).
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Commands are logged in all cases.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Commands are not logged.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.ALWRTVSRC"></a>
|
|
<h3>Allow RTVCLSRC (ALWRTVSRC)</h3>
|
|
<p>Specifies whether source for the CL program is saved with the program. Source that is saved can be retrieved later by using the Retrieve CL Source (RTVCLSRC) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Source for the CL program is saved with the program.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Source for the CL program is not saved with the program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.REPLACE"></a>
|
|
<h3>Replace program (REPLACE)</h3>
|
|
<p>Specifies, if a program by the same name already exists in the specified library, whether the existing program is replaced.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>If a running CL program is recompiled with *YES specified for the REPLACE parameter, message queue errors may occur in the running CL program.
|
|
</li>
|
|
<li>Specifying *YES for this parameter will cause the values of the <b>User profile (USRPRF)</b> parameter and <b>Authority (AUT)</b> parameter to be ignored. The existing program is used as the source of authority, and the user profile attribute is copied from the existing program to the new program. Use the Change Program (CHGPGM) command to change the user profile and the Grant Object Authority (GRTOBJAUT) or Revoke Object Authority (RVKOBJAUT) commands to change the authority for the program.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Replace the existing program by moving it to the QRPLOBJ library.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not replace an existing program by the same name in the specified library.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.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.
|
|
</p>
|
|
<p>When specifying the <b>target-release</b> 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, V5R3M0 is version 5, release 3, modification 0.
|
|
</p>
|
|
<p>Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.
|
|
</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. The object can also be used 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. The object can also be used on a system with any subsequent release of the operating system installed.
|
|
</dd>
|
|
<dt><b><i>character-value</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.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies the authority you are granting to the users who do not have specific authority for the object, who are not on the authorization list, and whose user group has no specific authority for the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*USE</b></dt>
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The user cannot access the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored when REPLACE(*YES) is specified.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.SRTSEQ"></a>
|
|
<h3>Sort sequence (SRTSEQ)</h3>
|
|
<p>Specifies the sort sequence table to be used for string comparisons for this CL program. The sort sequence value is used with the language identifier and the coded character set identifier of the job to determine the sort sequence table to use.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*HEX</u></b></dt>
|
|
<dd>A sort sequence table is not used. The hexadecimal values of the characters are used to determine the sort sequence.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>The sort sequence used is the SRTSEQ associated with the job when the CL program is created.
|
|
</dd>
|
|
<dt><b>*JOBRUN</b></dt>
|
|
<dd>The sort sequence used is the SRTSEQ associated with the job when the CL program is run.
|
|
</dd>
|
|
<dt><b>*LANGIDUNQ</b></dt>
|
|
<dd>The sort sequence table uses a unique weight for each character, and is the unique-weight sort table for the language specified for the LANGID parameter.
|
|
</dd>
|
|
<dt><b>*LANGIDSHR</b></dt>
|
|
<dd>The sort sequence table uses the same weight for multiple characters, and is the shared-weight sort sequence table associated with the language specified for the LANGID parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Sort sequence</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the sort sequence table to be used with this CL program.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCLPGM.LANGID"></a>
|
|
<h3>Language ID (LANGID)</h3>
|
|
<p>Specifies the language identifier to be used when SRTSEQ(*LANGIDUNQ) or SRTSEQ(*LANGIDSHR) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*JOBRUN</u></b></dt>
|
|
<dd>The language ID used is the LANGID associated with the job when the CL program is run.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>The language ID used is the LANGID associated with the job when the CL program is created.
|
|
</dd>
|
|
<dt><b><i>language-ID</i></b></dt>
|
|
<dd>Specify the language identifier to be used by the job.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTCLPGM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Creating a Program to be Run by Any System User</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTCLPGM PAYROLL TEXT('Payroll Program')
|
|
</pre>
|
|
</p>
|
|
<p>This command calls the CL compiler to create a program named PAYROLL. The CL procedure source is in the default source file QCLSRC in the member PAYROLL. A compiler listing is created. The program is processed under the program user's user profile and can be run by any system user.
|
|
</p>
|
|
<p><b>Example 2: Creating a Program to be Run by an Authorized User</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTCLPGM PGM(PARTS) SRCFILE(MYLIB/PARTDATA) AUT(*EXCLUDE)
|
|
TEXT('This program displays all parts data')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a CL program named PARTS and stores it in the current library. The source for the program is in the PARTS member of the source file PARTDATA in the library MYLIB. A compiler listing is created. This program can be processed under the profile of the user that is running the program, who could be the owner or another user to which the owner has granted specific authorization by name in the Grant Object Authority (GRTOBJAUT) command.
|
|
</p>
|
|
<p><b>Example 3: Creating a Program to be Run on a Previous Release System</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTCLPGM PGM(MYPGM) SRCFILE(MYLIB/MYDATA) TGTRLS(*PRV)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a CL program that can be saved for a previous release system, restored on that system, and run on that system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTCLPGM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0C33</b></dt>
|
|
<dd>Target release &1 not valid.
|
|
</dd>
|
|
<dt><b>CPF0C35</b></dt>
|
|
<dd>Target release &1 is not a supported release.
|
|
</dd>
|
|
<dt><b>CPF0801</b></dt>
|
|
<dd>Program &1 not created.
|
|
</dd>
|
|
<dt><b>CPF0804</b></dt>
|
|
<dd>Built-in function operands not valid. Reason code &1.
|
|
</dd>
|
|
<dt><b>CPF0807</b></dt>
|
|
<dd>File containing compiler printout not opened.
|
|
</dd>
|
|
<dt><b>CPF0808</b></dt>
|
|
<dd>Error in compiler-created code.
|
|
</dd>
|
|
<dt><b>CPF0814</b></dt>
|
|
<dd>Licensed Program 5722-SS1 Option 9 not installed.
|
|
</dd>
|
|
<dt><b>CPF0815</b></dt>
|
|
<dd>CL program &1 in &2 cannot be created for previous release.
|
|
</dd>
|
|
<dt><b>CPF0816</b></dt>
|
|
<dd>%SWITCH mask &1 not valid.
|
|
</dd>
|
|
<dt><b>CPF0849</b></dt>
|
|
<dd>Space addressing violation.
|
|
</dd>
|
|
<dt><b>CPF3202</b></dt>
|
|
<dd>File &1 in library &2 in use.
|
|
</dd>
|
|
<dt><b>CPF3203</b></dt>
|
|
<dd>Cannot allocate object for file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF3224</b></dt>
|
|
<dd>Not authorized to perform operation on file &1.
|
|
</dd>
|
|
<dt><b>EVF3140</b></dt>
|
|
<dd>The program's debug information was not created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCLPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|