home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
ELIST21.ZIP
/
EASYLIST.DOC
next >
Wrap
Text File
|
1991-11-04
|
12KB
|
397 lines
-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
E a s y L i s t
-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
by Jim Barry
A user list generator for version 2.15+ of Searchlight BBS
version 2.1 (11/4/91)
::::::::::::::::::
::: Overview :::
::::::::::::::::::
Congratulations! You have just unzipped, perhaps, the most powerful
utility program ever written for Searchlight BBS sysops. EasyList is a
program that allows you to generate listings of your users based on
criteria YOU select and output in a format YOU define.
Once you have used the program a few times, you will begin to see the
endless number of possibilities available to you. I hope you find this
program useful, as it cost me a few sleepless nights.
::::::::::::::::
::: Contents :::
::::::::::::::::
The following files should be contained in this .ZIP:
EASYLIST.DOC - The file you are now reading
EASYLIST.EXE - The actual EasyList program
If any of these files are not contained in the file you unzipped, please
contact the SYSOP of the BBS from which you obtained it and ask him to
delete the file. Thanks!
::::::::::::::::::
::: Features :::
::::::::::::::::::
The following is a list of 'features' offered by EasyList:
- Generate lists of your users to the screen, printer, or disk file
- Perform searches on any or all of the following information:
Name, Location, System Type, Phone, Access Level, File Access
Level, Time Limit, Times Called, First Call Date, Last Call Date,
K-Byte Uploaded, K-Byte Downloaded
- Output any or all of the above parameters... in ANY order you choose!
- Page 1 -
::::::::::::::::::::::
::: Installation :::
::::::::::::::::::::::
EasyList need not be placed in your .BBS directory, since you can
specify with the '-p <path>' option the location of you USER.SL2 file.
Therefore, wherever you choose to keep EASYLIST.EXE is fine.
:::::::::::::::
::: Usage :::
:::::::::::::::
--- A few words about "RANGE" Specifications ------------------------
Throughout the "options" documentation, you will be told about specifying
ranges for access levels, dates, File Transfer amounts.
Date Ranges: <date1>,<date2>
8/15/90,10/15/90 (all dates between 2 specified including
8-15-90 and 10-15-90)
8/15/90, (all dates after 8-15-90 including 8-15-90)
,10/15/90 (all dates before 10-15-90 including 10-15-90)
Numeric Ranges: <r1>,<r2>
100,200 (all values between 100 and 200 including
100 and 200)
50, (all values greater than or equal to 50)
,120 (all values less than or equal to 120)
Basically, for a range, you have a starting value and ending value.
<start>,<end>. If either is omitted, it is assumed to have no value.
Range Limits:
-a, -f, -t : 0 to 255
-w, -x, -c : 0 to 65535
---------------------------------------------------------------------
- Page 2 -
Format: EASYLIST [options]
Options:
-a <r1>,<r2> | searches for users whos access level falls
in the range <r1> to <r2>.
Example: EASYLIST -a 50,100
selects users with access 50-100
Example: EASYLIST -a 100,
selects users with access at least 100
-f <r1>,<r2> | searches for users whos file access level falls
within the range <r1> to <r2>.
Example: EASYLIST -f 10,50
selects users with file access 10-50
Example: EASYLIST -f ,100
selects user with file access up to 100
-c <r1>,<r2> | searches users whos total calls falls within
range <r1> to <r2>.
Example: EASYLIST -c 5,50
selects users with total calls between 5 and 50
Example: EASYLIST -c 10,
selects users with total calls of at least 10
-t <r1>,<r2> | searches for users whos time limit falls
in the range <r1> to <r2>.
Example: EASYLIST -t 50,100
selects users with time limit 50-100
Example: EASYLIST -t 100,
selects users with a time limit at least 100
-w <r1>,<r2> | searches for users whos total uploaded k-bytes
falls in the range <r1> to <r2>.
Example: EASYLIST -w 100,1000
selects users who have uploaded between 100K
and 1 Meg
Example: EASYLIST -w 1000,
selects users who have uploaded at least 1 Meg
- Page 3 -
-x <r1>,<r2> | searches for users whos total downloaded k-bytes
falls in the range <r1> to <r2>.
Example: EASYLIST -w 100,1000
selects users who have downloaded between 100K
and 1 Meg
Example: EASYLIST -w 1000,
selects users who have downloaded at least 1 Meg
-s "<string>"[,N,L,S,P] | searches for <string> in Name, Location, or
System Type. Search is NOT case sensitive.
Optional [,N,L,S,P] are for N=name, L=location,
S=system type,P=phone. If no option is given,
searches N,L,S.
Example: EASYLIST -s "cleveland",L,N
displays all users whos Location contains
'cleveland'
Example: EASYLIST -s "ibm"
displays all users whos Name, Location, or System
Type contains 'ibm'
Example: EASYLIST -s "351-8890",P
displays all users whos Phone Number contains
'351-8890'
-n | disables '--more--' prompting
Note, it is not necessary to use this prompt when
using the "-o" command.
Example: EASYLIST -n
-b <n1> | specifies how many lines to print before skipping
a line. Defaults to 0, which is no
blank lines.
Example: EASYLIST -b 3
prints a blank line after every 3 users are
printed
-y <date1>,<date2> | searches for users whos first logon date was
between <date1> and <date2>.
<date> = MM-DD-YY ("/" may be used for "-")
Example: EASYLIST -y ,5-1-90
displays users whos first logon date was BEFORE
or equal to 5/1/90
Example: EASYLIST -y 6-15-90,8/15/90
displays users whos first logon date was between
6-15/90 and 8/15/90.
- Page 4 -
-z <date1>,<date2> | searches for users whos last logon date was
between <date1> and <date2>.
<date> = MM-DD-YY ("/" may be used for "-")
Example: EASYLIST -y ,5-1-90
displays users whos last logon date was BEFORE or
equal to 5/1/90
Example: EASYLIST -y 6-15-90,8/15/90
displays users whos last logon date was between
6-15/90 and 8/15/90.
-l [N,L,Y,Z,C,S, | specifies "layout" of fields for outputting.
P,A,F,T,W,X] You may specify any of up to 12 parameters to
display and may use them more than once.
Valid Fields:
N = User Name P = Phone No
L = Location A = Access Level
Y = First Date On F = File Access Level
Z = Last Date On T = Time Limit
C = Total Calls W = K-byte Uploaded
S = System Type X = K-byte Downloaded
Example: EASYLIST -l N,L,P
displays Name, Location, & Phone Number
Example: EASYLIST -l N,A,N,F
displays Name, Access, Name, & File Access
-o <filespec> | sends output to the specified file or device
Example: EASYLIST -o C:\BBS\USER.LST
writes user list to file named USER.LST in
directory C:\BBS
Example: EASYLIST -o LPT1
writes output to printer connected to LPT1
-p <path> | specifies path to USER.SL2 file
Example: EASYLIST -p C:\BBS
searches for USER.SL2 in C:\BBS
Any of the above commands may be grouped together.
Samples:
Sample #1:
EASYLIST -a 50,100 -f 50,50 -s "akron",L -b 5 -o TEST.TXT
outputs to file TEST.TXT all users whos Access Level is 50-100 AND whos
File Access is 50 AND whos location contains the word 'akron'. Also
outputs with a blank line 5 users.
- Page 5 -
Sample #2:
EASYLIST -a 75, -c 10, -w ,1000 -s "apple",S -l C,Z,N,W,S
outputs to screen all users whos access level is at least 75 and have
called at least 10 times and who have uploaded less than 1000K and whos
System Type contains the word "apple". Outputs Calls, Last-on, Name, K-
bytes Uploaded, System Type.
::::::::::::::::::::
::: Disclaimer :::
::::::::::::::::::::
I have tested this program to the best of my abilities and believe it
to be void of any and all bugs. I attest that when I released this
program, there were no "undocumented" features herein. I give no
warrantees or guarantees as to the correct operation of this software.
I will not be liable for any incidental or consequential damages as a
result of the use of this software.
(I hate writing that kinda stuff)
:::::::::::::::::::::::::
::: Acknowledgments :::
:::::::::::::::::::::::::
- Frank LaRosa, for writing a fabulous BBS program, of which without,
EasyList would have no use.
- Borland International, for providing the world with Turbo Pascal
(EasyList is compiled in Turbo Pascal 5.5)
::::::::::::::::::
::: Farewell :::
::::::::::::::::::
Comments and Suggestions may be mailed to:
C.C.S. Systems
PO Box 35487
Cleveland, OH 44135-0487
And if your really in the mood to get in touch with me, (or at least
the latest release of EasyList), you can call my BBS:
Time Vault BBS (pcp: OHCLE) (Starlink: 4222, 10077)
(216) 951-9150, 8-N-1, 3/12/2400 Baud
And remember: When a program has no bugs... It's obsolete!
- Page 6 -