176 lines
6.9 KiB
HTML
176 lines
6.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 REXEC Attributes (CHGRXCA)</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="CHGRXCA.Top_Of_Page"></a>
|
|
<h2>Change REXEC Attributes (CHGRXCA)</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="#CHGRXCA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGRXCA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGRXCA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGRXCA"></a>
|
|
<p>The Change REXEC Attributes (CHGRXCA) command changes the configuration of the TCP/IP Remote Execution (REXEC) servers. You can change REXEC attributes when REXEC servers are active. Changes take effect the next time an REXEC server connection is made. Existing connections are not changed, but keep the attributes they had when the connection was established.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGRXCA.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="#CHGRXCA.AUTOSTART"><b>AUTOSTART</b></a></td>
|
|
<td valign="top">Autostart servers</td>
|
|
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGRXCA.NBRSVR"><b>NBRSVR</b></a></td>
|
|
<td valign="top">Number of initial servers</td>
|
|
<td valign="top">1-20, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGRXCA.INACTTIMO"><b>INACTTIMO</b></a></td>
|
|
<td valign="top">Inactivity timeout</td>
|
|
<td valign="top">1-2147483647, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGRXCA.CCSID"><b>CCSID</b></a></td>
|
|
<td valign="top">Coded character set identifier</td>
|
|
<td valign="top">1-65533, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGRXCA.AUTOSTART"></a>
|
|
<h3>Autostart servers (AUTOSTART)</h3>
|
|
<p>Specifies whether to automatically start the REXEC servers when TCP/IP is started by the Start TCP/IP (STRTCP) command or STRTCPSVR SERVER(*AUTOSTART) command. When REXEC is started by the Start TCP/IP Server (STRTCPSVR) command, and SERVER(*AUTOSTART) is omitted, this parameter is ignored and the number of servers defined is started regardless of the value of this parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The autostart value that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not start the number of servers defined in the NBRSVR parameter when the STRTCP command is called. If you do not plan to use REXEC, set AUTOSTART to *NO.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Start the number of servers defined in the NBRSVR parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGRXCA.NBRSVR"></a>
|
|
<h3>Number of initial servers (NBRSVR)</h3>
|
|
<p>Specifies the minimum number of REXEC servers to start initially when REXEC is started by either the Start TCP/IP (STRTCP) or Start TCP/IP Server (STRTCPSVR) commands. These servers allow new clients to connect to the server without having to wait for the overhead associated with starting a new server.
|
|
</p>
|
|
<p>*SAME The number of servers that was previously set does not change; otherwise, *DFT is used.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of servers is set to the default value of 2.
|
|
</dd>
|
|
<dt><b><i>number-of-servers</i></b></dt>
|
|
<dd>The number of servers requested to start. Valid values range from 1 through 20 servers.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGRXCA.INACTTIMO"></a>
|
|
<h3>Inactivity timeout (INACTTIMO)</h3>
|
|
<p>Specifies the number of seconds of inactivity between the client and server jobs before the server assumes the client has stopped communicating and disconnects the client. When this event occurs, the server does not run any command for the client user.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The time-out value does not change if it was previously set; otherwise, *DFT is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The time-out value is set to the default of 300 seconds (5 minutes).
|
|
</dd>
|
|
<dt><b><i>inactive-timeout</i></b></dt>
|
|
<dd>Specify an inactive time-out period in seconds. Valid values range from 1 through 2147483647 ((2**31)-1) seconds.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGRXCA.CCSID"></a>
|
|
<h3>Coded character set identifier (CCSID)</h3>
|
|
<p>Specifies the ASCII coded-character set identifier (CCSID) that is used for conversion of data received from and sent to the REXEC client.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The CCSID value that was previously set does not change; otherwise, *DFT is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The CCSID value is chosen to be the related default single-byte PC ASCII equivalent of the CCSID specified by the QCCSID system value (or, if the QCCSID system value is 65535, the ASCII equivalent of the default CCSID associated with the language specified by the QLANGID system value).
|
|
</dd>
|
|
<dt><b><i>CCSID-value</i></b></dt>
|
|
<dd>The requested CCSID value is used. This value is validated to ensure that a valid ASCII CCSID has been requested.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGRXCA.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGRXCA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP8050</b></dt>
|
|
<dd>*IOSYSCFG authority required to use &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGRXCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|