winscl.exe is a non-gui administration tool for WINS. It can be used
for monitoring a WINS's activity and for examining its database.
It can also be used for sending commands to WINS to initiate an activity
such as replication, scavenging, registering a record, etc.
Note: Unlike WINS Manager, winscl can not be used to configure a WINS.
The following commands are supported by winscl
RN - Register Name
You can register a unique/multihomed/normal group/internet group names.
QN - Query Name
You can query any name in the wins db.
DN - Delete Name
Deletes a name. This action permanently gets rid of the name from the
WINS db.
GV - Get Version Counter Value
Gets the current value of the version counter used to stamp records with
version numbers
GM - Get Mappings
Gets the configuration intervals being used by WINS. These intervals
are in secs. It also retrieves the priority class and the number of
query threads in WINS. The owner id to address to version number mappings
used by the replicator to determine how up-to-date the WINS db is relative
to other WINSs is also retrieved. This command works only with an
NT 3.51 WINS. Note: Owner Id is a number corresponding to a WINS address
that is stored with a record in the WINS db. It indicates who the owner
of the record is.
GMO - Get Mappings (to be used with NT 3.5 WINS)
Same as above except that this command should be used when connected to an
NT 3.5 WINS.
GST - Get Statistics
Gets the various timestamps and statistics maintained by WINS. This command
works only with an NT 3.51 WINS
GSTO - Get Statistics (to be used with NT 3.5 WINS)
Same as above except that this command should be used when going to an
NT 3.5 WINS.
PUSHT - Push Trigger
Used to instruct the connected WINS to send a push trigger to another WINS.
The local WINS will send a push trigger to the remote WINS only if either the
remote WINS is listed under the Wins\Parameters\Push key in the registry or
if RplOnlyWCnfPnrs value of the Wins\Parameters key in the registry is
either non-existent or is set to 0. Likewise, the remote WINS will accept
this trigger only of the local WINS is either listed listed under the
Wins\Parameters\Pull key in its registry or if RplOnlyWCnfPnrs value of the
Wins\Parameters key in its registry is either non-existent or is set to 0.
Once the trigger is sent and accepted, the remote WINS, depending upon
whether or not its db is out of sync with the connected WINS's db may or
may not pull records from the local WINS.
PULLT - Pull Trigger
Used to instruct the connected WINS to send a pull trigger to another WINS.
The local WINS will send a pull trigger to the remote WINS only if its db
is out of sync with it and if and only if the remote WINS is either listed
under the Wins\Parameters\Pull key or if RplOnlyWCnfPnrs value of the
Wins\Parameters key either non-existent or is set to 0. Likewise,
the remote WINS will accept this trigger only of the local WINS is either
listed listed under the Wins\Parameters\Push key in its registry or if
RplOnlyWCnfPnrs value of the Wins\Parameters key in its registry is either
non-existent or is set to 0.
SI - Statically Initialize WINS
Used to statically initialize WINS from a file which has records in
the format used in an lmhosts file.
CC - Use this command to initiate Consistency Checking on WINS. Consistency
checking results in WINS communicating with other WINSs to check the
consistency of its database. THIS OPERATION RESULTS IN HIGH OVERHEAD
ON THE WINS AND ALSO CAN HOG UP NETWORK BW (A FULL REPLICATION IS DONE).
If you have a large database, you should probably do this at times when
there is less network traffic.
SC - Scavenge records
Used to instruct WINS to scavenge records. This means that records that
are old enough to be released will be released. Those that need to be
made extinct will be made so. Extinct records that need to be deleted
will be deleted. replica records that need to be verified will be verified.
DRR - Delete all or a range of records
Used to deleted records by giving the range of version numbers. You can
delete all records of a WINS too. Only the records owned by the WINS
selected (when prompted) will be deleted. Other information regarding
the WINS, such as highest version number pulled, will not be deleted.
PRR - Pull all or a range of records
Used to pull a range of records from another WINS. The range is given
in terms of version numbers. If the range being pulled overlaps records
of the remote WINS already there in the WINS db, they will first be
deleted before the new records are pulled. This command is used to pull
record(s) that somehow never got replicated and have no chance of
replicating unless their version number becomes more than the highest the
local WINS has for the remote WINS.
Again, like the PULLT command, the replication will happen only after the
appropriate registry check (refer: PULLT command)
GRBN - Get record by Name
Retreives one or more records starting with a string. The names of
records are lexicographically sorted in the WINS db (Exception:
Names with 0x1B in the 16th byte are stored with the 1st and 16th byte
transposed - they are displayed correctly). You are given a choice to
search the db from the beginning or the end. So, if you want to retrieve
lets say 100 names starting with Z, it is a good idea to specify that
WINS should search the names from the end of the db. This will cause
less overhead on WINS.
GRBV - Get records by version numbers
Retrieve records from the local WINS db by specifying the range of
version numbers.
BK - Backup the WINS db.
Backup the WINS db to a directory on the same machine as WINS.
RSO - Restore the WINS db (db created by WINS prior to SUR)
Restores the WINS db to the directory it was backed up from. NOTE: WINS
SHOULD NOT BE RUNNING WHEN YOU RUN THIS COMMAND.
RS - Restore the WINS db (db created by WINS in SUR or beyond)
Restores the WINS db to the directory it was backed up from. NOTE: WINS
SHOULD NOT BE RUNNING WHEN YOU RUN THIS COMMAND.
RC - Reset WINS counters
Resets the WINS counters displayed via GST (or GSTO for NT 3.5 WINS) to
0.
CR - Count records in the db.
Counts the number of records for an owner in the WINS db. The owner
is identified by the address. You can either count all or a range of
records. NOTE: this can be a high overhead operation when the records
being counted are a lot.
SDB - Search the db
Search the database for records for a record with a particular name or
address. NOTE: When the db contains a lot of records, this can be
a time-consuming and "consistent overhead" operation on WINS.
GD - Get domain names
Gets the list of domain names registered in the WINS db. These are the
1B names (0x1B in the 16th byte) registered by PDCs of the domains.
DW - Delete Wins
This deletes all the information relevant to a WINS (identified by its
address) from the db of the connected WINS. This includes all records
belonging to the WINS as well as administrative information kept for the
WINS. When the connected WINS is specified for deletion, all its records
are deleted. Other information such as highest version number of records
in db. is not removed.
CW - Connect to Wins
MENU - Show MENU
NOMENU - Don't show MENU (helpful if you don't want to clutter up the output
from a script driving the tool).
Used to connect to another WINS
EX - Exit the tool
Points to Note:
1) Addresses of WINS should be given in dotted decimal notation
2) A version number is 64 bits long. When prompted for it, it should be
given in decimal with the high word first followed by the low word
The two words should be seperated by a space.
3) Many commands such as PULLT, PUSHT, SI, PRR, etc are executed
in the background. A return status of SUCCESS indicates that the
command has been queued to WINS for execution. It does not mean that
WINS has successfully executed the command.
4) winscl is case sensitive. So, BOB is different from bob or Bob (when
input to RN, QN, DN, etc).
5) Scope if given should be in domain name form - explained in
rfc 883. Example: netbios.com.
6) Whenever a pull (or a push) replication is done, the local WINS will
send a request for it to the remote WINS only if the remote WINS is
either listed under the Wins\Parameters\Pull (or Push) key or
if RplOnlyWCnfPnrs value of the Wins\Parameters key is either
non-existent or is set to 0. Likewise, the remote WINS will accept
the above request only if the WINS making the request is either
listed under the Wins\Parameters\Push (or Pull) key or if
the RplOnlyWCnfPnrs value of the Wins\Parameters key is either
non-existent or is set to 0.
The two WINSs look up the above keys/values in their local registries.
7) When prompted for Version Number, give it in the following form
<high word> <long word>. Example 0 9567. The numbers are in decimal.
