Windows Support Tools feature does not work correctly when you use the syntax described in Support Tools Help file (818717)



The information in this article applies to:

  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows 2000 Professional
  • Microsoft Windows 2000 Server

SYMPTOMS

When you use Windows Support Tools by using the syntax that is described in the Windows Support Tools Help file (w2rksupp.chm), some of the support tools may not work correctly.

CAUSE

This issue occurs because the Windows Support Tools Help file (Suptools.chm) incorrectly lists several parameters in lowercase.

For example, the Help files cite the following syntax for the DNS Server Troubleshooting Tool when used with the config operation:

dnscmd ServerName /config parameter value

The parameters for the DNS Server Troubleshooting Tool are all listed in lowercase. For example, the sample EventlogLevel parameter is incorrectly listed in lowercase, as follows:

/eventloglevel [0|1|2|4]
Determines which events are logged in the DNS server log in Event Viewer.

ValueDescription
0 Logs no events.
1 Logs only errors.
2 Logs only errors and warnings.
4 Logs errors, warnings, and informational events. This is the default setting.


When you use this syntax and case on a DNS server (for example, if you type dnscmd /config /eventloglevel 2), you receive the following error message:
DNS Server failed to reset registry property.
Status = 9553 (0x00002551)
However, when you use the correct case for the EventlogLevel parameter on a DNS server (for example, if you type dnscmd /config /EventlogLevel 2), the command runs successfully.

WORKAROUND

To work around this issue, verify the syntax for the parameter that you want by using the /? switch.

For example, to confirm the correct case for parameters used with the Dnscmd.exe tool and the config operation, type the following command at the command line, and then press ENTER:

dnscmd ServerName /?

The following information appears:
 
 USAGE:  DnsCmd <ServerName> /Config [<ZoneName>|..AllZones] <Property> <Value>
    Server <Property>:
                /RpcProtocol
                /LogLevel
                /EventlogLevel
                /NoRecursion
                /ForwardDelegations
                /ForwardingTimeout
                /IsSlave
                /SecureResponses
                /RecursionRetry
                /RecursionTimeout
                /MaxCacheTtl
                /MaxNegativeCacheTtl
                /RoundRobin
                /LocalNetPriority
                /AddressAnswerLimit
                /BindSecondaries
                /WriteAuthorityNs
                /NameCheckFlag
                /StrictFileParsing
                /UpdateOptions
                /DisableAutoReverseZones
                /SendPort
                /NoTcp
                /XfrConnectTimeout
                /DsPollingInterval
                /DsTombstoneInterval
                /ScavengingInterval
                /DefaultAgingState
                /DefaultNoRefreshInterval
                /DefaultRefreshInterval
                /DisableNSRecordsAutoCreation
    Zone <Property>:
                /SecureSecondaries
                /AllowUpdate
                /Aging
                /RefreshInterval <Value>
                /NoRefreshInterval <Value>
                /AllowNSRecordsAutoCreation <IP List>
    <Value>: New property value. Use 0x prefix to indicate hex value.
        Note some server and zone DWORD properties must be reset as
        part of a more complex operation.
        Use zone "..AllZones" to apply operation to all zones.
        See dnscmd help for more information.
Command completed successfully.

Modification Type:MajorLast Reviewed:7/26/2004
Keywords:kberrmsg kbprb KB818717 kbAudITPRO