173 lines
8.2 KiB
HTML
173 lines
8.2 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 DNS Server Attributes (CHGDNSA)</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="CHGDNSA.Top_Of_Page"></a>
|
|
<h2>Change DNS Server Attributes (CHGDNSA)</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="#CHGDNSA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGDNSA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGDNSA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGDNSA"></a>
|
|
<p>(CHGDNSA) Use this command to set or change the DNS Server Attributes: AUTOSTART and DBGLVL
|
|
</p>
|
|
<p>If multiple DNS servers are configured on the same system, you can specify whether you want the attributes changed for all of the configured DNS server instances, or just for a particular DNS server instance.
|
|
</p>
|
|
<p>The changes take effect the next time the DNS 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="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGDNSA.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="#CHGDNSA.DNSSVR"><b>DNSSVR</b></a></td>
|
|
<td valign="top">Server instance</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDNSA.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="#CHGDNSA.DBGLVL"><b>DBGLVL</b></a></td>
|
|
<td valign="top">Debug level</td>
|
|
<td valign="top">0-11, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGDNSA.DNSSVR"></a>
|
|
<h3>Server instance (DNSSVR)</h3>
|
|
<p>The DNS Server instance parameter determines which specific DNS server should have its attributes changed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If your system is configured to use the older BIND version 4 server, which does not support multiple server instances, only the default server instance value of *ALL is allowed. If you are interested in using the newest version of DNS which allows multiple instances with names, you should use Operations Navigator to see if it is possible to migrate your DNS configuration to the newest version.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specify *ALL if you want all of the DNS server instances that are currently configured on the system to have their attributes values changed to those specified in the other parameters of this command.
|
|
</dd>
|
|
<dt><b><i>server-instance-name</i></b></dt>
|
|
<dd>The specified DNS server instance will have its attributes values changed to those specified in the other parameters of this command.
|
|
<p><b>Note:</b> If you provide a <i>server-instance-name</i> when prompting on this command, the remaining attributes parameters will display the actual current values for the specified instance.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDNSA.AUTOSTART"></a>
|
|
<h3>Autostart server (AUTOSTART)</h3>
|
|
<p>The AUTOSTART attribute determines whether or not the DNS 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 only used by the STRTCPSVR command if STRTCPSVR *AUTOSTART is specified. STRTCPSVR *DNS or STRTCPSVR *ALL will start the DNS server regardless of the value of the AUTOSTART attribute.
|
|
</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 DNS 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 DNS 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 *DNS command or the STRTCPSVR *ALL command will start the DNS server.
|
|
</p>
|
|
<p>If you do not intend to use the DNS server, set AUTOSTART to *NO.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDNSA.DBGLVL"></a>
|
|
<h3>Debug level (DBGLVL)</h3>
|
|
<p>The debug level (DBGLVL) attribute determines how much diagnostic (debug) information the DNS server gathers and writes to a log file. The debug information is used by IBM Service and Development to assist you to solve DNS problems that you cannot solve.
|
|
</p>
|
|
<p>It is recommended that you normally run your DNS server with a DBGLVL value of 0. DBGLVL 0 means that the debug function is turned off and no debug information is logged.
|
|
</p>
|
|
<p>If you have a DNS problem that you cannot solve and an IBM service representative determines that debug information is needed to help solve the problem, the IBM representative will assist you to set the DBGLVL value.
|
|
</p>
|
|
<p>The default debug level is 0. As the numeric value increases from 1 to 11, the amount of debug information written to the DBGLVL log also increases. High DBGLVL values also cause the DNS server to take a greater amount of time to initialize.
|
|
</p>
|
|
<p>Debug information is written to an Integrated File System file. The name and location of the file depends on how DNS is configured on the system. The file continues to grow as long as the DNS server continues to run, and can use large amounts of disk storage space. Therefore, care should be taken to set this value back to 0 as soon as there is no further need for debug information.
|
|
</p>
|
|
<p>If the DBGLVL is changed for a DNS server that is already running, that DNS server will need to end and be started again for the new value to be used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The DBGLVL value does not change if it was previously set. Otherwise a value of 0 (debug off) is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>Use the default debug value of 0 (off).
|
|
</dd>
|
|
<dt><b><i>0-11</i></b></dt>
|
|
<dd>Specify a number within the range of 0-11 to specify how much diagnostic information you want the DNS server to log. The amount of debug information stored in the debug log increases as the DBGLVL value increases. 0 equals no debug information. 11 equals maximum debug information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDNSA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGDNSA 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 DNS server will be automatically started.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDNSA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDNSA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|