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

163 lines
7.5 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 DHCP Attributes (CHGDHCPA)</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="CHGDHCPA.Top_Of_Page"></a>
<h2>Change DHCP Attributes (CHGDHCPA)</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="#CHGDHCPA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGDHCPA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGDHCPA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGDHCPA"></a>
<p>(CHGDHCPA) Use this command to set or change the DHCP Server Attributes: AUTOSTART and MODE
</p>
<p>The changes take effect the next time the DHCP server is started.
</p>
<p><b>Restriction:</b>
</p>
<p>You must have *IOSYSCFG special authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDHCPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDHCPA.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="#CHGDHCPA.AUTOSTART"><b>AUTOSTART</b></a></td>
<td valign="top">Autostart server</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDHCPA.MODE"><b>MODE</b></a></td>
<td valign="top">Mode</td>
<td valign="top">*SERVER, *RELAY, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGDHCPA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGDHCPA.AUTOSTART"></a>
<h3>Autostart server (AUTOSTART)</h3>
<p>The AUTOSTART attribute determines whether or not the DHCP server starts automatically when TCP/IP is started using the STRTCP command, or when the STRTCPSVR SERVER(*AUTOSTART) command is issued.
</p>
<p>This attribute is used by the STRTCPSVR command if STRTCPSVR *AUTOSTART is specified. STRTCPSVR *DHCP or STRTCPSVR *ALL will start the DHCP server regardless of the value of the AUTOSTART attribute. There is an exception:
</p>
<p>
<b>Note: </b>If the STRTCPSVR *ALL command is issued, all TCP/IP servers that have been configured will start. However, a BOOTP and DHCP server cannot both run on the same machine at the same time. If the STRTCPSVR *ALL command is issued, the system will first check to see if both a BOOTP and DHCP server job is configured. If both are configured the system will check the AUTOSTART attribute for each server.
</p>
<p>If one of the server (BOOTP or DHCP) AUTOSTART attributes is set to *YES and the other is set to *NO, the server with AUTOSTART attribute set to *YES will start.
</p>
<p>If both the BOOTP and DHCP AUTOSTART attributes are set to *NO, the DHCP server will start.
</p>
<p>You cannot set the DHCP AUTOSTART attribute to *YES if the BOOTP AUTOSTART value is set to *YES. A BOOTP and DHCP server cannot run simultaneously on the same machine. You will get an error message if you attempt to set both the BOOTP and DHCP AUTOSTART values to *YES.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>Specify *SAME if you do not want to change the AUTOSTART value from the previous setting. If you specify *SAME and this value was not previously set, the value *NO will be used.
</dd>
<dt><b>*YES</b></dt>
<dd>Specify a value of *YES if you want the DHCP server to start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR *AUTOSTART command.
</dd>
<dt><b>*NO</b></dt>
<dd>Specify *NO if you do not want the DHCP server to start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR *AUTOSTART command.
<p>When the value is set to *NO, only the STRTCPSVR *DHCP command or the STRTCPSVR *ALL command will start the DHCP server.
</p>
<p>If you do not intend to use the DHCP server, set AUTOSTART to *NO.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDHCPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDHCPA.MODE"></a>
<h3>Mode (MODE)</h3>
<p>The MODE attribute determines how the DHCP server will function. It can function as a DHCP server, or as a Relay agent only. A Relay Agent forwards BOOTP or DHCP packets from hosts to active BOOTP or DHCP servers and from the servers back to the hosts. It performs no BOOTP or DHCP server functions.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>Specify *SAME if you do not want to change the MODE value from the previous setting. If you specify *SAME and this value was not previously set, the value *SERVER will be used.
</dd>
<dt><b>*SERVER</b></dt>
<dd>Set this value to *SERVER if you want the DHCP server to automatically assign reusable IP addresses to hosts in response to host requests.
</dd>
<dt><b>*RELAY</b></dt>
<dd>Set this value to *RELAY if you want the DHCP server to function only as a Relay Agent. A Relay Agent forwards BOOTP or DHCP packets from hosts to active BOOTP or DHCP servers and from the servers back to the hosts. It performs no BOOTP or DHCP server functions.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDHCPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDHCPA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Start the DHCP Server automatically</b>
</p>
<p>
<pre>
CHGDHCPA 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 DHCP Server will be started automatically.
</p>
<p><b>Example 2: Have DHCP Function as a BOOTP/DHCP Relay Agent</b>
</p>
<p>
<pre>
CHGDHCPA AUTOSTART(*SAME) MODE(*RELAY)
</pre>
</p>
<p>This command indicates that the next time the DHCP Server gets started, it should function as a BOOTP/DHCP Relay Agent. It will no longer attempt to process DHCP packets on the local system, but will instead relay them. If DHCP is currently running, this command has no affect on its current execution mode, since CHGDHCPA attributes do not take affect until the next time the server is started. The autostart attribute is not changed.
</p>
<p><b>Example 3: Only allow DHCP Server to be Started Manually</b>
</p>
<p>
<pre>
CHGDHCPA AUTOSTART(*NO) MODE(*SERVER)
</pre>
</p>
<p>This command indicates that the DHCP Server should not be started automatically with the rest of TCP/IP when the STRTCP command is issued. It can only be started manually via the STRTCPSVR command. Via the MODE setting of *SERVER, this example is also causing the DHCP server to attempt to process all DHCP packets received on this system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDHCPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDHCPA.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDHCPA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>