home *** CD-ROM | disk | FTP | other *** search
-
- ------------------------------------------------------------------------------
- QuikTop v3.1
-
- QuickBBS Top Users Bulletin Generator
-
- Copyright (C) 1990-91 Foxtrot Software
- All Rights Reserved.
-
- This is a shareware program, this program is not to be sold or modified
- in any way. You are free to copy and distribute QuikTop as long as:
-
- a. No fee is charged for use of the program or the documentation.
- A fee may be charged for copying or distibution of this software
- and documentation for others not to exceed US $10.00.
-
- b. It is not modified in any way.
-
- c. This software and documentation or either is not used commercially.
-
- d. You distribute this software along with all documentation and
- registration forms unmodified.
-
- The Author hereby disclaims all warranties relating to this software,
- whether expressed or implied, including without limitation any implied
- warranties of merchantability or fitness for a particular purpose. The
- author will not be liable for any special, incidental, consequenctial,
- indirect or simular damages due to loss of data or any other reason. The
- user of this software bears all risk as to the quality and performance
- of this software.
-
- -------------------Now that we have that out of the way-----------------------
-
- If you have any comments or suggestions for improvement of this software,
- you can contact me at Info-Center BBS, data: (914)567-1814, 24 hours a
- day or leave Net-Mail @Fidonet 1:272/26, @Magnet 100:900/39.
-
- If you like this software, and decide to keep it on your system, then
- please register your copy. Registration is US $8.00. Please help support
- the shareware concept and development of even more quality utilities.
-
- Thank you for your support.
-
- ------------------------------------------------------------------------------
-
- 1. Introduction.
-
- QuikTop is a utility that will allow the Sysop of a QuickBBS system to
- produce a TOP Users Bulletin that conatins the TOP Callers, TOP
- Downloaders and TOP Uploaders by name and how many times they called,
- bytes downloaded and bytes Uploaded on your system.
-
- QuikTop uses the environment variable QUICK to find the QuickCfg.Dat
- file. If the environment variable is not set on your system, then
- QuickTop must be run in the same directory where your system files are
- located.
-
- You can set the variable by using the DOS Command SET QUICK=C:\QUICKBBS
- in your autoexec.bat startup file.
-
- The bulletin is usually placed in same directory as all other text files
- so a menu option can be built to allow a user to view the Bulletin.
-
- This version of QuikTop is for use with QuickBBS V 2.75 and later
- releases.
-
-
-
- 2. Setup.
-
- The following outlines what commands to in the QuikTop.CTL control
- file and COLORS available to adjust to your liking.
-
- a. An Editor that will create text files, such as EDLIN, GALAXY,
- or any Editor that will allow CR/LF combinations at the end of each
- line has to be used. Create the QuikTop.CTL file in your QUICKBBS
- BBS directory where your Users.BBS file or if the QUICK environment
- variable is set, the directory you will be running QuikTop from.
- Enter the following information:
-
- ;
- ; Path - Full pathname of where you want the bulletin put. No extension
- ; is placed on this pathname. If this command isn't present, then
- ; RaTop will assume BULLET01 only as the filename and place the
- ; bulletins in your current directory.
- ;
- Path D:\QuickBBS\Txtfiles\Bullet01
- ;
- ; Title - The Title you wish to have at the heading of the bulletin.
- ; This can be anything you desire as long as it is 70 characters
- ; or less. If this command isn't present, then QuikTop will assume:
- ;
- Title Info-Center BBS * Top BBS Users Report
- ;
- ; Frame - This is the color you want the frame of the bulletin to be.
- ;
- Frame 3
- ;
- ; Title1 - This is the color you want the Title above to be.
- ;
- Title1 15
- ;
- ; Title2 - This is the color you want the Bulletin Heading to be.
- ; The bulletin heading is:
- ; 'C A L L E R S D O W N L O A D E R S U L O A D E R S'
- ;
- Title2 10
- ;
- ; Users - This is the color you want the users names to be.
- ;
- Users 14
- ;
- ; Background - This is the color you want the bulletin background to be.
- ;
- Background 0
- ;
- ; Security - The lowest security level a user has to have before being included
- ; in the bulletin. Max is 32000.
- ;
- SecurityLvl 5
- ;
- ; SecFlags - This works exactly like the flags work for QuickBBS.
- ;
- SecFlags -------- -------- -------- --------
- ;
-
-
- b. Available Colors Codes:
-
- ________
- 0 Black \
- 1 Blue \
- 2 Green \ BackGround or
- 3 Cyan ---------------
- 4 Red / ForeGround
- 5 Magenta /
- 6 Brown /
- 7 LightGray ___/
- _______
- 8 Gray \
- 9 LightBlue \
- 10 LightGreen \ Foreground Only
- 11 LightCyan ------------------
- 12 LightRed /
- 13 LightMagenta /
- 14 Yellow /
- 15 White ______/
-
-
-
- c. How to run QuikTop:
-
- Usage: QuikTop [-S] [{-U n}] [-?] [{-F CtlFile}]
-
- QuikTop can be executed with any or none of the following arguments:
-
- [-S] - will tell QuikTop to include the SysOp's name and
- number of Calls, Downloads and Uploads. Default is not
- to include the SysOp in the Bulletin.
-
- [-U n] - will tell QuikTop how many Users you wish to include
- in the Bulletin. Default is The Top 20 Users.
- Valid numbers are from 10 - 32000.
-
- [-?] - will tell QuikTop to display command line help. If
- this argument is to be used, then it must be the only
- one used on the command line to recieve help.
-
- * [-F CtlFile] - will tell QuikTop to use an alternate Control file
- to process. This would allow you to create numerous
- bulletins using different security/flags settings.
- * Available to Registered Copies Only.
-
-
- d. All that is needed now is, you to make sure that you have
- QuikTop.Exe and QuikTop.CTL in the same directory and then execute
- it in that directory. QuikTop.EXE defaults to USERS.BBS and is
- not configurable by you.
-
-
- 4. Closing.
-
- I hope this little utility will help enhance your QuickBBS.
- I had fun writing it anyway.
-
-
- Update History:
-
- 12/31/89 - First Release 1.0.
-
- 01/04/89 - An extra space was added to names even if it exceeded
- v1.1 the column limit.
-
- - One more color added "LIGHTGRAY". How did I forget
- this one?
-
- - Users Delete flag is now checked. If set then
- User will not be processed.
-
- - All works files are deleted upon sucessful
- completion.
-
- 01/05/89 - Added command line parameters [-s] and
- v2.0 [-u n] to allow more flexibility for the SysOp when
- generating the Bulletin. Thanks to Paul Knox
- SysOp of Ft. Knox BBS (1:360/12) for all his input.
-
- 08/08/90 - Code Optimization.
- v2.1
-
- 08/30/90 - Completly rewrite the search and sort logic. Index
- v3.0 files are now used to help speed up the process.
-
- 10/30/91 - I thought a sort speed up was in order.
- v3.1 - Added option -F to allow processing of an alternate
- Control file for building multiple bulletins.
- - Added full user flag security support.
-
-
-
- Other quality software available from me for SysOps:
-
- Magic Name Description
-
- RAFBSTAT Creates a bulletin with stats on all your files areas for
- Remote Access v 1.0.
-
- QUIKTOP Creates a Top Users bulletin for QuickBBS 2.75.
-
- RATOP Creates a Top Users bulletin for RA v1.01.
-
- OPUSTOP Creates a Top Users bulletin for OPUS CBCS 1.1x.
-
-
-
- PROBLEMS:
-
- Please notify me immediately if you have any problems or
- suggestions about this program. Enhancements are being incorporated
- all the time and your input is more vital to this process than you
- think. You may write me, send Net-Mail or logon at the following address:
-
- Byron Copeland (Sysop) Info-Center BBS (formerly The
- 11 Y Street Foxtrot BBS, 1:360/11)
- New Windsor, NY 12553 (914) 567-1814 @Fidonet 1:272/26
- 24 hours, Every day!
-
-
-
- Enjoy and thank you for your support.
-
-
- - End -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-