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/crtpnlgrp.htm

442 lines
17 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 Panel Group (CRTPNLGRP)</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="CRTPNLGRP.Top_Of_Page"></a>
<h2>Create Panel Group (CRTPNLGRP)</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="#CRTPNLGRP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTPNLGRP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTPNLGRP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTPNLGRP"></a>
<p>The Create Panel Group (CRTPNLGRP) command creates panel groups that contain online help information, which can be shown in conjunction with your data description specifications (DDS) displays, CL commands, or a search index.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have read (*READ) and add (*ADD) authorities for the library where the panel group is to be created.
</li>
<li>If the panel group already exists, you must have object existence (*OBJEXIST), object management (*OBJMGT) and read (*READ) authorities for the panel group.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTPNLGRP.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="#CRTPNLGRP.PNLGRP"><b>PNLGRP</b></a></td>
<td valign="top">Panel group</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: Panel group</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#CRTPNLGRP.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>QPNLSRC</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="#CRTPNLGRP.SRCMBR"><b>SRCMBR</b></a></td>
<td valign="top">Source member</td>
<td valign="top"><i>Name</i>, <b><u>*PNLGRP</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPNLGRP.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="#CRTPNLGRP.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, Positional 4</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPNLGRP.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" rowspan="3"><a href="#CRTPNLGRP.CHRID"><b>CHRID</b></a></td>
<td valign="top">Character identifier</td>
<td valign="top">Single values: <b><u>*DEVD</u></b>, *SYSVAL, *JOBCCSID, *CHRIDCTL<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top"><a href="#CRTPNLGRP.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPNLGRP.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace panel group</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTPNLGRP.PNLGRP"></a>
<h3>Panel group (PNLGRP)</h3>
<p>Specifies the panel group to be created.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Panel group</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the panel group to be created.
</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 locate the panel group. 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 name of the library where the panel group is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.SRCFILE"></a>
<h3>Source file (SRCFILE)</h3>
<p>Specifies the source file that contains the panel group description source statements. Valid source file record length values range from 13 through 92.
</p>
<p><b>Qualifier 1: Source file</b>
</p>
<dl>
<dt><b><u>QPNLSRC</u></b></dt>
<dd>Source file QPNLSRC contains the panel group description source statements.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source file that contains the panel group 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, QGPL 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="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.SRCMBR"></a>
<h3>Source member (SRCMBR)</h3>
<p>Specifies the member of the source file that contains the panel group description.
</p>
<dl>
<dt><b><u>*PNLGRP</u></b></dt>
<dd>The member containing the panel group description has the same name as the name specified for the <b>Panel group (PNLGRP)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the member that contains the panel group description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the panel group.
</p>
<dl>
<dt><b><u>*SRCMBRTXT</u></b></dt>
<dd>The text associated with the specified source file member is used.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is used.
</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="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.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="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.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="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.CHRID"></a>
<h3>Character identifier (CHRID)</h3>
<p>Specifies whether character identifier (graphic character set and code page) of the dialog variables of the panel group is changed when the panel group is displayed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>No change occurs. The character identifier of the dialog variables and the panel group is the same as the character identifier of the device.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The character identifier of the dialog variables is changed to the default QCHRID system value for the device. The character identifier of the panel group is the same as the character identifier of the device.
</dd>
<dt><b>*JOBCCSID</b></dt>
<dd>The character identifier of the dialog variables is changed from the CCSID of the job to the character identifier of the device. The character identifier of panel group is changed from the CCSID of the source file on the SRCFILE 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 parameter for this panel group.
</dd>
</dl>
<p><b>Element 1: Graphic character set</b>
</p>
<dl>
<dt><b><i>integer</i></b></dt>
<dd>Specify the graphic character set to be used. Valid values range from 1 through 32767.
</dd>
</dl>
<p><b>Element 2: Code page</b>
</p>
<dl>
<dt><b><i>integer</i></b></dt>
<dd>Specify the code page to be used. Valid values range from 1 through 32767.
</dd>
</dl>
<p>
<b>Note: </b>Conversion may be necessary depending on the character identifier of the work station or printer.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.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="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPNLGRP.REPLACE"></a>
<h3>Replace (REPLACE)</h3>
<p>Specifies whether an existing panel group of the same name in the specified library is replaced.
</p>
<p>
<b>Note: </b>The panel group 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 panel group is replaced by moving it to the system library QRPLOBJ.
</dd>
<dt><b>*NO</b></dt>
<dd>The existing panel group is not replaced. If such a panel group exists, the create operation fails.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPNLGRP.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTPNLGRP PNLGRP(PAYLIB/PAYROLL)
SRCFILE(QPNLSRC) OPTION(*SECLVL)
</pre>
</p>
<p>This command creates a panel group named PAYROLL in library PAYLIB, uses source file QPNLSRC in the library list, and prints the second-level message text in the listing.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPNLGRP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF5A02</b></dt>
<dd>Panel group &amp;1 not created in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPNLGRP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink