                                Logger 1.6

                        Written by David E. Basile

                               for PCB 14.5a


First things first!  I would like to thank these Sysops who took the time and
effort to test Logger and help with debugging and suggestions.  If you get a
chance give their boards a call.

Didier Dore                                 Jay Ward
-= DID'BBS =- Les 20 Derniers Appels        2112 BBS
Paris France 1200-38.4k                     Myrtle Beach, SC
+33 14 02 18891                             803-272-2856 1200-38.4k

Ed Boston                                   Fred McClaren
Phantasia BBS                               True Blue BBS
Boise, IA                                   Chesterfield, MO
208-939-1350, v.32bis                       314-434-4236 14,400 V.32bis

Mark Williams
The Servant's Quarters BBS
Markham, Ontario, Canada
(416) 471-7232 @ 2400 baud
(416) 471-5213 @ 14/4 HST

Description:

Logger is a program I put together for our BBS.  I wanted something that
was configurable, looked good, and I didn't feel like registering another
program. I hope I accomplished this.  All it does is create a file of the
last callers that can be used as a bulletin or displayed each time a user
logs on to your board.  You can also use the Super User Select feature
which will put a tag by the users name using certain select criteria.  It
also allows you to exempt users from the log after they have logged on so
many times.  Handy for the Co-sysop that logs on 8 times, one right after
another.  It is totally Sysop configurable.  It is also designed to work
with the $$LOGOFF.BAT too.  It does have some LIMITED Multi Language
support.  You can create a file that will change the heading names to what
ever language you choose but only 1 can be used.  I have enclosed one for
French and Canadian.  This will update the time used by the user.  I am no
writer as you can probably tell by this documentation so if you get a
headache after reading this then use the LogSetUp program which will make
it MUCH easier to configure.

**Note: If you are using a previous version of Logger you might want to
delete your bulletin so it will look correct.  No harm if you don't but it
may look a bit funny until the first XX number of callers are selected.


Setup:

Run LogSetup and follow the prompts!


The finished product will look like this:

                      The GALAXY BBS Last 10 callers

Time   Time Date                                                            
 on    used       User                   City / State         Speed    Node
===== ===== ===== ====================== ==================== ======== ====

16:00 00:14 04-14*David Basile           Fort Rucker, Al      14400       1
15:59 On-Ln 04-14*Larry Boid             Detroit, Mi           2400       2
15:35 01:17 04-14 Roger Ramjet           Culver City, In       2400       3
14:21 00:60 04-14 John Doe               San Diego, Ca         1200       2

===========================================================================
     [*] - Denotes users that have uploaded 50 or more files!
           A Special thanks from the Sysop.  Thanks for the support.

                   Logger v1.6 Copyright David E. Basile

The On-Ln in the Time Used field means the user is still on line.  Once
they have logged off this field will be updated.

$$Logon.bat:  You will need to create a $$LOGON.BAT if you don't already
have one.  You can put Logger anywhere in your path but you must execute it
from the directory with the PCBOARD.SYS file and you must give it the
location of configuration file.
     
     $$LOGON.BAT
     @ECHO OFF
     LOGGER C:\UTIL\LOGGER.CFG

$$Logoff.bat

     $$LOGOFF.BAT
     @ECHO OFF
     LOGGER C:\UTIL\LOGGER.CFG OFF


Don't forget to put the OFF in the $$LOGOFF.BAT or it will never update the
users time on.

Viewing the file:

On our board we wanted the users to see the last callers every time they
logged on.  If you wish to do this here is the setup we used.  Go into
PCBSetup and make sure on File Locations 1 you have a path for your
security files.  I didn't want to crowd the \PCB\GEN directory so I made a
directory called SECURITY.  Next I set up logger to create my file
C:\PCB\SECURITY\LASTCALL.   I then created a security file for each
security level we have on the board.  The level 15 file looks like this:
%C:\PCB\SECURITY\LASTCALL.  I just copied 15 to each level that I had. 
Remember if you already have security files you will have to edit them and
not create a new one.  If this is your case you might not want to use the
@CLS@ flag.  Now every time a user logs on they will get the Last Callers
bulletin.  Again if you select to log the last 50 calls then you might not
want to use the security file method because your users will have to go
through several screens.  If you are not sure how to use a security file
consult your PCB Manual, Chapter 12, page 219-220.

