home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 2 BBS
/
02-BBS.zip
/
lstat220.zip
/
LSTAT.DOC
< prev
next >
Wrap
Text File
|
1994-10-02
|
6KB
|
151 lines
Lstat v2.20 (c) Larry Hannah, 1990-94
A statistics program for Maximus systems. This program is a FREE program,
not be sold at any time.
>>> Revision Note:
Lstat 2.20 changed variable sizes in mstruct.h to match between
memory models.
Lstat 2.18 revised widths on some columns for larger amounts
Lstat 2.16 changed order of some items on page 2.
Lstat 2.14 revised some code due to compiler change.
Lstat 2.12 revised to show uploads/downloads in K (1024) when
amount is over 100,000 Kb.
Lstat 2.10 revised to allow an unlimited number of users.
Lstat 2.08 revised to show uploads/downloads in K (1024) instead
of Kb.
Lstat 2.06 revised to user to control which graphs print.
Lstat 2.04 revised to use user-defined characters for graphs.
Lstat 2.02 revised to increase the number of users from 1,000
to 1,400.
Lstat 2.00 revised to handle large up/download amounts used
in Maximus version 2.0, without sacrificing the use with
previous versions of Max.
Lstat 1.94 fixes an annoying problem of not being able to
put slashes (/) in UserName1 or UserName2.
>>> Syntax:
Lstat [cfgfile]
[cfgfile] is an optional filename that Lstat will try and use
for getting its configuration information. Lstat will
default to "Lstat.cfg".
>>> Requirements:
Lstat uses the USER.BBS file for its information and must be
run when logged on to the directory that contains USER.BBS.
It also uses the BBSTAT??.BBS files to get total information.
Lstat will look for the configuration file in the current
directory, but requires useage of Dos 3.x or higher so it can
find its configuration file if it is kept with the EXE.
>>> Outputs:
Lstat will output two files: Lstat.BBS and Lstat.TXT. Lstat.BBS has
all the Meccafile information for colors, etc. Lstat.TXT is a
plain ASCII text file. See below for information on optional
files that can be output.
>>> Configuration:
An optional configuration file (Lstat.CFG) can be used to
control colors and the "nextfile" that Opus/Maximus displays.
The format for this file is as follows:
[in any order, only include lines that you wish to change,
case insensitive]
OnExit = nextfile
Heading = White / Black
Border = Yellow / Gray
Name = White / Red
Num = Yellow / Red Blink
line1 = black/magenta
line2 = white / green
Omit = John Smith
Omit = Pam Brown
Graph = On
UserName1=My BBS
UserName2= A stupendous Board
GraphChar1 = X
GraphChar2 = ▄
GraphChar3 = ▒
CallGraph = [ ON | TRUE | YES | 1 ] | [ OFF | FALSE | NO | 0 ]
UpldGraph = [ ON | TRUE | YES | 1 ] | [ OFF | FALSE | NO | 0 ]
DnldGraph = [ ON | TRUE | YES | 1 ] | [ OFF | FALSE | NO | 0 ]
[colors must follow the order foreground / background <blink> ]
Colors that can be used are:
foreground: background:
Black Black
Blue Blue
Green Green
Cyan Cyan
Red Red
Magenta Magenta
Brown Brown
Gray Gray
DarkGray
LightBlue
LightGreen
LightCyan
LightRed
LightMagenta
Yellow
White
OMIT is for people that you don't wish shown as being top
uploader/ downloaders. Their figures are still included
in the totals. You can have up to 6 names in the
configuration file, any more will just be ignored.
GRAPH will produce a graphical representation of up to two
weeks of data. To use this effectively, you must run
Lstat every day. The first day that you use graph, a
graph will NOT be generated; only the information will be
added to Lstat.nfo. On the second day and thereafter, a
graph will be generated. Running Lstat a second (or more)
time will not change the graph information or write to
the NFO file until the next day. All graphs are self
scaling.
GRAPHOUT is an option that will output the graph information
to the file named after the '=' sign. This will allow
you to run the graph portion once a day, and Lstat as
many times as you would like throughout the rest of the
day. This will usually be accomplished by keeping two
configuration files, one for once a day, the other for
the rest of the day. Using this format, you can even
change the colours between the statistic and the graph
portions.
USERNAME1 and USERNAME2 are to allow the users to put their
name in the stats. Restricted to a length of 29
characters.
GRAPHCHAR? is used to vary the character that is used in the
graphs for each of the graphs. 1 = CALLS, 2 = UPLOADS,
3 = DOWNLOADS.
CALLGRAPH, UPLDGRAPH, DNLDGRAPH allows you to exclude any or all
of the graphs from output. Default is ON.
>>> If you like the program, or have suggestions:
Send a note to Larry Hannah @ 1:134/17.1
>>> Please Note:
Tim Bellaart (1:134/17) has been kind enough to have
the latest version LSTAT available for File Request
under the magic name "LSTAT".
Special thanks to Scott J. Dudley for making available the
data structures used in Maximus-CBCS.