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 . Example 0 9567. The numbers are in decimal.