home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
USTATV30.ZIP
/
USERSTAT.DOC
< prev
next >
Wrap
Text File
|
1992-09-01
|
7KB
|
162 lines
USERSTAT - The user statistics program
ver 3.0 documentation
Legal Shit: Please don't distribute changed versions. I am not
responsible if this software eats your hard drive. I am not liable
for any damages or loss of time if this software does not perform as
expected. I make no guarantees as to the suitability of this software
for any purpose, not even that for which it was designed.
THIS IS NOT FREEWARE or PUBLIC DOMAIN SOFTWARE. You may use this
software on your BBS for a period of 30 days. At the end of this
time period, you must remove the software & the generated GFILES or
send in your registration fee. Please note however, this is the
full-featured version of the software, it is not crippled in any way,
(at least not intentionally <grin>) as I trust WWIV sysops out there
to do the right thing. And for gosh sakes, if you are running a WWIV
BBS, register it!
Compatibilty: This software has been run under MS-DOS 3.2 on an
Compaq Deskpro and a Cheap Noname tawainese clone. It has run on a
IBM PS/2 models 25 and 30 under PC-DOS 3.3 and Novell Netware v2.0b.
It has also run on an Original IBM AT running MS-DOS 5.0, and a DFI
486/33 running MS-DOS 5.0 and Novell Netware v2.2. It is designed to
work with any version of WWIV v4.20 and up.
What does USERSTAT do?
USERSTAT will compile information about the active users of your BBS
and display that information in one of two ways. The first way is to
print a list of the top and bottom active users. The "rating" of
each active user is calculated by one of three different formulas.
1. 'Formula' Ratio = [Upload K + (# of Posts * Post Value)] /
Download K
I particularly like this one because it is sort of an overall rating,
a side effect of this formula is that because the number of logons
does not effect the ratio, users who have been calling longer will
have more posts, and therefore they'll have a higher ratio. So it
rewards longevity as well. The Post Value can be set at run time
with the /k option. If you wanted to really reward posting, you
could run USERSTAT with /k100. This would treat each post as if the
user had uploaded a 100k file. By default, the post value is set to
10K.
2. Up/Download Ratio = Upload K / Download K
This is very straight forward. The ratio is the same number that WWIV
prints out when you press "Y" from the Transfer menu.
3. Post/Logon Ratio = # of Posts / # of Logons
This is also very straight forward.
These text files can then be viewed by your users in the GFILES area.
Installing USERSTAT
Before you run USERSTAT for the first time, you must create a GFILE
area for it with GFILEEDIT or press G at WFC. Name the area
something like User Statistics, and make the directory name USERSTAT.
When you are done, the screen should look like this:
<insert GFILEEDIT screen here>
Now, either shell to DOS or quit the BBS.
You should place the USERSTAT.EXE file in your main BBS directory, as
it needs to be there in order to find the CONFIG.DAT file. This is
the only file that needs to be the main directory.
Now, run USERSTAT as many times as is necessary to create the files
you want. (ie, once for plain output, once for ansi output, once for
ansi output of a table of all users, once for plain output of a table
of all users) On my system I use:
USERSTAT /f /u /p /s [Plain output of each formula top & bottom users]
USERSTAT /f /u /p /s /a [ANSI output of each formula top & bottom users]
USERSTAT /f /u /p /s /t [Plain output of a table of each user - all formulas]
USERSTAT /f /u /p /s /t /a [ANSI output of a table of each user-all formulas]
You might need to add /l1 to reduce the required number of logons
required to be viewed as an active user.
Now, get back into the BBS (I know, this is a pain in the A$$, in
future versions, USERSTAT will automatically create the entry for you)
Now go into the GFILE section you created earlier (press G from the
Main Menu, *NOT* from WFC or //GFILEEDIT) and use A to add the files
to the list.
The first two letters of the file name shows the formula the file contains:
FM - Overall Ratio ('Formula')
UD - Up/Download Ratio
PL - Post to Logon Ratio
The next 5 letters are either RATIO or TABLE.
RATIO is the top and bottom user list.
TABLE is a list of all users.
and then the file extension is either .ANS or .MSG
.MSG files are plain output (no ANSI characters)
.ANS files have ANSI codes in them.
Great! Now, you'll have to create/modify a batch file in order to
automatically update the GFILES on a nightly basis. See the WWIV
documentation to figure this out.
Appendix A:
The command line options for USERSTAT are as follows:
/s Don't count sysop in calculations
/u Generate Upload/Download List
/p Generate Post/Logon List
/f Generate Formula ratio list (my personal favorite)
/lxx Don't count users with less than xx logons
/kxx Count each post as xx K bytes worth of uploads in the Formula List
/d Display Dedication line, and my BBS phone number.
/? Display a small help screen..
/a Generate ANSI messages... (end in .ANS instead of .MSG)
/nxx Print Best & Worst xx users for each group. 1 <= xx <= 99
/t Generate tables of ALL users instead. (/l option still applys)
(/n option does NOT)
Appendix B:
In the past there has been some confusion as to what exactly USERSTAT
considers as an active user. Well, the criteria are different for
the Post/Logon formula then for the Up/Download or Overall ratios.
First, USERSTAT checks the number of logons, if a user logged on at
least the specified number of logons, he is not considered active.
Second, if the /s option was used, anyone with a SL of 100 or greater
is excluded from the list.
Third, if we are generating a Up/Download or Overall list, the user
must have downloaded at least 1k or uploaded more than 200k.
That's it.
If you have any suggestions, tips, desires, problems, please contact me.
And please, register this software!
Marc A. Runkel
502@1 (WWIVnet) or procha@titan.ucs.umass.edu (InterNet)
You can contact me at my BBS:
Fred's Floating Bar and Grill (413) 586-2099 1200/2400/9600/14.4k
US Robotics Dual Standard Modem NO RATIOS! EVER!
Peace.