Change Domain Name System debug settings

The Domain Name System (DNS) debug function can provide information that can help you determine and correct DNS server problems.

DNS offers 12 levels of debug control. Logging usually provides an easier method of finding problems, but in some cases debugging might be necessary. Under normal conditions, debugging is turned off (value = 0). It is recommended that you first use logging to attempt to correct problems.

Valid debug levels are 0 through 11. Your IBM® service representative can help you determine the appropriate debug value for diagnosing your DNS problem. Values of 1 or higher write debug information to the NAMED.RUN file in your iSeries™ directory path: Integrated File System/Root/QIBM/UserData/OS400/DNS/<server instance>, where "<server instance>" is the name of the DNS server instance. The NAMED.RUN file continues to grow as long as the debug level is set to 1 or higher, and the DNS server continues to run. It is recommended that you delete the file from time to time to keep it from taking up too much disk space. You can also use the Server Properties - Channels page to specify preferences for maximum size and number of versions of the NAMED.RUN file.

To change the debug value for a DNS server instance, follow these steps:

  1. In iSeries Navigator, expand your iSeries server > Network > Servers > DNS.
  2. In the right pane, right-click your DNS server and select Configuration.
  3. In the DNS configuration window, right-click the DNS server and select Properties.
  4. On the Server Properties - General page, specify the server startup debug level.
  5. If the server is running, stop and restart the server.
    Note: Changes to the debug level do not take effect while the server is running. The debug level set here will be used the next time the server is fully restarted. If you need to change the debug level while the server is running, see Advanced DNS features.
Related concepts
Advanced Domain Name System features
Related tasks
Troubleshoot Domain Name System