USEDOOR Version 1.00
====================
(c) 1989 RK BBSWARE

Send your $5.00 donation to:
Rob Kruss
8610 Whitefield
Dearborn Heights, MI 48127


USEDOOR is a quick and easy program that can be used to count the number of
times that a door or any program on your system is called. The following
files are included in your USEDOOR archive:

USEDOOR.EXE The program that counts usage
USEREPT.EXE The report generator program
USEDOOR.CFG A sample configuration file
SAMPLE.RPT A sample report or usage
USEDOOR.DOC This file, the documentation

To use USEDOOR, simply add the USEDOOR program to your door batch file
just before you recycle back to your board. You follow the program name
with the name of the usage file that will accumulate usage statistics
for this door.

Example:

echo off
e:
cd\gap\doors\tpost
tradepst.exe tradepst.cfg
=====> USEDOOR TPOST.CNT
e:
cd\gap
gap


This command would save usage statistics for a "Trade'in Post" door in the
file TPOST.CNT in the specified directory. If no path is specified, USEDOOR
will save the configuration file in the current directory. (Note: The
USEDOOR.EXE file must be in your path or reside in the working directory.)

To report the useage of your doors, the USEREPT program is used. To use this
program you must first create a configuration file. This file must have
at least two lines. The first line is the title that you would like to use
for your report. Each additional line specifies the door name (names over
25 characters will be truncated), a comma, a space, and the path to the usage
file for that door.

Example:

Motown - L.A. BBS DOOR USAGE
Trade'in Post, D:\GAP\DOORS\TPOST\TPOST.CNT
Reno Keno, D:\GAP\DOORS\KENO\KENO.CNT

Once you have created the configuration file, you may run the USEREPT program.
There must be three parameters on the USEREPT command line. First the name
USEREPT, second specify the name of the configuration file to use, third
specify the name of a text file that you would like to contain the report.

Example:

USEREPT USEREPT.CFG REPORT.TXT

You may then see the result of the report at the dos command line by using
the TYPE command:

TYPE REPORT.TXT

To reset the counter back to zero, simply delete the .CNT file for a given
door and USEDOOR will create a new one the first time it is run and begin
at "1".

QUIRKS:

- If the door has never been opened, you will recieve a message in the
report that it was unable to find the .CNT file.

- The counter will only go to 32,767 (must be a popular door). You
should reset the .CNT file before it reaches this point.

For further information about this utility, leave a comment to Rob Kruss
on Motown - L.A. BBS (714) 535-1319.