The caller on the bottom of the list is pushed off, if you have reached
your limit and the new user is placed on top.

If you want to have a log on screen as described above and a bulletin then
you have 2 choices.  The first one is to make 2 Logger.Cfg files or copy
the log on screen to the bulletin.  Here is an example of both:

     Two Logger.Cfg files

     $$LOGON.BAT
     @ECHO OFF
     LOGGER C:\UTIL\LOGGER.CFG
     LOGGER C:\UTIL\LOGGER1.CFG

     Coping the bulletin

     $$LOGON.BAT
     @ECHO OFF
     LOGGER C:\UTIL\LOGGER.CFG
     COPY C:\PCB\SECURITY\LASTCALL C:\PCB\GEN\BLT99

The 2 configuration files are probably the best.  This way you can
configure 1 with certain features and the other one with no features.  It
is up to you.  Also you can have create 2 separate bulletins, one for log
on and the other for your bulletin menu.

Bugs:
The sysops listed in the first part of this doc helped test and debug
Logger.  It is very possible that you might stumble across a bug the we
didn't know existed.  If this happens please let me know.

Support:
If you have problems, suggestions or just would like to have a feature
added you can contact me at the GALAXY BBS in Daleville Alabama.  Node 1
205-598-9509 HST Dual Standard, Node 2 205-598-6547 HST Dual Standard.  I'm
in the U.S. Army and am scheduled to leave Fort Rucker, AL in October of
1992 to go to Alaska.  I will still support Logger but will be doing it
long distance.  So if you have suggestions or problems after October,
replies could be delayed because of my move.

Registration:
NONE.  It is free.  Not crippled nor does it say UNREGISTERED anywhere so
feel free to use it as long as you want.

Guarantee:
NONE.  Use it at your own risk.  It works fine for us.

License Agreement:
Consult your physician before starting this program.  Batteries not
included.  May cause drowsiness.  Must be over 17.  Not available in all
states.  Not responsible for acts of God.  Prices subject to change.  Proof
of purchase required.  Read label before using.  Some assembly required. 
Not responsible for typographical errors.  Some restrictions apply. 
Subject to local regulation.  Warrantee period limited.  Close cover before
striking.  No resemblance to any person, living or dead, is intended. 
Subject to availability.  No COD's.  Sales tax not included.  Local
restrictions may apply.  Shipping & handling extra.  All orders subject to
review.  For external use only.  Do not give to children under 8 years of
age.  May cause excitability.  Avoid alcoholic beverages while using this
software.  Use caution while operating mechanical devices.  If symptoms
persist, consult your physician.  Keep this and all software out of the
reach of children.  May be unsuitable for sensitive people.  Parental
guidance suggested.  Do not use this software if you are currently taking a
drug for depression.  Neither the seller not the manufacture will be liable
for any brain damage arising from the use of this software.  The buyer
assumes all risks associated with using this product.  In case of
irritation, flush eyes with cold water and consult your physician.  This
software is not a savings account and is not insured by the Federal Deposit
Insurance Corporation.  Use with adequate ventilation.  Avoid prolonged or
repeated contact with skin.  Contents under pressure; do not puncture or
incinerate.  Store in original containers.  Always replace sleeve before
discarding any computer disk.  Get medical attention if symptoms persist. 
Harmful if swallowed.  Do not remain in enclose areas after use.  Not
responsible if you've fallen and can't get up.  So there!


Future Enhancements: ???  I really believe I've done all I can with this
program but if someone needs something added just let me know and I will
try to do my best add it.

