594 lines
23 KiB
HTML
594 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 S/36 Menu (CRTS36MNU)</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="CRTS36MNU.Top_Of_Page"></a>
|
||
|
|
<h2>Create S/36 Menu (CRTS36MNU)</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="#CRTS36MNU.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTS36MNU.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTS36MNU.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTS36MNU"></a>
|
||
|
|
<p>The Create System/36 Menu (CRTS36MNU) command creates a menu (display file and command message file) from your source members. You can specify that this menu be created either in a fixed-format, with options 1 through 24 arranged in two columns, or in free-format.
|
||
|
|
</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="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTS36MNU.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="#CRTS36MNU.CMDTXTMBR"><b>CMDTXTMBR</b></a></td>
|
||
|
|
<td valign="top">Command text source member##</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.OPTTXTMBR"><b>OPTTXTMBR</b></a></td>
|
||
|
|
<td valign="top">Option text source member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTS36MNU.CMDTXTSRC"><b>CMDTXTSRC</b></a></td>
|
||
|
|
<td valign="top">Command text source file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Command text 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" rowspan="3"><a href="#CRTS36MNU.OPTTXTSRC"><b>OPTTXTSRC</b></a></td>
|
||
|
|
<td valign="top">Option text 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: Option text 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>*CMDLIB</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.MNULIB"><b>MNULIB</b></a></td>
|
||
|
|
<td valign="top">Menu library (LOADLIB)</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*CMDLIB</u></b>, *CURLIB</td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.REPLACE"><b>REPLACE</b></a></td>
|
||
|
|
<td valign="top">Replace menu</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.FREEFORM"><b>FREEFORM</b></a></td>
|
||
|
|
<td valign="top">Free form menu</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.KEEP"><b>KEEP</b></a></td>
|
||
|
|
<td valign="top">Keep option text msg file</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.DDSLIST"><b>DDSLIST</b></a></td>
|
||
|
|
<td valign="top">DDS listing</td>
|
||
|
|
<td valign="top"><b><u>*PARTIAL</u></b>, *FULL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.MAXDEV"><b>MAXDEV</b></a></td>
|
||
|
|
<td valign="top">Maximum devices</td>
|
||
|
|
<td valign="top">1-256, <b><u>5</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.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" rowspan="3"><a href="#CRTS36MNU.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>*MNULIB</u></b>, *CMDLIB, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.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></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.IGCDTA"><b>IGCDTA</b></a></td>
|
||
|
|
<td valign="top">User specified DBCS data</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTS36MNU.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="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTS36MNU.CMDTXTMBR"></a>
|
||
|
|
<h3>Command text source member## (CMDTXTMBR)</h3>
|
||
|
|
<p>Specifies the source member that contains the System/36 message source that is used to create the command text message file. This message file defines the commands that are used when an option is selected. The message IDs must begin with USR.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>member-name-##</i></b></dt>
|
||
|
|
<dd>Specify the name of the source file member to use for the command text message file being created. The trailing ## symbols are required. The menu (display file) name is the same as the member name without the ## symbols.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The message file name specified within the source member must be the same as the source member name.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.OPTTXTMBR"></a>
|
||
|
|
<h3>Option text source file (OPTTXTMBR)</h3>
|
||
|
|
<p>Specifies the source member that is used to create the option text message file, or a screen format generator (SFGR) source member used to create the menu display file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The option text is taken from the command text message file. If OPTTXTMBR(*NONE) is specified, FREEFORM(*NO) must also be specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the source member to use for the descriptions of the options on the menu you are creating. The member can contain either the SFGR or the System/36 message source. A source member must be specified when *YES is specified on the <b>Free form menu (FREEFORM)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.CMDTXTSRC"></a>
|
||
|
|
<h3>Command text source file (CMDTXTSRC)</h3>
|
||
|
|
<p>Specifies the source file in which the command text member is located.
|
||
|
|
</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 that contains the member specified on the <b>Command text source member## (CMDTXTMBR)</b> parameter.
|
||
|
|
</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 file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.OPTTXTSRC"></a>
|
||
|
|
<h3>Option text source file (OPTTXTSRC)</h3>
|
||
|
|
<p>Specifies the name and library of the source file in which the option text member is located.
|
||
|
|
</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 that contains the member specified on the <b>Option text source member (OPTTXTMBR)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CMDLIB</u></b></dt>
|
||
|
|
<dd>The library specified on the <b>Command text source file (CMDTXTSRC)</b> parameter is used to locate the file.
|
||
|
|
</dd>
|
||
|
|
<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 file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.MNULIB"></a>
|
||
|
|
<h3>Menu library (LOADLIB) (MNULIB)</h3>
|
||
|
|
<p>Specifies the menu library that is used to store the created menu.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CMDLIB</u></b></dt>
|
||
|
|
<dd>The library specified on the <b>Command text source file (CMDTXTSRC)</b> parameter is used to store the file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to store 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 menu is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.REPLACE"></a>
|
||
|
|
<h3>Replace menu (REPLACE)</h3>
|
||
|
|
<p>Specifies whether an existing display file is replaced.
|
||
|
|
</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 by the one being created.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The menu is not created if it has the same name and library as an existing 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 AUT parameter is ignored, and the authorities for the old display file are copied to the new display file that replaces it.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.FREEFORM"></a>
|
||
|
|
<h3>Free form menu (FREEFORM)</h3>
|
||
|
|
<p>Specifies whether the menu is created in free-format or in a fixed-format.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Free-format is not used. The menu is created using a fixed-format with two-columns. The message number corresponds to the option number.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The menu is created using free-format. If *YES is specified, a value must be specified on the <b>Option text source member (OPTTXTMBR)</b> parameter. Option text message numbers correspond to the row numbers on the screen.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.KEEP"></a>
|
||
|
|
<h3>Keep option text msg file (KEEP)</h3>
|
||
|
|
<p>Specifies whether the option text message file is kept when the compilation is complete.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The option text message file is not kept.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The option text message file is kept. If the option text source member contains the screen format generator (SFGR) source and has the same name as the menu, then KEEP(*YES) is required.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.DDSLIST"></a>
|
||
|
|
<h3>DDS listing (DDSLIST)</h3>
|
||
|
|
<p>Specifies whether a partial or full DDS compile listing is provided.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PARTIAL</u></b></dt>
|
||
|
|
<dd>A partial listing is provided.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FULL</b></dt>
|
||
|
|
<dd>A full DDS listing and cross-reference are provided.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.MAXDEV"></a>
|
||
|
|
<h3>Maximum devices (MAXDEV)</h3>
|
||
|
|
<p>Specifies the maximum number of devices that can use the menu at one time.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>5</u></b></dt>
|
||
|
|
<dd>The maximum number of devices is five.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-devices</i></b></dt>
|
||
|
|
<dd>Specify the maximum number of devices. Valid values range from 1 through 256.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.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 <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.
|
||
|
|
</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="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.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 menu. The file need not already exist. If you are 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 in which to store the DDS source.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MNULIB</u></b></dt>
|
||
|
|
<dd>The menu library is used to locate the source file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CMDLIB</b></dt>
|
||
|
|
<dd>The command library is used to locate the source file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the source 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="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.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. 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.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.IGCDTA"></a>
|
||
|
|
<h3>User specified DBCS data (IGCDTA)</h3>
|
||
|
|
<p>Specifies whether the display file contains double-byte character data.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The display file contains no double-byte character data. Option text message IDs must begin with USR.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The display file or the message files contain double-byte character data. Option text message IDs may begin with USZ. To get the full benefit of this function, an IGC version of the operating system must be installed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTS36MNU.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="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTS36MNU.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTS36MNU CMDTXTMBR(MENU##) OPTTXTMBR(SFGRMBR)
|
||
|
|
CMDTXTSRC(MYLIB/QS36SRC) OPTTXTSRC(MYLIB/QS36SRC)
|
||
|
|
MNULIB(WORKLIB) REPLACE(*YES)
|
||
|
|
FREEFORM(*YES) KEEP(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a free format menu display from the specified SFGR source member, placing the resulting menu into library WORKLIB. Since the SFGR source is being used, FREEFORM(*YES) and KEEP(*YES) are required. The layout of the menu display is controlled by the format definition located in the SFGR source member. No special checking is done to ensure that the display file defined by this source is valid when used by the system as a menu.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTS36MNU.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>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>SSP5011</b></dt>
|
||
|
|
<dd>&1 not allowed for display file name.
|
||
|
|
</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>SSP5750</b></dt>
|
||
|
|
<dd>Command message file messages 1-24 contain only blank text.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5751</b></dt>
|
||
|
|
<dd>Command text message file name must end with ##.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5755</b></dt>
|
||
|
|
<dd>Unable to create $BMENU work file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5756</b></dt>
|
||
|
|
<dd>Command message file name must be longer than 2 characters.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5758</b></dt>
|
||
|
|
<dd>Command text source member &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5759</b></dt>
|
||
|
|
<dd>Option text source member &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5760</b></dt>
|
||
|
|
<dd>Command text message file has wrong name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5761</b></dt>
|
||
|
|
<dd>Option text message file has wrong name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5763</b></dt>
|
||
|
|
<dd>Option text member name should not be same as menu name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5766</b></dt>
|
||
|
|
<dd>Option text source library &1 was not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5767</b></dt>
|
||
|
|
<dd>Menu library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5768</b></dt>
|
||
|
|
<dd>Command text source library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5772</b></dt>
|
||
|
|
<dd>Option text source member required for free format menu.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SSP5773</b></dt>
|
||
|
|
<dd>Command and option text member names must not be the same.
|
||
|
|
</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="#CRTS36MNU.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|