238 lines
9 KiB
Plaintext
238 lines
9 KiB
Plaintext
|
|
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.
|
|
|
|
|