594 lines
24 KiB
HTML
594 lines
24 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 S/36 Display File (CRTS36DSPF)</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="CRTS36DSPF.Top_Of_Page"></a>
|
||
|
|
<h2>Create S/36 Display File (CRTS36DSPF)</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="#CRTS36DSPF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTS36DSPF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTS36DSPF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTS36DSPF"></a>
|
||
|
|
<p>The Create System/36 Display File (CRTS36DSPF) command creates a display file from a System/36 source file and adds, deletes, or updates formats in existing display files. Using the TOFILE and TOMBR parameters, you can convert the System/36 SFGR source to data description specifications (DDS) source.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The data description specifications (DDS) source is saved in the DDS source file QS36DDSSRC, in the same library as the display file. If the QS36DDSSRC source file does not exist, this source file is created with a record length of 92.
|
||
|
|
</p>
|
||
|
|
<p><b>Restriction</b>: Option 5 of the operating system must be installed to run this command. This command can be run either natively or in the System/36 environment.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTS36DSPF.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="#CRTS36DSPF.DSPFILE"><b>DSPFILE</b></a></td>
|
||
|
|
<td valign="top">Display file</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: Display file</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"><a href="#CRTS36DSPF.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top">Single values: <b><u>*CREATE</u></b><br>Other values (up to 32 repetitions): *UPDATE, *ADD, *DELETE</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.SRCMBR"><b>SRCMBR</b></a></td>
|
||
|
|
<td valign="top">S/36 SFGR source member</td>
|
||
|
|
<td valign="top">Single values: <b><u>*DSPFILE</u></b><br>Other values (up to 32 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTS36DSPF.SRCFILE"><b>SRCFILE</b></a></td>
|
||
|
|
<td valign="top">S/36 source file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: S/36 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="#CRTS36DSPF.REPLACE"><b>REPLACE</b></a></td>
|
||
|
|
<td valign="top">Replace display file</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.PRINT"><b>PRINT</b></a></td>
|
||
|
|
<td valign="top">Print SFGR listing</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO, *PARTIAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.MAXDEV"><b>MAXDEV</b></a></td>
|
||
|
|
<td valign="top">Maximum devices</td>
|
||
|
|
<td valign="top">1-256, <b><u>*SRCATR</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, *USE, *ALL, *CHANGE, *EXCLUDE, <b><u>*LIBCRTAUT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.GENOPT"><b>GENOPT</b></a></td>
|
||
|
|
<td valign="top">Generation option</td>
|
||
|
|
<td valign="top"><b><u>*GEN</u></b>, *NOGEN, *CONVERT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.SYNTAX"><b>SYNTAX</b></a></td>
|
||
|
|
<td valign="top">Check SFGR source syntax</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTS36DSPF.TOFILE"><b>TOFILE</b></a></td>
|
||
|
|
<td valign="top">To DDS source 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: To DDS source file</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QDDSSRC</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="#CRTS36DSPF.TOMBR"><b>TOMBR</b></a></td>
|
||
|
|
<td valign="top">To DDS source member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *SRCMBR, *DSPFILE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.HALT"><b>HALT</b></a></td>
|
||
|
|
<td valign="top">Issue msg if error occurs</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.DFRWRT"><b>DFRWRT</b></a></td>
|
||
|
|
<td valign="top">Defer write</td>
|
||
|
|
<td valign="top"><b><u>*SRCATR</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36DSPF.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target Release</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*CURRENT</u></b>, *PRV</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTS36DSPF.DSPFILE"></a>
|
||
|
|
<h3>Display file (DSPFILE)</h3>
|
||
|
|
<p>Specifies the name and the library of the created display file.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>display-file-name</i></b></dt>
|
||
|
|
<dd>Specify the display file name.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A display file is not created if the file has the same name and library as an existing program, message file, or other type of file.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the display file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies what to do with the specified display file. A maximum of 32 options can be specified. The given option applies to the corresponding name on the <b>S/36 SFGR source member (SRCMBR)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CREATE</u></b></dt>
|
||
|
|
<dd>A display file is created using the specified display file name as defined by the specified source members. If *CREATE is specified, no other options can be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADD</b></dt>
|
||
|
|
<dd>One or more display formats are added to the specified display file, as defined by the corresponding names specified on the <b>S/36 SFGR source member (SRCMBR)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UPDATE</b></dt>
|
||
|
|
<dd>One or more display formats are updated in the specified display file as defined by the corresponding names specified on the SRCMBR parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DELETE</b></dt>
|
||
|
|
<dd>A display format is deleted from the specified display file. The format that is deleted is defined by the corresponding names specified on the SRCMBR parameter. If all formats in the display file are deleted, the entire display file is deleted and a source file member is not produced.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.SRCMBR"></a>
|
||
|
|
<h3>S/36 SFGR source member (SRCMBR)</h3>
|
||
|
|
<p>Specifies the member used in the source file when performing a create, add, or update option. For a delete option specify the name of the format being deleted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DSPFILE</u></b></dt>
|
||
|
|
<dd>A member with the same name as the display file is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>source-member-name</i></b></dt>
|
||
|
|
<dd>Specify the source member name. A maximum of 32 source member names can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.SRCFILE"></a>
|
||
|
|
<h3>S/36 source file (SRCFILE)</h3>
|
||
|
|
<p>Specifies the name of the source file in which the screen format generator (SFGR) source members are found.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QS36SRC</u></b></dt>
|
||
|
|
<dd>The source file, QS36SRC, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>file-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the source file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</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 job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the source file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.REPLACE"></a>
|
||
|
|
<h3>Replace display file (REPLACE)</h3>
|
||
|
|
<p>Specifies whether an existing display file is replaced. When OPTION(*CREATE) is not specified, this parameter is ignored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>An existing display file is not replaced.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>An existing display file is replaced. Other types of files are not replaced.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A display file is not created if the file has the same name and library as a program or message file.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>If terminating errors are encountered, the existing display file is not replaced. If the display file already exists, the <b>Authority (AUT)</b> parameter is ignored and the authorities for the old display file are copied to the new display file that replaces it. REPLACE(YES) is assumed when OPTION (*ADD) (*UPDATE) or (*DELETE) is specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.PRINT"></a>
|
||
|
|
<h3>Print SFGR listing (PRINT)</h3>
|
||
|
|
<p>Specifies whether the compile listings are printed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Full listings for the SFGR source syntax checking and the DDS compile steps are printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No listing is printed for the SFGR source syntax checking step. *PARTIAL is assumed for the DDS compile step.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PARTIAL</b></dt>
|
||
|
|
<dd>If errors are found in any step, the compile listing is printed for that step, along with the error or warning messages. If no messages are issued, no listing is printed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.MAXDEV"></a>
|
||
|
|
<h3>Maximum devices (MAXDEV)</h3>
|
||
|
|
<p>Specifies the number of devices that can use the display file at one time.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRCATR</u></b></dt>
|
||
|
|
<dd>The maximum number of devices is taken from the first attributes of the source member. The Change System/36 Source Attributes (CHGS36SRCA) and Edit System/36 Source Attributes (EDTS36SRCA) commands can be used to set this value in the source member.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-devices</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of devices. The valid values range from 1 through 256.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority you are giving the users who do not have specific authority to the object, who are not on the authorization list, and whose user group has no specific authority to the object.
|
||
|
|
</p>
|
||
|
|
<p>If REPLACE(*YES) is specified and the display file already exists, the AUT parameter is ignored and the authorities for the old display file are copied to the new display file that replaces it. REPLACE(*YES) is assumed when OPTION *ADD, *UPDATE or *DELETE is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
||
|
|
<dd>The authority for the object is the same as the value specified on the <b>Create authority (CRTAUT)</b> parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
|
</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>
|
||
|
|
</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>
|
||
|
|
</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>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>authorization-list-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>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.GENOPT"></a>
|
||
|
|
<h3>Generation option (GENOPT)</h3>
|
||
|
|
<p>Specifies the compile options that are used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GEN</u></b></dt>
|
||
|
|
<dd>If *YES is specified on the <b>Check SFGR source syntax (SYNTAX)</b> parameter, the SFGR source syntax is checked, the display file is converted to data description specifications (DDS), and a display file (*FILE) object is created. If *NO is specified on the SYNTAX parameter, the SFGR source syntax is not checked.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOGEN</b></dt>
|
||
|
|
<dd>If *YES is specified on the SYNTAX parameter, the SFGR source syntax is checked.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CONVERT</b></dt>
|
||
|
|
<dd>The display file is converted to data description specifications (DDS), but no display file is created. Specify a member name on the <b>To DDS source member (TOMBR)</b> parameter to save the DDS results. If terminating errors are found when syntax checking the SFGR source, no conversion to DDS is performed. If *YES is specified on the SYNTAX parameter, SFGR syntax checking is performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.SYNTAX"></a>
|
||
|
|
<h3>Check SFGR source syntax (SYNTAX)</h3>
|
||
|
|
<p>Specifies whether the SFGR source syntax is checked.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The source syntax is checked.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The source syntax is not checked.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.TOFILE"></a>
|
||
|
|
<h3>To DDS source file (TOFILE)</h3>
|
||
|
|
<p>Specifies the name of the source file in which to store the DDS source that is used to create the display file. The file need not already exist. If the user is authorized to the CRTSRCPF (Create Source Physical File) command, and the file does not exist, a new source file is created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QDDSSRC</u></b></dt>
|
||
|
|
<dd>The source file, QDDSSRC, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>file-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the source file. The file should have a record length of 92 bytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</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 job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the source file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.TOMBR"></a>
|
||
|
|
<h3>To DDS source member (TOMBR)</h3>
|
||
|
|
<p>Specifies the name of the source file member in which to store the DDS source. The source file member is added if it does not exist, and is replaced if it exists. When the member name is the same as that of the display file name, and the to-file is QS36DDSSRC in the same library as the display file being created, the DDS is saved in this member only if the compile operation of the display file is successful. To guarantee that the DDS is saved, specify the name of some other source file, library, or member.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The DDS source is not stored in the source file specified on the <b>To DDS source file (TOFILE)</b> parameter. The source is saved in the Q36DDSSRC source file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRCMBR</b></dt>
|
||
|
|
<dd>The first name specified on the <b>S/36 SFGR source member (SRCMBR)</b> parameter is used as the member name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DSPFILE</b></dt>
|
||
|
|
<dd>The display file name is used as the member name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the source file member in which to store the DDS source. If the member does not exist, it is added. If it already exists, it is replaced. If any terminating errors are encountered, the member is not added or changed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.HALT"></a>
|
||
|
|
<h3>Issue msg if error occurs (HALT)</h3>
|
||
|
|
<p>Specifies whether an error message is issued when an SFGR syntax error is detected.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The request ends with an error message.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The request ends with a diagnostic message and a return code of 1008 is set.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.DFRWRT"></a>
|
||
|
|
<h3>Defer write (DFRWRT)</h3>
|
||
|
|
<p>Specifies that data is not written to the display file until a read request is made. Control is returned to the requesting program immediately after the data is received for output. This may result in improved performance.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRCATR</u></b></dt>
|
||
|
|
<dd>The defer write option is taken from the DFRWRT attribute of the first source member. If there is no source member, or the DFRWRT source attribute has not been set, *YES is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>When the write request is made to the display file, control is returned after the buffer is processed. The actual display of the data may take place after a read or combined write/read operation is performed. The program buffer is immediately available for the next read or combined write/read operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>When the write request is made to the display file, control is not returned to the requesting program until the input/output request is completed including displaying the data and making input/output information available.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36DSPF.TGTRLS"></a>
|
||
|
|
<h3>Target Release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the release level of the operating system on which you intend to use the object being saved.
|
||
|
|
</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 restored to, and used on, the release of the operating system currently running on your system. The object can also be restored to a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The object is to be restored to the previous release with modification level 0 of the operating system. The object can also be restored to 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 restored to 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="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTS36DSPF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTS36DSPF DSPFILE(MYLIB/MYDISPLAY) OPTION(*CREATE)
|
||
|
|
SRCMBR(SFGRMBR1 SFGRMBR2)
|
||
|
|
SRCFILE(MYLIB/QS36SRC) GENOPT(*NOGEN)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command checks the SFGR source (producing a printer list named QPUTSFGR). No DDS is built, and the display file is not created.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTS36DSPF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>SSP4464</b></dt>
|
||
|
|
<dd>Member &3 in file &1 in use, cannot be shared.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5003</b></dt>
|
||
|
|
<dd>Source member &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5004</b></dt>
|
||
|
|
<dd>&1--This load member exists, but is not a $SFGR member.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5005</b></dt>
|
||
|
|
<dd>&1 display file already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5007</b></dt>
|
||
|
|
<dd>Source member &1 already given.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5009</b></dt>
|
||
|
|
<dd>Display file &1 not found in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5010</b></dt>
|
||
|
|
<dd>&1 not System/36 display file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5011</b></dt>
|
||
|
|
<dd>&1 not allowed for display file name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5012</b></dt>
|
||
|
|
<dd>Format &1 not found in display file
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5015</b></dt>
|
||
|
|
<dd>Source file library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5016</b></dt>
|
||
|
|
<dd>Display file library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5017</b></dt>
|
||
|
|
<dd>TOFILE library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5019</b></dt>
|
||
|
|
<dd>Terminating errors in $SFGR input specifications.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5027</b></dt>
|
||
|
|
<dd>TGTRLS(*PRV) allowed with changes only when existing display file created for previous release.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5451</b></dt>
|
||
|
|
<dd>Existing file &1 is not a display file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP6124</b></dt>
|
||
|
|
<dd>Unexpected error occurred.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP7375</b></dt>
|
||
|
|
<dd>Error &1 received by &2 utility.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP8663</b></dt>
|
||
|
|
<dd>User not authorized to access &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP8679</b></dt>
|
||
|
|
<dd>Not authorized to access member &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP9080</b></dt>
|
||
|
|
<dd>Object &1 in use; it cannot be shared.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36DSPF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|