WinsCl Topics | Next

WinsCl Options


You can use the following options with WinsCl:

Option Full name Explanation
RN Register Name Allows you to register unique/multihomed/normal group/Internet group names.
QN Query Name Allows you to query any name in the Windows Internet Name Service (WINS) database.
DN Delete Name Deletes a name. This action permanently erases the name from the WINS database.
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 seconds. 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 database is relative to other WINS servers is also retrieved. This command works only with WINS used with Microsoft® Windows NT® version 3.51.

 

note-icon

Note

Owner ID is a number corresponding to a WINS address. This number is stored with a record in the WINS database, and identifies the owner of the record.

GMO Get Mappings (Windows NT 3.5 WINS) Is the same as Get Mappings except that this version applies only to WINS used with Windows NT 3.5.
GST Get Statistics Allows you to get the various time-stamps and statistics maintained by WINS. This option applies only to WINS used with Windows NT 3.51.
GSTO Get Statistics (Windows NT 3.5 WINS) Is the same as Get Statistics except that this option applies only to WINS used with Windows NT 3.5.
PUSHT Push Trigger Allows you to instruct the connected WINS server to send a push trigger to another WINS server. The local WINS server sends a push trigger to the remote WINS server only if one of the following conditions is true:
  • The remote WINS server is listed under the Wins\Parameters\Push subkey in the registry.
  • The RplOnlyWCnfPnrs entry in the Wins\Parameters subkey in the registry is not present or has a value of 0.
Likewise, the remote WINS accepts this trigger only if the local WINS satisfies one of the following conditions:
  • It is listed under the Wins\Parameters\Pull subkey in its registry.
  • The RplOnlyWCnfPnrs entry in the Wins\Parameters subkey in its registry is not present or has a value of 0.
Once the trigger is sent and accepted, the remote WINS server, depending on whether or not its database is out of sync with the database of the connected WINS server, might or might not pull records from the local WINS server.
PULLT Pull Trigger Allows you to instruct the connected WINS server to send a pull trigger to another WINS server. The local WINS server sends a pull trigger to the remote WINS server only if its database is out of sync with the database of the remote WINS server, and if (and only if) one of the following conditions is true:
  • The remote WINS server is listed in the registry under the Wins\Parameters\Pull subkey.
  • The RplOnlyWCnfPnrs registry entry in the Wins\Parameters subkey is either not present or has a value of 0.
Likewise, the remote WINS server accepts this trigger only if one of the following conditions is true:
  • The local WINS server is listed under the Wins\Parameters\Push subkey in its registry.
  • The RplOnlyWCnfPnrs entry in the Wins\Parameters subkey in its registry is either not present or has a value of 0.
SI Statically Initialize WINS Allows you to statically initialize WINS from a file which has records in the format used in an LMHOSTS file.
CC Consistency Checking Allows you to initiate consistency checking on WINS. Consistency checking results in a WINS server communicating with other WINS servers to check the consistency of its database.
Warning This operation results in high overhead on the WINS server and can also use up the entire network bandwidth (if a full replication is done). If you have a large database, you should run this command at a time when network traffic is minimal.
SC Scavenge Records Is used to instruct WINS to scavenge records. This means that records that are old enough are released, and appropriate records are made extinct. Extinct records that need to be deleted are deleted, and replica records that need to be verified are verified.
DRR Delete All or a Range of Records Is used to delete records by specifying a range of version numbers. You can also delete all records in a WINS database. Only the records owned by the selected WINS server are deleted. Other information about the WINS service, such as the highest version number pulled, is not deleted.
PRR Pull All or a Range of Records Is used to pull a range of records from remote WINS. The range is a range of version numbers. If the range being pulled overlaps records of the remote WINS that already exist in the WINS database, the pre-existing records are deleted before the new ones are pulled. This command is used to pull records that were never replicated and have no chance of being replicated unless their version number becomes greater than the highest value the local WINS has allocated for remote WINS. Replication only takes place after the appropriate registry value has been checked.
See also Pull Trigger
GRBN Get Records by Name Retrieves one or more records starting with a string. The names of records are alphabetically sorted in the WINS database.
Note Names with 0x1B in the 16th byte are an exception. They are stored with the 1st and 16th byte transposed.
You can choose to search the database from the beginning or from the end. If, for example, you want to retrieve 100 names starting with the letter Z, you can specify that WINS should search from the end of the database. This will cause less overhead on WINS.
GRBV Get Records by Version Number Retrieves records from the local WINS database in the specified range of version numbers.
BK Back Up WINS Database Performs a backup of the WINS database to a directory on the same WINS computer.
RSO Restore WINS Database prior to Microsoft® Windows NT version 4.0 Restores the WINS database from the directory to which it was backed up.
Note The WINS database is created by WINS prior to Windows NT 4.0. Also, make sure that WINS is not running when you run this command.
RS Restore WINS Database Restores the WINS database from the directory to which it was backed up.
Note The WINS database is created by WINS in Windows NT 4.0 or Windows 2000. Also, make sure that WINS is not running when you run this command.
RC Reset WINS Counters Resets the WINS counters displayed via Get Statistics (or Get Statistics (Windows NT 3.5 WINS) for Windows NT 3.5 WINS) to 0.
CR Count Records in Database Counts the number of records for an owner in the WINS database. The owner is identified by the address. You can count either all or a specific range of records.
Note This can be a high overhead operation.
SDB Search Database Searches the database for a record with a particular name or address.
Note This can be a high overhead operation.
GD Get Domain Names Allows you to get the list of domain names registered in the WINS database. These are the 1B names (0x1B in the 16th byte) registered by the PDCs (primary domain controllers) of the domains.
DW Delete WINS Deletes all the information relevant to a WINS server (identified by its address) from the database of the connected WINS server, including all records belonging to the WINS server and administrative information. When the connected WINS is specified for deletion, all of its records are deleted. Other information, such as highest version number of records in the database, is not removed.
CW Connect to WINS Allows you to connect to a remote WINS server.
MENU Show Menu Displays the list of commands available.
NOMENU No Menu Hides the list of commands. This may be desirable if you don't want to clutter the output when a script is driving WinsCl.
EX Exit Tool Allows you to exit WinsCl.