windows-server-2003/net/wins/rpc

 

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.