friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crtmnu.htm

709 lines
26 KiB
HTML
Raw Blame History

<!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 Menu (CRTMNU)</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="CRTMNU.Top_Of_Page"></a>
<h2>Create Menu (CRTMNU)</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="#CRTMNU.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTMNU.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTMNU.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTMNU"></a>
<p>The Create Menu (CRTMNU) command is used to create a menu object. Both Display File (*DSPF) and Program (*PGM) menus can be created by using this command. A menu can be displayed using the Go to Menu (GO) command.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have change (*CHANGE), read (*READ), and add (*ADD) authorities for the library where the menu is to be created.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTMNU.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="#CRTMNU.MENU"><b>MENU</b></a></td>
<td valign="top">Menu</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: Menu</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="#CRTMNU.TYPE"><b>TYPE</b></a></td>
<td valign="top">Menu type</td>
<td valign="top">*DSPF, *PGM, *UIM</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTMNU.DSPF"><b>DSPF</b></a></td>
<td valign="top">Display 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: Display file</td>
<td valign="top"><i>Name</i>, <b><u>*MENU</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" rowspan="3"><a href="#CRTMNU.MSGF"><b>MSGF</b></a></td>
<td valign="top">Message 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: Message file</td>
<td valign="top"><i>Name</i>, <b><u>*MENU</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="#CRTMNU.CMDLIN"><b>CMDLIN</b></a></td>
<td valign="top">Command line</td>
<td valign="top"><b><u>*LONG</u></b>, *SHORT, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTMNU.DSPKEY"><b>DSPKEY</b></a></td>
<td valign="top">Display function keys</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTMNU.PGM"><b>PGM</b></a></td>
<td valign="top">Program</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Program</td>
<td valign="top"><i>Name</i>, <b><u>*MENU</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" rowspan="3"><a href="#CRTMNU.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</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Source file</td>
<td valign="top"><i>Name</i>, <b><u>QMNUSRC</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: </td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CRTMNU.SRCMBR"><b>SRCMBR</b></a></td>
<td valign="top">Source member</td>
<td valign="top"><i>Name</i>, <b><u>*MENU</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTMNU.OPTION"><b>OPTION</b></a></td>
<td valign="top">Source listing options</td>
<td valign="top">Values (up to 3 repetitions): *SOURCE, *NOSOURCE, *SRC, *NOSRC, *NOSECLVL, *SECLVL, *NOEVENTF, *EVENTF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTMNU.INCFILE"><b>INCFILE</b></a></td>
<td valign="top">Include file</td>
<td valign="top">Single values: <b><u>*SRCFILE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Include 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>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CRTMNU.CURLIB"><b>CURLIB</b></a></td>
<td valign="top">Current library</td>
<td valign="top"><i>Name</i>, <b><u>*NOCHG</u></b>, *MNULIB, *CRTDFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTMNU.PRDLIB"><b>PRDLIB</b></a></td>
<td valign="top">Product library</td>
<td valign="top"><i>Name</i>, <b><u>*NOCHG</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTMNU.CHRID"><b>CHRID</b></a></td>
<td valign="top">Character identifier</td>
<td valign="top"><i>Integer</i>, <b><u>*DEVD</u></b>, *JOBCCSID, *CHRIDCTL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTMNU.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace menu</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTMNU.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="#CRTMNU.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTMNU.MENU"></a>
<h3>Menu (MENU)</h3>
<p>Specifies the menu to be created.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Menu</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the menu.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The current library for the job is used to store the new menu. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the menu is to be stored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.TYPE"></a>
<h3>Menu type (TYPE)</h3>
<p>Specifies the type of menu to be created.
</p>
<p>
<b>Note: </b>*DSPF must be specified for values to be specified for the <b>Display file (DSPF)</b> and <b>Message file (MSGF)</b> parameters. The <b>Program (PGM)</b> parameter is valid only if *PGM is specified here.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*DSPF</b></dt>
<dd>An existing display file and message file are used to create a menu.
</dd>
<dt><b>*PGM</b></dt>
<dd>The menu being created calls a program when the menu is requested.
</dd>
<dt><b>*UIM</b></dt>
<dd>The menu is created using the UIM tag language found in the file specified for the <b>Source file (SRCFILE)</b> and <b>Source member (SRCMBR)</b> parameters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.DSPF"></a>
<h3>Display file (DSPF)</h3>
<p>Specifies the display file to be used in creating the menu object. The display file must include one record format with the same name as the display file itself, called the menu format. Help formats may also be included in the file.
</p>
<p>Help formats follow the naming convention #Hxxyy, where xx is the first and yy is the last menu option to which the help format applies. For example, #H0306 would apply to menu options 3 to 6. #H0000 designates the general help for the menu.
</p>
<p>The display file must have a separate indicator area (INDARA keyword) and contain no subfile descriptions.
</p>
<p>This parameter can be specified only if *DSPF is specified for the <b>Menu type (TYPE)</b> parameter.
</p>
<p><b>Qualifier 1: Display file</b>
</p>
<dl>
<dt><b><u>*MENU</u></b></dt>
<dd>The display file has the same name as the menu name specified for the <b>Menu (MENU)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the display file to be used.
</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 job is used to locate the display file. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the display file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.MSGF"></a>
<h3>Message file (MSGF)</h3>
<p>Specifies the message file containing the commands to run when a menu option is selected. The MSGIDs of the messages in this file are of the form USRxxxx where xxxx is the menu option number typed on the command line.
</p>
<p>
<b>Note: </b>If the message file being created is to be used for menus, you must add message file members to the file using the Add Message Description (ADDMSGD) command.
</p>
<p><b>Qualifier 1: Message file</b>
</p>
<dl>
<dt><b><u>*MENU</u></b></dt>
<dd>The message file containing the commands to run has the same name as the menu name specified for the <b>Menu (MENU)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the message file to be used.
</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 job is used to locate the message file. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the message file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.CMDLIN"></a>
<h3>Command line (CMDLIN)</h3>
<p>Specifies whether a long command line, a short command line, or no command line (an option line) is used.
</p>
<dl>
<dt><b><u>*LONG</u></b></dt>
<dd>A 153-byte long command line is used.
</dd>
<dt><b>*SHORT</b></dt>
<dd>A 73-byte long command line is used.
</dd>
<dt><b>*NONE</b></dt>
<dd>No command line is used. A 4-byte option line is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.DSPKEY"></a>
<h3>Display function keys (DSPKEY)</h3>
<p>Specifies whether the function key legend appears at the bottom of the menu when the menu is shown.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The function key legend is not shown at the bottom of the display.
</dd>
<dt><b>*YES</b></dt>
<dd>The function key legend is shown at the bottom of the display.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.PGM"></a>
<h3>Program (PGM)</h3>
<p>Specifies the program to call when the menu is shown.
</p>
<p>Three parameters are passed to the program:
</p>
<ul>
<li>The first parameter is the ten-character name of the menu object which identifies the program to call.
</li>
<li>The second parameter is the ten-character name of the library containing the menu object.
</li>
<li>The third parameter is a two-character binary return code declared as a variable in the called program. The program must set one of the following return codes:
</li>
</ul>
<p>
<pre>
Return
Code Hex Description
0 0000 Call the program
(display the menu) again
-1 FFFF Exit function requested
-2 FFFE Previous function requested
-4 FFFC Home function requested
(display the home menu)
</pre>
</p>
<p><b>Qualifier 1: Program</b>
</p>
<dl>
<dt><b><u>*MENU</u></b></dt>
<dd>The program called has the same name as the menu name specified for the <b>Menu (MENU)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the program to be called.
</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 job is used to locate the program. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.SRCFILE"></a>
<h3>Source file (SRCFILE)</h3>
<p>Specifies the source file containing the menu description source statements.
</p>
<p><b>Qualifier 1: Source file</b>
</p>
<dl>
<dt><b><u>QMNUSRC</u></b></dt>
<dd>The source file QMNUSRC contains the menu description source statements.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source file containing the menu description source statements.
</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 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>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="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.SRCMBR"></a>
<h3>Source member (SRCMBR)</h3>
<p>Specifies the member of the source file containing the menu description.
</p>
<dl>
<dt><b><u>*MENU</u></b></dt>
<dd>The member name is the same as the menu name specified for the <b>Menu (MENU)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source file member containing the menu description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.OPTION"></a>
<h3>Source listing options (OPTION)</h3>
<p>Specifies options for the output produced during the compile. 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 similar to, but not actually 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>A source listing is produced.
</dd>
<dt><b>*NOSRC or *NOSOURCE</b></dt>
<dd>No source listing is produced unless errors are detected.
</dd>
</dl>
<p><b>Second-Level Message Text Option</b>
</p>
<dl>
<dt><b><u>*NOSECLVL</u></b></dt>
<dd>Second-level text is not provided with the first-level text when the messages are printed at the end of the listing.
</dd>
<dt><b>*SECLVL</b></dt>
<dd>Second-level text is provided with the first-level text when the messages are printed at the end of the listing.
</dd>
</dl>
<p><b>Event File Creation Option</b>
</p>
<dl>
<dt><b><u>*NOEVENTF</u></b></dt>
<dd>The compiler does not produce an event file for the CoOperative Development Environment for iSeries (CODE for iSeries).
</dd>
<dt><b>*EVENTF</b></dt>
<dd>The compiler produces an event file that can be used by the CODE for iSeries product. The event file is created as a member in the file EVFEVENT in your object library. The CODE for iSeries product uses this file to offer error feedback integrated with the CODE for iSeries editor. This value is normally specified by the CODE for iSeries product on your behalf.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.INCFILE"></a>
<h3>Include file (INCFILE)</h3>
<p>Specifies the source file containing the members to be included.
</p>
<p>
<b>Note: </b>If the coded character set identifier (CCSID) of the source file is different than the CCSID of the primary source file specified for the <b>Source file (SRCFILE)</b> parameter, the CCSID is changed to the CCSID of the primary source file. The CCSID must be the same for all source members used to create the object.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SRCFILE</u></b></dt>
<dd>The include file is the same file as the file specified for the SRCFILE parameter.
</dd>
</dl>
<p><b>Qualifier 1: Include file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source file containing the members to be included.
</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 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>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="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.CURLIB"></a>
<h3>Current library (CURLIB)</h3>
<p>Specifies the library used as the current library when menu is shown.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The current library does not change for the processing of this menu.
</dd>
<dt><b>*MNULIB</b></dt>
<dd>The current library is changed to the library containing the menu while the menu is shown.
</dd>
<dt><b>*CRTDFT</b></dt>
<dd>There is no current library when the menu is shown.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library name used as the current library when the menu is shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.PRDLIB"></a>
<h3>Product library (PRDLIB)</h3>
<p>Specifies the library used as the product library when the menu is shown.
</p>
<p>
<b>Note: </b>The product library for a command or menu remains in the library list while a command or menu is active, unless another command or menu changes the product library. When a command or menu that changed the product library ends, the product library is restored to what it was when the command or library started.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The product library is not changed when the menu is shown and is not restored after exiting the menu.
</dd>
<dt><b>*NONE</b></dt>
<dd>The product library entry in the library list is not used while the menu is shown.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library name used as the product library when the menu is shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.CHRID"></a>
<h3>Character identifier (CHRID)</h3>
<p>Specifies whether the character identifier (graphic character set and code page) of the menu object is changed to the character identifier of the device when the menu is displayed.
</p>
<p>
<b>Note: </b>This parameter can be specified only if *UIM is specified for the <b>Menu type (TYPE)</b> parameter.
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>No change occurs. The character identifier of the menu object is the same as the character identifier of the device.
</dd>
<dt><b>*JOBCCSID</b></dt>
<dd>The character identifier of the menu object is changed from the CCSID of the file specified for the <b>Source file (SRCFILE)</b> parameter to the character identifier of the device.
</dd>
<dt><b>*CHRIDCTL</b></dt>
<dd>The system checks the CHRIDCTL job attribute to determine whether to use *JOBCCSID or *DEVD on the CHRID command parameter for this menu.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.REPLACE"></a>
<h3>Replace menu (REPLACE)</h3>
<p>Specifies whether an existing menu with the same name is replaced.
</p>
<p>
<b>Note: </b>The menu cannot be replaced if it is in use by this job or another job.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The existing menu is moved to the system library QRPLOBJ and replaced with the new menu.
</dd>
<dt><b>*NO</b></dt>
<dd>The existing menu is not replaced with the new menu.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the descriptive text associated with the menu.
</p>
<dl>
<dt><b><u>*SRCMBRTXT</u></b></dt>
<dd>The text for the menu is obtained from the text associated with the source file member. Please note that this special value will only retrieve the text from the source file member if the menu is a *UIM type. For other menu types, the text will be set to blanks.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text description is given for the menu.
</dd>
<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="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTMNU.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have 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 command (CRTLIB) 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>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTMNU.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTMNU MENU(ARLIB/ARPERS) TYPE(*PGM)
</pre>
</p>
<p>This command creates a menu named ARPERS in library ARLIB. The menu calls a program (also named ARPERS) when the menu is run.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTMNU.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF6AC3</b></dt>
<dd>Menu not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTMNU.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink