Doorstat
V1.0

Doorstat is a utility made for SynchroNet that will track the usage of external doors.  This will generate a single door usage graph that will contain the name of the door, last access date, total times accessed and a color graph depicting each door.  Doorstat can handle up to 200 different doors.  

Doorstat is fully configurable through the doorstat.cfg file.  A description of the CFG file is included in the default doorstat.cfg file as well as this text below.  

-------------------- CUT HERE ------------------
NORMAL
RED
NORMAL
YEL
HIGH
YEL
NORMAL
GRN
NORMAL
CYN
HIGH
BLU
BLK
15

LINE 1	Intensity for the decorative bars (Top and Bottom of Graph)
LINE 2 	Color for the decorative bars (Top and Bottom of Graph)

LINE 3	Intensity for the legend (NAME OF DOOR GAME   LAST  Total)
LINE 4 	Color for the legend

LINE 5	Intensity for the Graph Bars
LINE 6 	Color for the Graph Bars

LINE 7	Intensity for the Door Name
LINE 8 	Color for the Door Name

LINE 9	Intensity for the Last Play Date
LINE 10	Color for the Last Play Date

LINE 11	Intensity for the Number of Times Played
LINE 12	Color for the Number of Times Played

LINE 13	Color for the Background 

LINE 14 Max Number of games to display on the graph (Must be less than 200)


CONTROL DESCRIPTIONS FOR DOORSTAT.CFG File
The doorstatcfg file configures the colors of the color codes used
to build the graph output.  The available intensity colors are 
HIGH
NORMAL

The Available color codes are as follows
BLK = Black
RED = Red
GRN = Green
YEL = Yellow
BLU = Blue
MAG = Magenta
CYN = Cyan
WHT = White

*** Doorstat.cfg file MUST reside in the doorstat directory.
----------------------CUT HERE --------------------------------

COMMAND LINE OPTIONS

Doorstat has several different command line options for editing, viewing, and generating the usage graphs.

DOORSTAT <NOTHING on the command line> 
This will display the command line options for reference without need to dig for this doc file.

DOORSTAT MAKEGRAF
This will sort and compile the DOORSTAT.ASC file for display in Synchronet BBS.

DOORSTAT SHOWRECORDS
This will display all records in the DOORSTAT.DAT file to the screen.  A Pause will display on the screen after displaying 5 records.

DOORSTAT MAINT
This is run the database maint mode.  This will allow the SysOp to edit entries.  NOTE:  You can NOT delete and entry.  You may rename the doorname, change the number of times accessed, modify the last access date.

DOORSTAT RESET
This will build a new DOORSTAT.DAT data file.  NOTE:  ALL RECORDS CURRENTLY IN THE DOORSTAT.DAT FILE WIlL BE LOST!!!  This MUST be run before the doorstat will function.


INSTALLATION

1. Create DOORSTAT directory under SBBS\XTRN and copy DOORSTAT.EXE, DOORSTAT.CFG and DOORSTAT.BAT to the newly created directory.
2. Open dos box and change the to DOORSTAT directory. Type DOORSTAT RESET to create a new datafile.
3. Adding entries to the database can be done 2 different ways:
3a. You can add a line to the batch file for each door you want tracked in doorstat.  EXAMPLE:
--------------- SAMPLE GAME.BAT file ------------------------
CD C:\DOORGAME
DOORGAME.EXE
CD C:\SBBS\XTRN\DOORSTAT
DOORSTAT DOORGAME  
DOORSTAT MAKEGRAF
CD C:\SBBS
--------------- END SAMPLE GAME.BAT -----------------------
3b.  Another option is to have a single batch file and call the batch file through SBBS Cleanup command entry in each door entry in the SBBS CFG utility.
--------------- SAMPLE DOORSTAT.BAT -----------------------
CD \SBBS\XTRN\DOORSTAT
DOORSTAT %1 %2 %3 %4 %5 %6
DOORSTAT MAKEGRAF
CD \SBBS\TEXT\MENU
DEL LOGON2.ASC
Copy C:\SBBS\XTRN\DOORSTAT\doorstat.asc c:\sbbs\text\menu\logon2.asc
CD \SBBS
--------------- END SAMPLE DOORSTAT.BAT -------------------
4. Make DOORSTAT.ASC available as either a logon#.asc file or create a bulletin entry to allow access.


If you have any questions, suggestions, or comments, I can be reached at 
The Ultimate BBS!
telnet://ubbs2006.synchro.net
or
Http://ultimate.4alexanders.com

Mike Alexander
The Ultimate BBS!






