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

156 lines
5.4 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 RouteD Attributes (CHGRTDA)</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="CHGRTDA.Top_Of_Page"></a>
<h2>Change RouteD Attributes (CHGRTDA)</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="#CHGRTDA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGRTDA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGRTDA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGRTDA"></a>
<p>The Change RouteD Attributes (CHGRTDA) command is used to change configurable Routing Information Protocol (RIP) server attributes. The changes take effect the next time the RouteD server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.
</p>
<p><b>Restrictions:</b>
</p>
<p>You must have *IOSYSCFG special authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRTDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGRTDA.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="#CHGRTDA.AUTOSTART"><b>AUTOSTART</b></a></td>
<td valign="top">Autostart</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGRTDA.SUPPLY"><b>SUPPLY</b></a></td>
<td valign="top">Supply</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="#CHGRTDA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGRTDA.AUTOSTART"></a>
<h3>Autostart (AUTOSTART)</h3>
<p>Specifies whether to automatically start the RouteD server when TCP/IP is started by the STRTCP command or STRTCPSVR SERVER(*AUTOSTART). When RouteD is started by the STRTCPSVR command, but the SERVER(*AUTOSTART) parameter is omitted, the AUTOSTART parameter is ignored and the RouteD server is started regardless of the value of this parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The AUTOSTART value does not change if it was previously set. Otherwise, it defaults to *NO.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not automatically start the RouteD server.
</dd>
<dt><b>*YES</b></dt>
<dd>Start the RouteD server automatically.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRTDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGRTDA.SUPPLY"></a>
<h3>Supply (SUPPLY)</h3>
<p>Specifies whether or not RouteD should supply routing information in RIP packets over the network interfaces.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The supply option that was previously set does not change; otherwise, *NO is used.
</dd>
<dt><b>*NO</b></dt>
<dd>The RouteD task receives and processes RIP packets normally, but does not supply periodic RIP broadcast packets over any of the attached network interfaces. This effectively puts the RouteD server into "listen mode."
</dd>
<dt><b>*YES</b></dt>
<dd>The RouteD task supplies periodic RIP broadcast packets to the attached networks. The supply of RIP packets over a particular interface may be overridden by an entry in the configuration file specifying that the supply over a particular interface is to be turned off.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRTDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGRTDA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Automatically Start the RouteD Server when the Start TCP/IP (STRTCP) CL Command is Issued.</b>
</p>
<p>
<pre>
CHGRTDA AUTOSTART(*YES)
</pre>
</p>
<p>This command indicates that the next time the STRTCP command is issued to start up TCP/IP and to automatically start the TCP/IP applications, the RouteD server will be automatically started.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRTDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGRTDA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF0011</b></dt>
<dd>Error detected by prompt override program.
</dd>
<dt><b>TCP5496</b></dt>
<dd>Error accessing configuration attributes member.
</dd>
<dt><b>TCP5497</b></dt>
<dd>File &amp;3, library &amp;2 not found.
</dd>
<dt><b>TCP8050</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
<dt><b>TCP9503</b></dt>
<dd>File &amp;3 in library &amp;2 not available.
</dd>
</dl>
<p><b><u>*STATUS Messages</u></b>
</p>
<dl>
<dt><b>CPF5001</b></dt>
<dd>End of file &amp;2 detected in library &amp;3.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGRTDA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>