349 lines
13 KiB
HTML
349 lines
13 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 Console Display File (CRTS36RPGR)</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="CRTS36RPGR.Top_Of_Page"></a>
|
|
<h2>Create Console Display File (CRTS36RPGR)</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="#CRTS36RPGR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTS36RPGR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTS36RPGR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTS36RPGR"></a>
|
|
<p>The Create System/36 RPGR command (CRTS36RPGR) is used to create a CONSOLE display file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTS36RPGR.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"><a href="#CRTS36RPGR.SRCMBR"><b>SRCMBR</b></a></td>
|
|
<td valign="top">Source member</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTS36RPGR.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>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTS36RPGR.OUTLIB"><b>OUTLIB</b></a></td>
|
|
<td valign="top">Output library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTS36RPGR.FMTSRCF"><b>FMTSRCF</b></a></td>
|
|
<td valign="top">File to receive S/36 formats</td>
|
|
<td valign="top">Single values: *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive S/36 formats</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SRCFILE</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SRCLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTS36RPGR.FMTMBR"><b>FMTMBR</b></a></td>
|
|
<td valign="top">Member to receive formats</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CRTDFT</u></b></td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTS36RPGR.DDSSRCF"><b>DDSSRCF</b></a></td>
|
|
<td valign="top">File to receive DDS</td>
|
|
<td valign="top">Single values: *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive DDS</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SRCFILE</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SRCLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTS36RPGR.DDSMBR"><b>DDSMBR</b></a></td>
|
|
<td valign="top">Member to receive DDS</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CRTDFT</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPGR.GEN"><b>GEN</b></a></td>
|
|
<td valign="top">Generate console formats</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPGR.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace output members</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTS36RPGR.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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTS36RPGR.SRCMBR"></a>
|
|
<h3>Source member (SRCMBR)</h3>
|
|
<p>Specifies the source member that contains the RPG II program specifications.
|
|
</p>
|
|
<dl>
|
|
<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="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.SRCFILE"></a>
|
|
<h3>Source file (SRCFILE)</h3>
|
|
<p>Specifies the file that contains the RPG II source member and 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 source member.
|
|
</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 source file is stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.OUTLIB"></a>
|
|
<h3>Output library (OUTLIB)</h3>
|
|
<p>Specifies the library that contains the display format object member.
|
|
</p>
|
|
<dl>
|
|
<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>output-library-name</i></b></dt>
|
|
<dd>Enter the name of the library in which the object member will be stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.FMTSRCF"></a>
|
|
<h3>File to receive S/36 formats (FMTSRCF)</h3>
|
|
<p>Specifies the file in which the member containing the S and D specifications will be stored and the library that will contain the file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRCFILE</u></b></dt>
|
|
<dd>Uses the file name specified in the source file parameter (SRCFILE).
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Specifies that the S and D specifications will not be produced.
|
|
</dd>
|
|
<dt><b><i>S&D-source-file-name</i></b></dt>
|
|
<dd>Enter the name of the file that will contain the S and D specifications.
|
|
</dd>
|
|
<dt><b><u>*SRCLIB</u></b></dt>
|
|
<dd>Uses the same library that you specified in the source file library name (SRCFILE Parameter).
|
|
</dd>
|
|
<dt><b><i>S&D-library-name</i></b></dt>
|
|
<dd>Enter the name of the library that will contain the S and D source file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.FMTMBR"></a>
|
|
<h3>Member to receive formats (FMTMBR)</h3>
|
|
<p>Specifies the member that will contain the S and D specifications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CRTDFT</u></b></dt>
|
|
<dd>Uses the specified source member name (SRCMBR) with 'FM' added to the end of it.
|
|
</dd>
|
|
<dt><b><i>S&D-member-name</i></b></dt>
|
|
<dd>Enter the name of the member that will contain the S and D specifications.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.DDSSRCF"></a>
|
|
<h3>File to receive DDS (DDSSRCF)</h3>
|
|
<p>Specifies the file in which the member containing the DDS specifications will be stored and the library that will contain the file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRCFILE</u></b></dt>
|
|
<dd>Uses the file name specified in the source file parameter (SRCFILE).
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Specifies that the DDS specifications will not be produced.
|
|
</dd>
|
|
<dt><b><i>DDS-source-file-name</i></b></dt>
|
|
<dd>Enter the name of the source file that will contain the DDS member.
|
|
</dd>
|
|
<dt><b>*SRCLIB</b></dt>
|
|
<dd>Uses the same library that you specified in the source file library name (SRCFILE Parameter).
|
|
</dd>
|
|
<dt><b><i>DDS-library-name</i></b></dt>
|
|
<dd>Enter the name of the library that will contain the DDS source file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.DDSMBR"></a>
|
|
<h3>Member to receive DDS (DDSMBR)</h3>
|
|
<p>Specifies the member that will contain the DDS specifications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CRTDFT</u></b></dt>
|
|
<dd>Uses the specified source member name (SRCMBR) with 'A' added to the end of it.
|
|
</dd>
|
|
<dt><b><i>DDS-member-name</i></b></dt>
|
|
<dd>Enter the name of the member that will contain the DDS specifications.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.GEN"></a>
|
|
<h3>Generate console formats (GEN)</h3>
|
|
<p>Specifies that the display formats for the CONSOLE file are to be created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Specifies that display formats will be generated.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Specifies that display formats will not be generated.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.REPLACE"></a>
|
|
<h3>Replace output members (REPLACE)</h3>
|
|
<p>Specifies whether or not a new CONSOLE display file is to be created if a file with the same name already exists in the specified library.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Specifies that a new CONSOLE display file will be created and any existing CONSOLE display file of the same name in the specified library will be deleted.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Specifies that a new CONSOLE display file will not be created if a member of the same name exists in the specified library.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTS36RPGR.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.
|
|
</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="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTS36RPGR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Compiling a Source Program into a Program Object </b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTS36RPGR SRCMBR(XMPLE1) SRCFILE(MYLIB/QS36SRC)
|
|
OUTLIB(MYLIB)
|
|
FMTSRCF(*SRCLIB/QS36DDSSRC) FMTMBR(*CRTDFT)
|
|
DDSSRCF(*SRCLIB/QDDSSRC) DDSMBR(*CRTDFT)
|
|
REPLACE(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a display file for a CONSOLE file from the RPG II source member XMPLE1. The name of the file will be the name in column 75 of the Control (H) specification in the RPG source, followed by FM. For example, if the Control specification contains XMPLE1 in columns 75-80, the display file will be named XMPLE1FM. Source member XMPLE1FM will be created in file MYLIB/QS36DDSSRC, containing System/36 Formats (S and D specifications). Source member XMPLE1A will be created in file MYLIB/QDDSSRC, containing the DSPF DDS source used to create the file MYLIB/XMPLE1FM.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTS36RPGR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTS36RPGR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|