home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
bbs
/
lastcl14.zip
/
LASTCALL.DOC
< prev
next >
Wrap
Text File
|
1993-04-15
|
12KB
|
263 lines
---------------------------------------------------------------------------
LastCallers v1.4 Copyright (c) 1993 by Bryan J. Nylin
Written and compiled in QuickBASIC v4.5
---------------------------------------------------------------------------
LastCallers v1.4 is a utility designed for TriBBS sysops to create a
bulletin showing the latest users to call the BBS. It is compatible
with TriBBS v3.3 and v4.0 (tested on beta #2 so far).
This software is SHAREWARE. You are granted permission to distribute
the LASTCL14 archive freely, provided all the original files are kept
together, and only a nominal fee is charged. The files in this archive
should be:
LASTCALL.DOC This documentation file.
LASTCALL.REG Registration/order form
LASTCALL.EXE Executable program.
LASTCALL.CFG Configuration file
FILE_ID.DIZ Program description for BBS posting.
The result of McAffee's VALIDATE program on LASTCALL.EXE is as follows:
File Name: LASTCALL.EXE
Size: 69,626
Date: 4-15-1993
File Authentication:
Check Method 1 - 7D11
Check Method 2 - 1BFC
If any of these numbers do not match, you have an invalid archive that
might be infected with a virus. Delete the archive and contact the
person or BBS you received it from.
This SHAREWARE program is distributed with the concept that if you find
it useful and continue to use it beyond a 30-day free trial period, you
must send in the $10 registration fee (discounts available when registering
multiple copies and/or additional utilities at the same time).
To help you evaluate the program, no features have been left out of this
shareware release. See the file LASTCALL.REG for the order form.
INSTALLATION INSTRUCTIONS:
-------------------------------------------------------------------------
Step 1. Extract the files from the distribution archive into
your BBS utilities directory. (I use \BBS\UTIL)
Step 2. Make your utilities directory the default (CD \BBS\UTIL)
Step 3. Edit LASTCALL.CFG to match your system configuration.
Each line is documented in a section below.
Step 4. Run LASTCALL with the /R parameter to reset the datafile.
This will create LASTCALL.DAT in your utilities directory.
Step 5. Edit your TriBBS BETWEEN.BAT file to include LASTCALL.
Example:
---------->File starts Here<-------------
cd\bbs\util
LASTCALL /L /E=999
cd\bbs\tribbs
---------->File ends Here<-----------------
Step 6. You are done! The next time a caller logs off and
BETWEEN.BAT is executed, the bulletin is updated.
CONFIGURATION FILE
-------------------------------------------------------------------------
The sample file LASTCALL.CFG included in this archive looks like this:
---------->File starts Here<-------------
bbs=Jet City Connection
log=J:\BBS\TRIBBS\MWORK\CALLERS.LOG
dir=J:\BBS\TRIBBS
max=15
ansi=J:\BBS\tribbs\display\BULLET5.ANS
ascii=J:\BBS\tribbs\display\BULLET5.BBS
---------->File ends Here<-----------------
Each line starts with a TAG and an equal sign. These must be typed
correctly in order for the LASTCALL program to recognize them. It is
not case sensitive, however. Each tag is explained as follows:
bbs= Name of the BBS you want to appear at top of bulletin.
log= File name of caller log to read. LASTCALL looks only at
the last caller in the log file.
dir= Main TriBBS directory (Node 1).
max= Maximum number of lines to print in the bulletin. A
'15' here would indicate to only print the last 15
callers.
ansi= File name and path of the ANSI bulletin to create.
ascii= File name and path of the ASCII bulletin to create.
COMMAND LINE PARAMETERS:
--------------------------------------------------------------------------
Usage: LASTCALL [/F] [/R] [/L] [/E=nnn] [/X] [/?] [/HELP]
Where: /F Forces bulletin output even if last caller was not new.
/R Resets datafile
/L Includes local logons
/E=nnn Excludes callers at or above security level nnn.
/X Excluded calls are deducted from the BBS call totals.
Explanation:
/F Normally, the program only generates the bulletin when
the last caller was a new user. This switch will force
the output regardless of that fact.
/R This switch will cause LASTCALL.DAT to be cleared out
before looking at the log file.
/L Includes local logons. By default local logons are
ignored and not recorded.
/E=nnn Excludes any caller with a security level at or above
'nnn'. Useful to exclude sysop from list when calling
from remote line.
/X Any excluded calls (from /E= or /L switches) are deducted
from the BBS call totals. If you specify the /X switch
and a local logon or other call is excluded, LASTCALL
will deduct 1 from today's call count, and the total count.
There is double checking to make sure it only happens once!
EXAMPLE: LASTCALL /L /E=999
Includes local logons, but excludes any users at level 999
(or above). Handy if there are users other than the sysop
that log on locally that should be on the list. Also
keeps a sysop from being recorded when calling by modem.
LASTCALL.DAT Layout
--------------------------------------------------------------------------
This is a straight forward ASCII file. It was programmed this way for
easy access by the sysop in case it is necessary to edit out a name from
the last caller list. Generally speaking, you can delete records from this
file without causing any problems, any empty space will be taken up the
next time LASTCALL runs. You must BE CAREFUL TO DELETE WHOLE RECORDS.
One record consists of:
Line 1 John Doe User Name
Line 2 01/08/92 Date of first call
Line 3 2400 Baud rate
Line 4 Nowhere, WA City, State
Line 5 21:01 Time On
Line 6 21:30 Time Off
Line 7 - Dropped Carrier ('-'=d/c, ' '=no)
Line 8 1 Node #
Empty records are stored as "Empty, 00/00/00, 0, etc." and are easily
identifiable. If you add or delete from this file, make sure you work
with a GROUP OF 8 LINES ONLY. If you don't, odd results will happen and
you will probably have to run LASTCALL /R to reset the datafile.
Notice the '-' dropped carrier flag. This is a little obscure, but this
character prints directly after the baud rate when the caller dropped
carrier. Since this is not something users generally concern themselves
with, and the amount of data was already pretty jammed, this seemed
sufficient. A sysop can look at the list and see who dropped carrier
very easily (a '2400-' is one that dropped carrier, '2400' was fine).
If you happen to edit Line 7, it should either have a '-' or a space.
If the line is empty or has several blanks the report format will be off.
DESCRIPTION OF OPERATION
--------------------------------------------------------------------------
LASTCALL will open the LASTCALL.DAT file and add all the information
into the DAT file for the last caller. It also opens the USERS.DAT file
in the Node 1 MWORK directory to get the City, State where the caller
is from and their call number. If the number of records in LASTCALL.DAT
exceeds that specified by the "max=" tag in LASTCALL.CFG, the oldest
record will be scrolled off the list.
If the /X switch is specified, LASTCALL will open and write to the
SYSDAT1.DAT file in the main TriBBS directory (to update the call numbers).
VERSION HISTORY
--------------------------------------------------------------------------
v1.4 Released 4-15-93.
- Added /X switch so that certain calls can be excluded from the
BBS call counter (today's calls, total calls).
- Fixed bug related to DOS PATH searching.
v1.3 Released 3-29-93.
- Recognizes users who log on with their alias name.
- Fixed bug where new file reset (/R) didn't create LASTCALL.DAT.
- Fixed bug that didn't report the logon/logoff time correctly
when the user name had a '.' in it.
v1.2 Released 2-15-93.
- Fixed bug caused by long logons where program did not find
the last caller log entry correctly. This often resulted in
error messages, and/or stray letters in the date/time fields.
- Added support for finding .CFG, .KEY, and .DAT files on PATH.
- Enhanced file sharing for multi-node systems. Requires DOS 3.0
or higher, and SHARE.EXE loaded.
- Tested on TriBBS v4.0 beta #2.
v1.1 Released 1-27-93.
- Improved rejection of bad logons recorded in CALLERS.LOG. It
was recording some "...line noise..." users, one word logon
rejections, and so on. It now detects these, does not update
the bulletin, and dumps a record in LASTCALL.ERR for posterity.
- Made a minor change to output columns, take 1 char away from
the caller name and giving it to the calling from column.
- Added registration code validation.
v1.0 Initial release date 1-11-93.
DISCLAIMER
--------------------------------------------------------------------------
This software and accompanying materials are distributed "AS IS" and
without warranty, expressed or implied. No implied warranty exists
for merchantability and/or fitness for any particular purpose. Under
no circumstances shall anyone involved in the creation, production, or
sale of this product be liable for direct, indirect, consequential, or
special damages arising out of any use of this product.
Use of this software beyond the initial 30 day evaluation period is
strictly prohibited.
Once this software is registered, any unauthorized distribution of your
personalized registration code and/or the registration .KEY file will
invalidate your registration key for all releases of this product, and
no product support will be given.
TECHNICAL SUPPORT
--------------------------------------------------------------------------
Support questions can be left, and latest version downloaded
from the author's BBS near Seattle, WA:
Jet City Connection BBS, (206)839-8843, v.32bis, Fido 1:343/140
Messages can also be addressed to Bryan Nylin at:
FidoNet 1:343/140
CompuServe 71441,1420
---------------------------------------------------------------------------
This SHAREWARE program is distributed with the concept that if you find
it useful and continue to use it beyond a 30-day free trial period, you
must send in the $10 registration fee (discounts available when registering
multiple copies and/or additional utilities at the same time).
To help you evaluate the program, no features have been left out of this
shareware release. See the file LASTCALL.REG for the order form.
---------------------------------------------------------------------------