
    .:::::::::::::::::::::::::::::::.
    ::                             ::
.-= :: SAD-MESSAGEBASE DEFRAG v1.o :: =---[%] ©1996 fLi7e / SAD [%]-------.
|   ::                             ::                                     |
|   ·:::::::::::::::::::::::::::::::·                                     |
|                                                                         |
`-----------------------------------------[%] English Documentation [%]---'

 What is this for
 ~~~~~~~~~~~~~~~~
 Messagebase Defrag (MBD from now on) will clean up ALL your message bases
 from old messages and attached files.

 You can tell MBD for how many days you wanna store messages before killing
 them just like in filedir mover tools.





 How to use
 ~~~~~~~~~~
 If you use MBD the first time it`ll create a configfile S:MSGBDEFRAG.cfg
 in which all your conference locations are stored!

 The configfile looks like this:

 NUM=4
 LOC.1=bbs:amiga/msgbase
 LOC.2=bbs:aminet/msgbase
 LOC.3=bbs:pc/msgbase
 LOC.4=bbs:aetools/msgbase

 If you want to not delete messages in special conferences just open this
 file and remove the conferences you don`t wan`t to use! Be sure that the
 numbering of LOC.x is from 1-x without missing number and enter the
 highest LOC. number at the top keyword NUM=.

 If you changed anything in your bbs, eg. you removed/added a conference
 you can start MBD with the -C keyword. -C = Create Configfile.

 >>> SAD-MBD.exe -C

 After the new NEW configfile has been created MDB will quit and NOT process
 the MAIL DELETE as you may want to change some conferences by your own!

 If you run MBD to DELETE mails the command parsing is like this:

 >>> SAD-MBD.exe <number of days back>

 e.g.: SAD-MBD.exe 28 - will delete all messages beeing older 28 days in
                        ALL conferences specified in the Configfile in S:.





 Known bugs
 ~~~~~~~~~~
 As i tested this small tool for about 1 1/2 months now i surely can report
 NO bugs at all. But as i`m not god, maybe you`ll find sum .. dunno ... If
 summit`ll went wrong with it ... just post me a fast email stateing the bug
 and i`ll try to fix it!





 Technical Properties
 ~~~~~~~~~~~~~~~~~~~~
 As MBD is a 100% arexx code you may find it slow! But lemme say that i use
 librarys to enhance some speed and file deleting can`t be done faster as
 i use the DELETE commands from the DOS_ routines and mainly NOT the DELETE
 command from C: ...





 Requirements
 ~~~~~~~~~~~~
 Rexxtricks.library
 Rexxsupport.library
 A running bbs
 Some MSGBASE directorys
 Lotsa old mails to be deleted!





 What to come in future versions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 DEEP SCAN: This option will go through the HEADERFILE of each msgbase and
            will check for the RECEIVED flag set. So if the msg is not that
            old but has been received but the user did not delete it, MBD 
            will do the job for you.

            As this option will take lotsa time on HUGHE msgbases it`s
            recomned that you use this just once a month!

 MAILSTORE: This option will let you PACK the messages to be deleted. This
            Option is also a TIME EATING one as i read out the MESSAGE DATAS
            like SENDER / RECEIVER / MESSAGE SUBJECT ... and put these datas
            as HEADERFILES to the msg itself before packing them. All MSG`s
            concerning the same receiver will be seperately packed as LZX or
            LHA and send as MSG (haha) to the user to DL. This message will
            have a subject MBD will check for in DEEP SCAN and will delete
            it without re-packing it again.

            You see .. a heavy one which may take a while .. But this will
            keep all clean and your user(s) may become motivated to DELETE
            their messages if received!





 History
 ~~~~~~~
 {vo.1} - Able to scan one conference and DETECT old mails.

 {vo.3} - Fixed a DATE CALCULATING problem which bugged somehow sometimes.
          Added DELETE MSGS instead of only DETECT old messages.

 {vo.5} - Added the CONFIGURATION file for multi conf usage.

 {v1.o} - Added the -C option to RE-CONFIGURE MBD automatically.
          Added a VIEWABLE output.

          -= FIRST PUBLIC RELEASE =-
