                            RCS Mystic Log Manager
                                   Ver 1.0a


Black Panther
aka Dan Richter
RCS
Sysop - Castle Rock BBS
telnet://castlerockbbs.com
The sparrows are flying again...


                             -=-= Description =-=-

As a BBS Sysop, you want to be able to look back into the log files kept by
the BBS software. There might have been a problem, where you need to figure
out what caused it. Trying to find that information in a 500 Meg text file
can be challanging, to say the least.

In the Mystic MUTIL.INI file, there is an option of rolling the logs by the
number of days. This, however, keeps large files in the logs directory, with
names such as MUTIL.1.LOG and MUTIL.2.LOG. While I do believe this is a good
beginning, I don't think it goes far enough to make the logs readable when
needed. Which log file would you look at to find what happened last Tuesday?

This program takes the LOG files, and breaks it down into daily logs.
These logs are then placed into their own daily directory. This makes it easy
to find the information you're looking for, when it's needed. The LOG files, 
remain in the mystic\logs directory, but are now smaller in size. The size is 
dependent on the command line parameter you specify when the program is run.

The new directory structure is set up like this:

mystic
     |
     logs
        |
        2017
           |
           June
              |
              1
              2
              3
              ...
           July
              |
              1
              2
              3
              ...etc

Each daily directory will contain a text file for each LOG file. The extension
for each of these will have .LOG. Theses files contain only the portion of the
.LOG that happened during that day.

As of right now, this program does not handle the MIS2.LOG file. This is due
to this log file being automatically rolled into MIS2.1.LOG format, and this
log file does not contain any dates, other than when the server started. If
the format of this log file is changed in the future, this option will be 
added to the list of logs it handles.

                       -=-= Warranties and Guarantees =-=-

While every effort is made to make sure this program does what it is designed
to, and not harm your computer, the only warranty you have, is this program
will take up space on your hard drive. Other than that, I assume no
reponsibility for what happens to your computer due to the use of this
software.

If you do notice a bug in the program, or have a suggestion on how it could
be improved, please feel free to let me know.

                               -=-= Files =

logbakup.exe    -  The main program
logbakup.txt    -  The file your reading right now :)
*.log           -  Files created by the program in Mystic log archives

                            -=-= Installation =-=-

Installation of this program is simple. Copy the logbakup.exe file into your
main mystic directory. (eg. c:\bbs\mystic) This file needs to be located here
so that it can find the .LOG files in the mystic\logs\ directory.

When running this program, it will take one command line parameter. This is
how much information you wish to maintain in the .LOG files. On my system,
I run it with the following command line. It maintains 30 days of information
in the .LOGs.

logbakup 30

By using this command line, you have enough log file for generating a month
long report of your echomail count. (blatent plug for my MECRPT program) ;)

                              -=-= Credits =-=-

I would like to give sincere thanks to the following people
(in no particular order):

g00r00    -  for making, and maintaning an awesome BBS package
Avon      -  for having an great network which provides great support
             and for testing this program during pre-release
GaryCrunk -  for answering some rookie pascal questions
Apam      -  for showing us all that BBS programming is still alive
fsxNet    -  for putting up with my stupid questions and test posts
Cmech     -  for making great looking programs look easy to do :)
Gryphon   -  for porting some awesome games into MPL which got me
             interested in learning Pascal again
xqtr      -  for making some great MPLs - even if most of them won't work
             on Windows :)
fabian    -  for helping me figure out better functions to use
tiny      -  for letting me use some functions he has written

I know I'm forgetting people here. It is not intentional. :)

                            -=-= Change Log =-=-

1.00  -=> First public release version
1.00a -=> Lots of changes. :) Added help for parameters, added log files 
          to be processed. Improved date checking function. added error
          checking for file existance. Will now process the following log
          files: fidopoll, mutil, node#, server_binkp, server_events,
          server_nntp, and server_telnet.

