ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgpdmdft.htm

501 lines
17 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change PDM Defaults (CHGPDMDFT)</title>
</head>
<body bgcolor="white">
<a name="CHGPDMDFT.Top_Of_Page"></a>
<h2>Change PDM Defaults (CHGPDMDFT)</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="#CHGPDMDFT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGPDMDFT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGPDMDFT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGPDMDFT"></a>
<p>The Change PDM Defaults (CHGPDMDFT) command enables you to assign Programming Development Manager (PDM) defaults for a specific user. The function is similar to the Change Defaults panel shown when F18 is pressed when using PDM, except that this command can be used to change the PDM defaults for another user and can be run in batch.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have object management (*OBJMGT) and use (*USE) authorities to the user profile of the user whose PDM defaults are being changed.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGPDMDFT.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="#CHGPDMDFT.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Simple name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.OBJLIB"><b>OBJLIB</b></a></td>
<td valign="top">Object library</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *SRCLIB, *CURLIB</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.RPLOBJ"><b>RPLOBJ</b></a></td>
<td valign="top">Replace object</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.CRTBCH"><b>CRTBCH</b></a></td>
<td valign="top"> Create/compile in batch</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.RUNBCH"><b>RUNBCH</b></a></td>
<td valign="top">Run in batch</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.SAVRSTOPT"><b>SAVRSTOPT</b></a></td>
<td valign="top">Save/restore option</td>
<td valign="top"><b><u>*SAME</u></b>, *SINGLE, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGPDMDFT.JOBD"><b>JOBD</b></a></td>
<td valign="top">Job description</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *USRPRF<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job description</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="#CHGPDMDFT.CHGTYPTXT"><b>CHGTYPTXT</b></a></td>
<td valign="top">Change type and text</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGPDMDFT.FILE"><b>FILE</b></a></td>
<td valign="top">Option file</td>
<td valign="top">Single values: <b><u>*SAME</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: Option 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="#CHGPDMDFT.MBR"><b>MBR</b></a></td>
<td valign="top">Option file member</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.FULLSCN"><b>FULLSCN</b></a></td>
<td valign="top">Full screen mode</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.LOGCOM"><b>LOGCOM</b></a></td>
<td valign="top">Log option commands</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.EXITENT"><b>EXITENT</b></a></td>
<td valign="top">Exit lists on ENTER</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPDMDFT.DSPINFMSG"><b>DSPINFMSG</b></a></td>
<td valign="top">Display informational messages</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGPDMDFT.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the user whose PDM defaults are to be changed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>simple-name</i></b></dt>
<dd>Specify the name of the user whose default values are to be changed. A user profile with the specified name must exist on the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.OBJLIB"></a>
<h3>Object library (OBJLIB)</h3>
<p>Specifies the library where objects created by compiling source file members (from the Work with Members Using PDM display) are to be stored.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *SRCLIB is used.
</dd>
<dt><b>*SRCLIB</b></dt>
<dd>Use the library in which the source member exists as the object library.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library as the object library. If no current library is defined, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where objects resulting from compilation of source file members are to be stored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.RPLOBJ"></a>
<h3>Replace object (RPLOBJ)</h3>
<p>Specifies if the existing object is deleted and replaced with the new object created when compiling a member or creating a module.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *NO is used.
</dd>
<dt><b>*NO</b></dt>
<dd>The existing object is not deleted before starting to compile a member or create a module. If the object exists, the Confirm Member Compile display appears.
</dd>
<dt><b>*YES</b></dt>
<dd>The existing object is deleted before starting to compile a member or create a module. If the compilation fails, the object is not restored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.CRTBCH"></a>
<h3>Create/compile in batch (CRTBCH)</h3>
<p>Specifies whether to submit a job to batch when compiling members or creating modules.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *YES is used.
</dd>
<dt><b>*YES</b></dt>
<dd>Compile members or create modules in batch.
</dd>
<dt><b>*NO</b></dt>
<dd>Compile members or create modules interactively.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.RUNBCH"></a>
<h3>Run in batch (RUNBCH)</h3>
<p>Specifies whether to submit a job to batch when running objects.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *NO is used.
</dd>
<dt><b>*NO</b></dt>
<dd>Objects do not run in batch.
</dd>
<dt><b>*YES</b></dt>
<dd>Objects run in batch.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.SAVRSTOPT"></a>
<h3>Save/restore option (SAVRSTOPT)</h3>
<p>Specifies whether to save or restore objects and members individually or with one command.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *SINGLE is used.
</dd>
<dt><b>*SINGLE</b></dt>
<dd>Save or restore the selected objects or members individually, each with its own separate command.
</dd>
<dt><b>*ALL</b></dt>
<dd>Save or restore the selected objects or members all at the same time with one command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the name of the job description for submitting a job in batch mode.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *LIBL/QBATCH is used.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The job description defined in the user profile of the user specified for the <b>User (USER)</b> parameter is used.
</dd>
</dl>
<p><b>Qualifier 1: Job description</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job description 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 job library list will be searched for the specified job description.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job will be searched for the specified job description. If no current library is defined, QGPL is used as the current library.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched for the specified job description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.CHGTYPTXT"></a>
<h3>Change type and text (CHGTYPTXT)</h3>
<p>Specifies if the <b>Type</b> and <b>Text</b> prompts can be changed by typing over them on the Work with Members Using PDM display.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *YES is used.
</dd>
<dt><b>*YES</b></dt>
<dd>The <b>Type</b> and <b>Text</b> prompts can be changed by typing over them on the Work with Members Using PDM display.
</dd>
<dt><b>*NO</b></dt>
<dd>The <b>Type</b> and <b>Text</b> prompts cannot be changed by typing over them on the Work with Members Using PDM display.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.FILE"></a>
<h3>Option file (FILE)</h3>
<p>Specifies the file that contains the member with the user-defined options. The user-defined options in this file are the active user-defined options. The user-defined option file has a particular format. For more information on this format and how to copy a user-defined options file, refer to the AS/400 Programming Development Manager User's Guide and Reference.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise FILE(*LIBL/QAUOOPT) is used.
</dd>
</dl>
<p><b>Qualifier 1: Option file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of active user-defined options file.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job library list will be searched for the active user-defined options file.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job will be searched for the active user-defined options file. If no current library is defined, QGPL is used as the current library.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched for the active user-defined options file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.MBR"></a>
<h3>Option file member (MBR)</h3>
<p>Specifies the member that contains the user-defined options. The user-defined options in this member are the active user-defined options.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise QAUOOPT is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the member that contains the user-defined options.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.FULLSCN"></a>
<h3>Full screen mode (FULLSCN)</h3>
<p>Specifies whether the options and function keys are shown on the Work With displays. This option does not apply to the Work with User-Defined Options display.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *NO is used.
</dd>
<dt><b>*NO</b></dt>
<dd>Options and function keys are shown on the Work With displays.
</dd>
<dt><b>*YES</b></dt>
<dd>Options and function keys are not shown on the Work With displays.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.LOGCOM"></a>
<h3>Log option commands (LOGCOM)</h3>
<p>Specifies whether commands resulting from PDM options or user-defined options are logged to the job log.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *NO is used.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not log commands resulting from PDM options or user-defined options.
</dd>
<dt><b>*YES</b></dt>
<dd>Log commands resulting from PDM options or user-defined options.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.EXITENT"></a>
<h3>Exit lists on ENTER (EXITENT)</h3>
<p>Specifies whether the user can exit list panels with the ENTER key. List panels include Library, Object, Member, User-Defined Options.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *NO is used.
</dd>
<dt><b>*NO</b></dt>
<dd>The user cannot exit list panels with the ENTER key.
</dd>
<dt><b>*YES</b></dt>
<dd>The user can exit list panels with the ENTER key.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPDMDFT.DSPINFMSG"></a>
<h3>Display informational messages (DSPINFMSG)</h3>
<p>Specifies if the informational message about the new tools (RSE and CODE) is displayed or not.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>If this parameter was previously set, the value does not change; otherwise *YES is used.
</dd>
<dt><b>*YES</b></dt>
<dd>The informational message is displayed.
</dd>
<dt><b>*NO</b></dt>
<dd>The informational message is not displayed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGPDMDFT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Set Defaults for New PDM User</b>
</p>
<p>
<pre>
CHGPDMDFT USER(USER2)
</pre>
</p>
<p>This command sets the PDM defaults if USER2 is a new PDM user. If the defaults were already set, they are not changed.
</p>
<p><b>Example 2: Change Defaults for Existing PDM User</b>
</p>
<p>
<pre>
CHGPDMDFT USER(USER2) CRTBCH(*NO)
RUNBCH(*YES)
</pre>
</p>
<p>This command changes the PDM default for the existing PDM user USER2, so that program compiles and modules creation are done interactively, and objects run are done in batch.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGPDMDFT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>PDM0004</b></dt>
<dd>Library &amp;1 was not found.
</dd>
<dt><b>PDM0010</b></dt>
<dd>Library name &amp;1 is invalid.
</dd>
<dt><b>CPF0001</b></dt>
<dd>Error found on &amp;1 command.
</dd>
<dt><b>CPF2204</b></dt>
<dd>User profile &amp;1 not found.
</dd>
<dt><b>CPF2209</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF2228</b></dt>
<dd>Not authorized to change user profile.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPDMDFT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>