| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
(CHGDNSA) Use this command to set or change the DNS Server Attributes: AUTOSTART and DBGLVL
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.
Restriction:
You must have *IOSYSCFG special authority to use this command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DNSSVR | Server instance | Character value, *ALL | Optional, Key, Positional 1 |
| AUTOSTART | Autostart server | *YES, *NO, *SAME | Optional |
| DBGLVL | Debug level | 0-11, *SAME, *DFT | Optional |
| Top |
The DNS Server instance parameter determines which specific DNS server should have its attributes changed.
Note: 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.
Note: If you provide a server-instance-name when prompting on this command, the remaining attributes parameters will display the actual current values for the specified instance.
| Top |
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.
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.
When the value is set to *NO, only the STRTCPSVR *DNS command or the STRTCPSVR *ALL command will start the DNS server.
If you do not intend to use the DNS server, set AUTOSTART to *NO.
| Top |
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.
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.
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.
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.
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 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 |
None
| Top |