TopUL
-----

Utility to keep track of uploaded files & bytes to the system, for
either a single conference or the whole system.
This utility can create a weektop uploader chart and a alltime topuploader
chart.

The weektop is started the day you first use the utility and
counts 7 days from this day. At the end of a week, the weektop tool
will save an ALL message displayed to all users in the conference
where the utility is started. the Weektop will be reset and this
weeks topuploader will be kept on the topuploader chart as last weeks
topuploader.


The Alltime topuploader chart is never reset, and will begin from the
day you install the utility.


-----------------------------------------------------------------------
Syntax:  {NAME} {COMMANDs} {CHARTSIZE} {OPTIONS}


NAME        = TOPUL

COMMANDS:
c           = clearscreen code include
w           = WeekTop datafile

CHARTSIZE   = a value from 1-50 , number of contesters on chart.


OPTIONS:
t	    = full path and filename of output text file.
d	    = full path and filename of output data file.
-----------------------------------------------------------------------









Creating a WeekTop for a single conference.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you setup the TopUL to work with seperate conferences, It will
only work , if you have serepate conference data files.
(USING "SHARECONFDATA" in your prefs file, will give incorrect charts!)

Edit your joinconf.txt (if not there, make one), in the conference where you
want the chart.

Enter:
>--->--->--->--->-
``DOOR TopUL cw10@
<---<---<---<----<

``DOOR = QRS command to start a door
 TopUL = door name
 c     = include the clearscreen code
 w     = make a weektop chart
 10    = number of competitors on chart
 @     = QRS door command end.


A way of displaying the chart could look like this:

>--->--->--->--->------------------------
``DISPLAY BBS:CONFS/PUBLIC/WeekTopUL.TXT@
<---<---<---<----<-----------------------






Creating a WeekTop for all conferences.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

All you need to do, is specify a destination path for both the datafile
and the textfile.

Enter:
>--->--->--->--->-
``DOOR TopUL cw10 tbbs:bulletins/bull1.txt dbbs:bulletins/bull1.dat@
<---<---<---<----<

Textfile to be display is located in your bulletins directory,
and users can view the chart, with the "B" command. Entering "B 1" would
display the chart.






Creating a AllTimes TopUploader chart.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can select to use a topuploader chart for one conference, or all
conferences. Do the same steps explained in previous chapters,
but leave out the "w" command.

You must include the below lines in your 'joinconf.txt' in each conference
you wish must be counted in the chart.

>--->--->--->--->-
``DOOR TopUL c20 tbbs:bulletins/bull2.txt dbbs:bulletins/bull2.dat@
<---<---<---<----<