WINS Consistency Check Tool
Winschk.exe

Windows NTŪ Resource Kits

Contents

Introduction

Options

Introduction

Winschk is a command-line utility that checks for name and version number inconsistencies in WINS (Windows Internet Name Service) databases, monitors replication activity, and verifies replication configuration.

WINS is a service that maps computer names to IP (Internet Protocol) addresses, allowing users to communicate with other computers on a network or the World Wide Web without having to remember addresses in the form of strings of numbers.

Winschk has no switches: when run at the command prompt, it displays the following options:

0Enables or disables interactive mode

1Tests for names on WINS servers

2Checks for version number consistencies

3Monitors WINS servers and detects communication failures

4Verifies replication configuration

99Exits Winschk

These options are described in more detail below.

Options

0 - Enabling or disabling interactive mode

Allows the user to enable or disable interactive mode. In interactive mode, status messages are displayed in the command-prompt window and recorded in Winstst.log. The first time you run Winschk, interactive mode is enabled by default.

1 - Testing names on WINS servers

This option allows you to check quickly for consistency between WINS servers. This functionality is driven by two flat files, Names.txt and Servers.txt, which you can edit by using a text editor.

Servers.txt contains the IP address of a source WINS server from which a list of all the replicating WINS servers is built up to query.

Names.txt can contain multiple NetBIOS names (one per line) which need to be checked. The format of names in this file is:

name*16th_byte

for example, FOOBAR*20

Note

The names included in Names.txt must be specified in uppercase characters.

Winschk queries each WINS server with the list of NetBIOS names. It checks for consistency of IP addresses and reports any mismatched IP addresses or occurrences of "name not found". It also reports non-responsive WINS servers.

2 - Checking for version number inconsistencies

Using an RPC (remote procedure call) function, Winschk gets the owner address to version number mapping tables from different WINS servers and checks the consistency of their databases by ensuring that a WINS server always has the highest version number among the network of WINS servers for records it owns.

In the following matrix, each record is a mapping table retrieved from a particular WINS server (the order of WINS servers being the same along both dimensions of the matrix), each diagonal element should have the highest version number among all the numbers in its column.

ABCList of owners

A1008079Mapping table retrieved from A

B9575*65Mapping table retrieved from B

C7845110Mapping table retrieved from C

In this example, the intersection B with B indicates a problem that needs to be addressed.

3 - Monitoring WINS servers and detecting communication failures between WINS servers

This option monitors WINS servers periodically to ensure that both the primary and backup WINS servers are not down at the same time. Winschk records WINS server activity in Monitor.log, and alerts the administrator to any situation that needs to be addressed.

This option also periodically retrieves statistics from the WINS server, for example once every hour, to ensure that replication is not failing consistently. Communication problems might be due to a WINS server being disconnected or being down.

You can run Winschk with this option as a one-time or a continuous version. The continuous version runs every 3 hours by default. You should not run this option too frequently to avoid excessive network activity.

4 - Verifying replication configuration

Checks the Registry of a WINS server to ensure that each replication partner is configured as both pull and push and that a pull interval is defined. In this way, WINS database changes are replicated for the entire network. If Winschk detects an asymmetric partner relationship, it flags it for the administrator.

99 - Exits the tool