home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
EVENTS
/
TOP10-43.ZIP
/
TOP10.DOC
< prev
next >
Wrap
Text File
|
1994-04-11
|
8KB
|
190 lines
Top Ten Posters - Version 4.3 (4/11/94) - by Robert Kish, aka Number One
------------------------------------------------------------------------
Original documentation by Number One, edited by Cecil The Snake.
For WWIV versions 4.22 and 4.23.
Note: This program might not work on some modded versions of WWIV if the
software has modified STATUS.DAT and USER.LST files. This program should
work perfectly with version 4.23. There may be small inaccuracies when this
program is run under WWIV 4.22.
Requirements: This program requires WWIV, so therefore, it is a DOS program.
This program requires an undisclosed amount of RAM, very little hard drive
space, and a half decent processor. This program has been tested under MS-DOS
6.2 and Windows 3.1.
Disclaimer: I am not responsible for damages incurred from running or using
this program. Anything that happens is entirely your fault.
Switches:
D Deletes the data file from the last user online. This is important
to do when running the program as a different user (i.e., a caller
logs on to the system). This switch is necesarry when Top Ten Posters
is run as a Logon Event.
Q This switch *MUST* be used if the Top Ten Posters is only going to be
run as a door and NOT as a logon event. This will make the data file
needed to run Top Ten as only a door, and then end the program without
printing the data at logon. This is used for those SysOps who don't
want the Top Ten List printed at logon.
R Reverse sort order. This is for making the program display the
opposite of the Top Posters, the Worst Posters.
=n= Where 'n' is a user number. This tells how far to go on the list. If
the switch is not used, then the default value will be 10. Changing
this value to 1 will result in displaying only the top poster, or if
the "R" switch is used at the same time, the worst poster. i.e.,
setting the switch =5= will display the top 5 posters of the BBS.
!n! Mainly a debugging switch, this will run Top Ten Posters without the
need of a CHAIN.TXT. 'n' is the user number to run the program as.
So, if you use !2! on the command line, then you are running the
program from the point of view of User #2. This is used to see if the
displaying options as in TOP10.INI are working properly.
C This is used with the !n! switch. Without this switch ANSI colors
will be used when the !n! switch is used. Using this switch will shut
off ANSI colors in the display when the !n! switch is used. This is
here just in case the SysOp wants to test something and does not want
ANSI.
+ This switch adds a call to the user running the program. It is used
in order to adjust the user's calls as some software updates the
user's calls to USER.LST at different times.
- This switch takes away a call to the user running the program.
? This switch turns on the User Interrogation Mode where the user
can either view a scrolling list (in REGISTERED VERSIONS ONLY) or
define his/her own parameters for a normal list. It also makes the
Top Ten list abortable with the space bar.
Note: Using this switch as a log on event can increase the chances of
the BBS hanging if a user decides to hang up in the middle of the
program. This problem is eliminated when the program is run as a
door.
K Enabling this switch will enable the use of SysOp definable colors,
in REGISTERED VERSIONS ONLY.
Setup:
Logon Event:
The basic setup is to put the command line 'TOP10.EXE D' in the Logon Event
slot of INIT.EXE or your Logon batch file. The D is needed to delete
information used from the last user. Without the D parameter, the top ten
lists will become very inaccurate (i.e., negative values for calls). If you
are not going to run Top Ten Posters as a Logon Event, then you must run
'TOP10.EXE Q' in your logon in order to make the required data file needed
incase Top Ten Posters will be run as a door. (See the information included
with the 'Q' switch.) So no matter what you do, you must have a Top Ten
Posters command line in your Logon Event.
Online Program (Door):
Place 'TOP10.EXE' (and any desired switches - no "D" switch as that will
cause problems with the data files) as the command line in CHAINEDIT. Make
sure in that you have 'DOS Interrupt' set to NOT USED. If the DOS interrupt is
used, then the program will not work over the modem. (The SysOp will still see
the program though, but the user would not be able to see or do anything).
Also, make sure that PAUSES are set to OFF.
If you are registered and wish to turn on the User Interrogation Mode, then
place the command line of 'TOP10.EXE ?' in CHAINEDIT.
Top Ten is currently Multi-Instance aware up to two instances. If there
is a need for more instance support, then please contact me. The Multi-node
setting can be set to YES in WWIV version 4.23.
Program Examples:
To use the program as a Top 100 posters:
TOP10.EXE =100=
To do the same but in reverse order:
TOP10.EXE =100=r.
The switches are not case-sensitive so you may use either upper or lower
case and the spacing does not matter either. 'TOP10.EXE r' and 'TOP10.EXE R'
do the exact same thing, as well as 'TOP10.EXE r=2=' and 'TOP10.EXE =2=R.'
TOP10.INI:
This file is required to run the program. Running the program for the first
time, without a TOP10.INI file, will result in the creation of a default file.
This is the file you may want to change to make sure it has the information
specific for your needs. Note that all the lines in the file are necessary.
Do NOT move the lines around in the file. Doing this will result in major
problems.
To configure the TOP10.INI file, make the appropriate changes using any
text editor.
Here is my TOP10.INI file:
1 : c:\wwiv\data\user.lst
2 : c:\wwiv\data\status.dat
3 : c:\wwiv\
4 : Crewmember
5 : 255
6 : 0.28
7 : 3
8 : 4
Line 1 : Path to your USER.LST file.
Line 2 : Path to your STATUS.DAT file.
Line 3 : Path to your main WWIV directory where CHAIN.TXT (or .002)
will be found.
Line 4 : What you would like to call people who use your system. Most
people choose "Users." On my system I call them "Crewmembers."
Line 5 : The SL limit, but not including, which shows up in the list.
For example, if the value of 100 is on that line, then all
users with an SL greater than or equal to 100 will NOT be shown
on the Top Ten list.
Line 6 : The last line is the Post Per Call value which will result in a
change in color if the ratio is or falls below this value. A value
of 0.010 for that line would mean that all those with a Post Per
Call ratio less than or equal to 0.010, would have their post per
call ratio in a different color (assuming ANSI was on). Check
your INIT.EXE to find what you have your PPC Ratio set to.
Line 7 : This is the IRQ value for the modem used in the first instance.
The default settings for COM1 and COM3 are IRQ4, so a value of 4
would be placed on that line if COM1 (or COM3) were was used
for the main line of the BBS. The default for COM2 and COM4 is
IRQ3.
Line 8 : The IRQ value for the second instance (assuming WWIV 4.23). See
above. A value must be present even though a second instance may
not be present.
TOP10ANS.INI:
This file configures the colors for registered SysOps only. It is looked
for when the "K" switch is used. If the file does not exist then the default
colors will be used. The colors are in the file one color per line and remarks
are permitted after the colors. For more information read the comments in
TOP10ANS.INI.
----
If you would like to register this program (which I strongly urge you to
do!), please follow the directions in the REGISTER.NOW file, which is included
with the Top Ten package.
And that's all there is. If you have ANY questions, bug reports, comments,
new ideas to add, or anything, then E-MAIL me (NUMBER ONE) on my board, Ten
Forward (1-609-443-5814).