                             RCS Mystic Log Backup
                                   Ver 1.0


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 MUTIL.LOG file, 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 MUTIL.LOG
file, remains in the mystic\logs directory, but is 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 called MUTIL.BAK. This file
contains only the portion of the MUTIL.LOG that happened during that day.

                       -=-= 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 :)
mutil.bak       -  File created by the program in Mystic directory

                            -=-= 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 MUTIL.LOG file 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 MUTIL.LOG file. On my system,
I run it with the following command line. It maintains 30 days of information
in the MUTIL.LOG, which is roughly 70 Meg, at loglevel 3.

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

