README for delstubs.exe, version 1.3
copyright 2002, Julian Robichaux
www.nsftools.com


DESCRIPTION
delstubs is a command-line program that allows you to count, list, and optionally remove deletion stubs in a Notes database. You can either work with all the stubs in a database, or you can specify a time range that you'd like to work with.

Use this tool with care. Please keep in mind that removing deletion stubs from a database will prevent the stubs from being replicated to other replicas of the database, which can cause data inconsistencies, and can potentially cause deleted documents and design elements to reappear in a database after replication has occurred.


REQUIREMENTS
Windows 95/98/NT/2000
Notes Client 4.6 or higher


INSTALLATION
Copy the delstubs.exe program to your Notes executable directory (the directory that has the nnotes.dll file). Run it from a command prompt, as described below.


USAGE
delstubs [ServerName] <DbName> [/d] [/l] [/r] [/s:days] [/e:days]

  ServerName      [optional] The name of the server that the database is on.
  DbName          The name of the database to examine.
  /d              Display occasional progress as the stubs are counted.
  /l              List information about the deletion stubs.
  /r              Remove all deletion stubs that match the date criteria.
  /s:days         Get deletion stubs that are this many days old or newer.
  /e:days         Get deletion stubs that are this many days old or older.

If the server or database name contains spaces, enclose it in quotation marks.
You must have at least Editor access to remove deletion stubs. You can also
use a combination of the /s and /e options to specify a date range - for
example, /s:14 /e:7 gets stubs created in the last 7 to 14 days, /s:1 /e:1
gets stubs created yesterday, and /s:0 /e:0 gets stubs created today. To see
stubs created in the future, don't use the /e option.


EXAMPLES
To count all deletion stubs in the local names.nsf database:
  delstubs names.nsf

To count all deletion stubs in the names.nsf database on server 'MyServer':
  delstubs MyServer names.nsf

To list information about all deletion stubs in the local names.nsf database:
  delstubs names.nsf /l

To remove all deletion stubs in the local names.nsf database:
  delstubs names.nsf /r

To list information about all deletion stubs in the local names.nsf database that were created in the past week:
  delstubs names.nsf /l /s:7

To remove all deletion stubs in the local names.nsf database that were created today:
  delstubs names.nsf /r /s:0 /e:0


KNOWN PROBLEMS
None.


VERSION HISTORY
Version 1.0
-  Initial release

Version 1.1
-  better filtering (and presumably speed) on lookups that have both a start and an end date before today

Version 1.2
-  added /d option (good for watching progress of large databases on remote servers)
-  added CTRL-C handling, in case you want to cancel during processing of a large database

Version 1.3
-  dramatically decreased the amount of time it takes to count the number of stubs in large databases, as long as the /s, /e, or /l options are not specified
