Change DNS Server Attributes (CHGDNSA)

Where allowed to run: All environments (*ALL)
Threadsafe: No

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:

You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Top

Parameters

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

Server instance (DNSSVR)

Specifies which DNS server should have its attributes changed.

*ALL: All of the DNS server instances that are currently configured on the system will have their attributes values changed to those specified in the other parameters of this command.
character-value: Specify the name of the DNS server instance which will have its attributes values changed to those specified in the other parameters of this command.

Top

Autostart server (AUTOSTART)

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.

*SAME

The autostart attribute is not changed from its previous setting. If you specify *SAME and this value was not previously set, the value *NO will be used.

*YES

The DNS server will start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR command with SERVER(*AUTOSTART).

*NO

The DNS server will not start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR command with SERVER(*AUTOSTART) specified.

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

Debug level (DBGLVL)

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.

*SAME: The value does not change, if it was previously set. Otherwise, a value of 0 (debug off) is used.
*DFT: Use a debug level of 0 (off).
0-11: 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.

Top

Examples

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

Error messages

*ESCAPE Messages

DNS0013: Error processing command parameters.
DNS0016: Server instance &1 could not be processed.
DNS0017: Configuration migration to BIND format &1 is required.
DNS0019: Installed server version cannot be determined.
DNS0058: *IOSYSCFG authority required to use &1.
TCP7124: Program &1 in library &2 type *PGM ended abnormally.

Top