| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change DNS Server Attributes (CHGDNSA) command can be used to set or change the Domain Name System (DNS) server attributes.
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.
The changes take effect the next time the DNS server is started.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DNSSVR | Server instance | Character value, *ALL | Optional, Key, Positional 1 |
| AUTOSTART | Autostart server | *SAME, *YES, *NO | Optional |
| DBGLVL | Debug level | 0-11, *SAME, *DFT | Optional |
| Top |
Specifies which DNS server should have its attributes changed.
| Top |
Specifies whether or not the DNS server starts automatically when TCP/IP is started when the Start TCP/IP (STRTCP) command is run or the Start TCP/IP Server (STRTCPSVR) command is run with SERVER(*AUTOSTART) specified.
If the STRTCPSVR command is run with SERVER(*DNS) or SERVER(*ALL) specified, the DNS server will be started regardless of the value specified for this attribute.
When *NO is specified, only the STRTCPSVR command with SERVER(*DNS) or SERVER(*ALL) specified will start the DNS server.
If you do not intend to use the DNS server, set AUTOSTART to *NO.
| Top |
Specifies how much diagnostic (debug) information the DNS server gathers and writes to a log file. The debug information is used by IBM Service for DNS problem determination.
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.
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.
As the debug level value increases from 1 to 11, the amount of debug information written to the DBGLVL log also increases. High values also cause the DNS server to take a greater amount of time to initialize.
Debug information is written to an integrated file system stream 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.
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.
| Top |
CHGDNSA DNSSVR(*ALL) AUTOSTART(*YES)
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.
| Top |
*ESCAPE Messages
| Top |