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

924 lines
34 KiB
HTML
Raw Normal View History

Add readme and dist folders
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 Command (CHGCMD)</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="CHGCMD.Top_Of_Page"></a>
<h2>Change Command (CHGCMD)</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="#CHGCMD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCMD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCMD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCMD"></a>
<p>The Change Command (CHGCMD) command changes some of the attributes of a command definition. The command gives you the ability to specify a different command processing program to process the command. You can also change the type of operating environment (production, debug, or service) in which the command can be processed, and the text description of the command. CL programs that use the command being changed by the Change Command (CHGCMD) command do <i>not</i> have to be created again. The Change Command (CHGCMD) command does not change the parameter descriptions or validity checking information in the command definition object.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>The user must have object management authority for the command that is being changed.
</li>
<li>The CHGCMD command can be used to change only the attributes of a created CL command. That is, those attributes that were specified on the Create Command (CRTCMD) command. The CHGCMD command cannot be used to change attributes of <i>statements</i>, such as command definition statements.
</li>
<li>The CHGCMD command should not be used to change the command processing program (PGM parameter), the validity checking program (VLDCKR parameter), or the prompt override program (PMTOVRPGM parameter) of an IBM-supplied command.
</li>
<li>If the CHGCMD command is used to change the command processing program (PGM parameter), the validity checking program (VLDCKR parameter), or the prompt override program (PMTOVRPGM parameter), the threadsafe attribute of the command will be set to *NO. You must use the Create Command (CRTCMD) command to set the threadsafe attribute to *YES or *COND.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCMD.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="#CHGCMD.CMD"><b>CMD</b></a></td>
<td valign="top">Command</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Command</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="#CHGCMD.PGM"><b>PGM</b></a></td>
<td valign="top">Program to process command</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *REXX<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Program to process command</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="#CHGCMD.REXSRCFILE"><b>REXSRCFILE</b></a></td>
<td valign="top">REXX source 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: REXX source 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="#CHGCMD.REXSRCMBR"><b>REXSRCMBR</b></a></td>
<td valign="top">REXX source member</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *CMD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCMD.REXCMDENV"><b>REXCMDENV</b></a></td>
<td valign="top">REXX command environment</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *COMMAND, *CPICOMM, *EXECSQL<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: REXX command environment</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="5"><a href="#CHGCMD.REXEXITPGM"><b>REXEXITPGM</b></a></td>
<td valign="top">REXX exit programs</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 8 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Program</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Program</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top">Element 2: Exit code</td>
<td valign="top">
2, 3, 4, 5, 7, 8, 9, 10</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCMD.VLDCKR"><b>VLDCKR</b></a></td>
<td valign="top">Validity checking program</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Validity checking program</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="#CHGCMD.MODE"><b>MODE</b></a></td>
<td valign="top">Mode in which valid</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *ALL<br>Other values (up to 3 repetitions): *PROD, *DEBUG, *SERVICE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCMD.ALLOW"><b>ALLOW</b></a></td>
<td valign="top">Where allowed to run</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *ALL<br>Other values (up to 9 repetitions): *BATCH, *INTERACT, *BPGM, *IPGM, *BREXX, *IREXX, *EXEC, *BMOD, *IMOD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCMD.ALWLMTUSR"><b>ALWLMTUSR</b></a></td>
<td valign="top">Allow limited users</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCMD.HLPSHELF"><b>HLPSHELF</b></a></td>
<td valign="top">Help bookshelf</td>
<td valign="top"><i>Simple name</i>, <b><u>*SAME</u></b>, *LIST, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCMD.HLPPNLGRP"><b>HLPPNLGRP</b></a></td>
<td valign="top">Help panel group</td>
<td valign="top">Single values: *NONE, <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: Help 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>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CHGCMD.HLPID"><b>HLPID</b></a></td>
<td valign="top">Help identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *CMD, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCMD.HLPSCHIDX"><b>HLPSCHIDX</b></a></td>
<td valign="top">Help search index</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Help search index</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="#CHGCMD.CURLIB"><b>CURLIB</b></a></td>
<td valign="top">Current library</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NOCHG, *CRTDFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCMD.PRDLIB"><b>PRDLIB</b></a></td>
<td valign="top">Product library</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NOCHG, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCMD.PMTOVRPGM"><b>PMTOVRPGM</b></a></td>
<td valign="top">Prompt override program</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Prompt override program</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="#CHGCMD.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCMD.ENBGUI"><b>ENBGUI</b></a></td>
<td valign="top">Enable GUI</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCMD.CMD"></a>
<h3>Command (CMD)</h3>
<p>Specifies the command to be changed. The command can be either a user-defined command or an IBM-supplied command.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Command</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the command to be changed.
</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 command. 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 command is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.PGM"></a>
<h3>Program to process command (PGM)</h3>
<p>Specifies the command processing program (CPP) that is to be called to process the command.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current CPP does not change.
</dd>
<dt><b>*REXX</b></dt>
<dd>The CPP for this command is the REXX procedure identified on the <b>REXX source member (REXSRCMBR)</b> parameter.
</dd>
</dl>
<p><b>Qualifier 1: Program to process command</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the CPP that processes the command.
</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 name of the library where the program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.REXSRCFILE"></a>
<h3>REXX source file (REXSRCFILE)</h3>
<p>Specifies the source file containing the REXX procedure.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The REXX source file and library do not change.
</dd>
</dl>
<p><b>Qualifier 1: REXX source file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source file.
</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="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.REXSRCMBR"></a>
<h3>REXX source member (REXSRCMBR)</h3>
<p>Specifies the source member containing the REXX procedure that is the apparent command processing program (CPP).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The member name does not change.
</dd>
<dt><b>*CMD</b></dt>
<dd>The source member name is the same as the command name (the name specified on the CMD parameter).
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the source member containing the REXX procedure.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.REXCMDENV"></a>
<h3>REXX command environment (REXCMDENV)</h3>
<p>Specifies the command environment that is active when the REXX command processing program (CPP) starts to run. The REXX interpreter calls this program to process commands encountered in the procedure. This environment can be changed through the REXX ADDRESS instruction.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The command environment does not change.
</dd>
<dt><b>*COMMAND</b></dt>
<dd>The control language (CL) command environment is used.
</dd>
<dt><b>*CPICOMM</b></dt>
<dd>The Common Programming Interface (CPI) environment is used.
</dd>
<dt><b>*EXECSQL</b></dt>
<dd>The Structured Query Language (SQL) Command environment is used. EXECSQL is the command environment used for CL commands that are imbedded with in a SQL procedure.
</dd>
</dl>
<p><b>Qualifier 1: REXX command environment</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the program to be called to process commands in the REXX procedure.
</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 name of the library where the program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.REXEXITPGM"></a>
<h3>REXX exit programs (REXEXITPGM)</h3>
<p>Specifies the exit programs to be used when the REXX command processing program (CPP) is started. A maximum of eight program and exit code combinations can be specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The exit programs do not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There are no exit programs for the REXX CPP.
</dd>
</dl>
<p><b>Element 1: Program</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Qualifier 1: Program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the exit program.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<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 list 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 name of the library to be searched.
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: Exit code</b>
</p>
<dl>
<dt><b>2</b></dt>
<dd>The associated program is called whenever an external function or subroutine has been called by the REXX program. The exit program is then responsible for locating and calling the requested routine.
</dd>
<dt><b>3</b></dt>
<dd>The associated program is called whenever the interpreter is going to call a command. The exit program is responsible for locating and calling the command given the command string and the current environment name.
</dd>
<dt><b>4</b></dt>
<dd>The associated program is called whenever a REXX instruction or function attempts an operation on the REXX external data queue.
</dd>
<dt><b>5</b></dt>
<dd>The associated program is called when session input or output operations are attempted.
</dd>
<dt><b>7</b></dt>
<dd>The associated program is called after running each clause of the REXX procedure to determine whether it should be halted.
</dd>
<dt><b>8</b></dt>
<dd>The associated program is called after running each clause of the REXX program to check whether tracing should be turned on or off.
</dd>
<dt><b>9</b></dt>
<dd>The associated program is called before interpretation of the first instruction of a REXX procedure (including REXX procedures called as external functions and subroutines).
</dd>
<dt><b>10</b></dt>
<dd>The associated program is called after interpretation of the last instruction of a REXX procedure (including REXX procedures called as external functions and subroutines).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.VLDCKR"></a>
<h3>Validity checking program (VLDCKR)</h3>
<p>Specifies the program to be called to perform additional validity checking on the parameters in the command being processed. The validity checker is called to do additional user-defined validity checking beyond that specified by the command definition statements in the source file, and beyond the syntax checking that is done on the command when it is compiled.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no separate validity checking program for this command. All validity checking is done by the command analyzer and the command processing program. Whenever the command is processed or checked for validity, provided variables and expressions are not used.
</dd>
</dl>
<p><b>Qualifier 1: Validity checking program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name and library of the validity checking program that checks the validity of the command.
</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 name of the library where the validity checking program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.MODE"></a>
<h3>Mode in which valid (MODE)</h3>
<p>Specifies the types of operating environment in which the Change Command (CHGCMD) can be used. One or more of the modes can be specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The modes of operation in which the command can be used do not change.
</dd>
<dt><b>*ALL</b></dt>
<dd>The command is valid in all the types of modes: production, debug, and service.
</dd>
</dl>
<p><b>Other values (up to 3 repetitions)</b>
</p>
<dl>
<dt><b>*PROD</b></dt>
<dd>The command is valid for production mode operations.
</dd>
<dt><b>*DEBUG</b></dt>
<dd>The command is valid for debug mode operations.
</dd>
<dt><b>*SERVICE</b></dt>
<dd>The command is valid for service mode operations.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.ALLOW"></a>
<h3>Where allowed to run (ALLOW)</h3>
<p>Specifies where the command can be processed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The environment in which the command can be processed does not change.
</dd>
<dt><b>*ALL</b></dt>
<dd>The command can be processed in a batch input stream, in a CL program, in a REXX procedure, in a CL ILE module, or when processed interactively. It can also be passed to the system program QCMDEXC (or QCAEXEC) for processing.
</dd>
</dl>
<p><b>Other values (up to 9 repetitions)</b>
</p>
<dl>
<dt><b>*BATCH</b></dt>
<dd>The command can be processed in a batch input stream, external to a compiled CL program.
</dd>
<dt><b>*INTERACT</b></dt>
<dd>The command can be processed interactively, external to a compiled CL program.
</dd>
<dt><b>*BPGM</b></dt>
<dd>The command can be processed in a compiled CL program that is called from batch entry.
</dd>
<dt><b>*IPGM</b></dt>
<dd>The command can be processed in a compiled CL program that is called from interactive entry.
</dd>
<dt><b>*BREXX</b></dt>
<dd>The command can be used in a REXX procedure run in a batch job.
</dd>
<dt><b>*IREXX</b></dt>
<dd>The command can be used in a REXX procedure run in an interactive job.
</dd>
<dt><b>*BMOD</b></dt>
<dd>The command can be used in a batch CL ILE program only.
</dd>
<dt><b>*IMOD</b></dt>
<dd>The command can be used in a interactive CL ILE program only.
</dd>
<dt><b>*EXEC</b></dt>
<dd>The command can be used as a parameter on the CALL command and be passed as a character string to the system program QCMDEXC (or QCAEXEC) for processing. If *EXEC is specified, either *BATCH or *INTERACT must also be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.ALWLMTUSR"></a>
<h3>Allow limited users (ALWLMTUSR)</h3>
<p>Specifies whether the command can be entered from the command line on a menu by a user whose profile is set for limited capabilities (the LMTCPB keyword on the Create User Profile (CRTUSRPRF) and Change User Profile (CHGUSRPRF) commands).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The limited user authority does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>This command cannot be entered from the command line on a menu by a user whose profile is set for limited capabilities.
</dd>
<dt><b>*YES</b></dt>
<dd>This command can be entered from the command line on a menu by a user whose profile is set for limited capabilities.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.HLPSHELF"></a>
<h3>Help bookshelf (HLPSHELF)</h3>
<p>This parameter is no longer supported.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.HLPPNLGRP"></a>
<h3>Help panel group (HLPPNLGRP)</h3>
<p>Specifies the help panel group for this command.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The panel group does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No help panel group is specified.
</dd>
</dl>
<p><b>Qualifier 1: Help panel group</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the help panel group for this command.
</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 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="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.HLPID"></a>
<h3>Help identifier (HLPID)</h3>
<p>Specifies the root name for all help section identifiers for this command. All help sections in the help panel group associated with this command will begin with this name.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The help ID does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No help identifier is specified. *NONE is not allowed if a panel group name is specified for the <b>Help panel group (HLPPNLGRP)</b> parameter.
</dd>
</dl>
<dl>
<dt><b>*CMD</b></dt>
<dd>The name of the command is to be used as the root for help section identifiers in the help panel group.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the root name for the help section identifiers for this command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.HLPSCHIDX"></a>
<h3>Help search index (HLPSCHIDX)</h3>
<p>Specifies the help search index to use when the search index function key is pressed from the help screen.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No help search index is associated with this command.
</dd>
</dl>
<p><b>Qualifier 1: Help search index</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the search index to be used when the search index function key is pressed.
</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 search index. 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 search index is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.CURLIB"></a>
<h3>Current library (CURLIB)</h3>
<p>Specifies the name of the current library associated with the job being run.
</p>
<p>This library is also the current library when the validity checker program (if any) is processed for the command.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current library for the command does not change.
</dd>
<dt><b>*NOCHG</b></dt>
<dd>The current library is not changed for the processing of this command. If the current library is changed during processing of the command, the change remains in effect after command processing is complete.
</dd>
<dt><b>*CRTDFT</b></dt>
<dd>There is no current library active during processing of the command. The current library that was active before command processing is restored when processing is complete. If *CURLIB is specified as the to-value for any single values or special values for this command, or for any command processed while there is no current library active, the QGPL library is used as the current library. QGPL is used as the current library.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be used as the current library. The library need not exist when the command is created, but must exist when the command is processed. When command processing is completed, the current library is restored to its previous value. If the current library is changed during command processing by the Change Library List (CHGLIBL) command or Change Current Library (CHGCURLIB) command, the change is effective only until the command is processed. QTEMP cannot be specified for the current library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.PRDLIB"></a>
<h3>Product library (PRDLIB)</h3>
<p>Specifies the product library that is to be in effect during the processing of the command.
</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 menu started.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The product library for the command does not change.
</dd>
<dt><b>*NOCHG</b></dt>
<dd>The product library is not changed when processing of the command starts. If the product library is changed during the processing of the command, the change remains in effect after command processing is complete.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no product library in the job's library list. The product library is restored to its previous value when command processing is complete.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be used as the product library during command processing. The library need not exist when the command is created, but must exist when the command is processed. When command processing is completed, the product library is restored to its previous value. QTEMP cannot be specified for the product library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.PMTOVRPGM"></a>
<h3>Prompt override program (PMTOVRPGM)</h3>
<p>Specifies the prompt override program (POP) to be called to replace (on the prompt display) the default values with the current actual values specified for the parameter. If a POP is specified, the key parameters (specified as KEYPARM(*YES) on the PARM statement in the command definition source) are the only parameters visible on the initial prompt display. When values are input for the key parameters, the remaining parameters are shown on the display with the actual values instead of the default values.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The prompt override program does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No prompt override program is specified.
<p>
<b>Note: </b>If *NONE is specified when key parameters exist in the command definition source (when KEYPARM(*YES) is specified on the PARM statement), a warning message is issued when the command is created, and KEYPARM(*NO) is assumed for all parameters.
</p>
</dd>
</dl>
<p><b>Qualifier 1: Prompt override program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the prompt override program (POP).
</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 prompt override 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 name of the library where the prompt override program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text, if any, does not change.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify no more than 50 characters, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCMD.ENBGUI"></a>
<h3>Enable GUI (ENBGUI)</h3>
<p>Specifies whether the command prompt panels are enabled for conversion to a graphical user interface.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>The command prompt panels are not enabled for conversion to a graphical user interface.
</dd>
<dt><b>*YES</b></dt>
<dd>The command prompt panels are enabled for conversion to a graphical user interface by including information about the panel content in the 5250 data stream.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCMD.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGCMD CMD(PAYROLL) VLDCKR(LIB01/PAYVLDPGM)
</pre>
</p>
<p>The validity checking program for the PAYROLL command is the program named PAYVLDPGM located in library LIB01. All other attributes of the PAYROLL command remain the same.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCMD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF6209</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF6210</b></dt>
<dd>Command &amp;1 in library &amp;2 not found.
</dd>
<dt><b>CPF6211</b></dt>
<dd>Not authorized to change command &amp;1.
</dd>
<dt><b>CPF6212</b></dt>
<dd>Command &amp;1 not changed.
</dd>
<dt><b>CPF6213</b></dt>
<dd>Cannot allocate command &amp;1 in library &amp;2.
</dd>
<dt><b>CPF6214</b></dt>
<dd>Errors detected while changing command &amp;1.
</dd>
<dt><b>CPF6215</b></dt>
<dd>Command &amp;1 in library &amp;2 cannot be changed.
</dd>
<dt><b>CPF6216</b></dt>
<dd>Command &amp;1 not valid for &amp;2 command
</dd>
<dt><b>CPF6219</b></dt>
<dd>Not authorized to library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCMD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue Copy Permalink