237 lines
7.9 KiB
HTML
237 lines
7.9 KiB
HTML
|
|
||
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<title>Change Proxy Command (CHGPRXCMD)</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="CHGPRXCMD.Top_Of_Page"></a>
|
||
|
|
<h2>Change Proxy Command (CHGPRXCMD)</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="#CHGPRXCMD.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGPRXCMD.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGPRXCMD.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGPRXCMD"></a>
|
||
|
|
<p>The Change Proxy Command (CHGPRXCMD) command changes some of the attributes of a proxy command. Control Lanuage (CL) programs that use the proxy command being changed do <i>not</i> have to be created again. The CHGPRXCMD command does not change the target command definition object.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>You must have object management (*OBJMGT) authority for the command that is being changed.
|
||
|
|
</li>
|
||
|
|
<li>The CHGPRXCMD command can be used to change only the attributes that were specified on the Create Proxy Command (CRTPRXCMD) command.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGPRXCMD.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="#CHGPRXCMD.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="#CHGPRXCMD.TGTCMD"><b>TGTCMD</b></a></td>
|
||
|
|
<td valign="top">Target command</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, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Target 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, *SYSTEM, *NLVLIBL</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CHGPRXCMD.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, *TGTCMD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGPRXCMD.CMD"></a>
|
||
|
|
<h3>Command (CMD)</h3>
|
||
|
|
<p>Specifies the proxy command to be changed.
|
||
|
|
</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 proxy 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="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGPRXCMD.TGTCMD"></a>
|
||
|
|
<h3>Target command (TGTCMD)</h3>
|
||
|
|
<p>Specifies the target command for this proxy command. All parameters specified for the proxy command will be validated and processed using the specified target command.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The target command does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Target command</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the target command 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 command. If no library is specified as the current library for the job, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSTEM</b></dt>
|
||
|
|
<dd>Only the QSYS library is used to locate the command. If an exit program is registered for the QIBM_QCA_CHG_COMMAND exit point, the exit program will be allowed to change the command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NLVLIBL</b></dt>
|
||
|
|
<dd>Only the national language version (NLV) libraries in the library list and the QSYS library will be searched for the command. If an exit program is registered for the QIBM_QCA_CHG_COMMAND exit point, the exit program will be allowed to change the command.
|
||
|
|
</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="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGPRXCMD.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>*TGTCMD</b></dt>
|
||
|
|
<dd>The text description of the target command will be used as the text description of the proxy command. If the target command does not exist when this command is run, the text description of the proxy command will be the qualified name of the target command.
|
||
|
|
</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="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGPRXCMD.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGPRXCMD CMD(QGPL/WRKJOB) TGTCMD(QSYS/DSPJOB)
|
||
|
|
TEXT('Alias WRKJOB to DSPJOB')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The proxy command named WRKJOB in library QGPL is changed to use DSPJOB in QSYS as the target command. When the QGPL/WRKJOB command is run or prompted, the target command DSPJOB in the QSYS library will be used to process the WRKJOB command parameters.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGPRXCMD.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF6209</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6210</b></dt>
|
||
|
|
<dd>Command &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6211</b></dt>
|
||
|
|
<dd>Not authorized to change command &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6212</b></dt>
|
||
|
|
<dd>Command &1 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6213</b></dt>
|
||
|
|
<dd>Cannot allocate command &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6214</b></dt>
|
||
|
|
<dd>Errors detected while changing command &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6215</b></dt>
|
||
|
|
<dd>Command &1 in library &2 cannot be changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6216</b></dt>
|
||
|
|
<dd>Command &1 not valid for &2 command
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF6219</b></dt>
|
||
|
|
<dd>Not authorized to library &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGPRXCMD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|