
            DataEnter, Michael Kocum
            Taborstrasse 27/23
            A-1020 Vienna
            AUSTRIA

        CIS: 70143,1667
        MHS: MICHAEL @ DEMK (via CSERVE)
   Internet: michael@demk.co.at
        Fax: +43/1/2143829





Introduction to MailRed
------------------------

MailRed redirects messages from a mailbox to another address
and/or sends absent notifications (out-of-office messages).

MailRed preserves the sender's address and is fully message driven.

Once installed users can start and stop redirection by simply sending
messages with commands to MailRed.

Also included is a Windows Client (MRClient.EXE) which is a simple point
and click interface to MailRed.

MailRed is avilable in English, German and French for
DOS, OS/2, Windows 95 and Windows NT.



Some suggestions as to what you can do:

 - Send an absent notification so that everyone knows you are out of
   office

 - Redirect mail from the Admin mailbox to a real user

 - Redirect mail for an out-of-office user to another person

 - Redirect mail from a virtual mailbox like "Sales" or "Support" to
   a real person

 - Redirect mail for a user to his/her Compuserve account
   (Gateway required)

 - Redirect mail for a user to the Internet
   (Gateway required)

 - Redirect mail for a user to a fax machine
   (FAX Gateway required)



System Requirements
-------------------

  DOS   version :  DOS 3.3
  Win32 version :  Windows NT 3.1 or Windows 95
  OS/2  version :  OS/2 2.x

  Microsoft Mail, version 3.2 or
  Windows for Workgroups


Installation
------------

   1) MailRed two things:
      Firstly it redirects mail from one mailbox to another address, where
      the address can be another mailbox or any other valid MS Mail address.
      To do this, MailRed logs into MSMail as the mailbox and resends
      the mail to the redirection address.

      Secondly, it processes script files that users sent to MailRed and
      builds a routing table, so that MailRed knows which mailbox to
      check and to whom it should redirect the messages.

      MailRed also needs a person who is responsible for its correct
      operation. Any time MailRed processes a script or when it detects
      an error, it sends a message to this person's mailbox.
      The address of this person is located in the INI file under
      "Admin". This is not the same as "Admin" in your MS Mail
      environment and it should be a real person who accesses their mail
      regularly.


   2) MailRed requires a single user mailbox on your Microsoft Mail
      system in order to work with Microsoft Mail.
      You have to create this mailbox before installing MailRed. On a
      Microsoft Mail Postoffice this is done via ADMIN.EXE.

      MailRed needs this mailbox for communcation with the users on your
      postoffice.

      We suggest that you use "MailRed" as the mailbox name and
      "MailRed" as the alias.

      Note: No other person should use this mailbox!!!
            Do not use the real Admin's mailbox for this purpose,
            because MailRed seems to work but in fact doesn't.


   3) Create a directory on your server and copy MailRed.EXE and
      MailRed.INI into it.
      We suggest that you create a directory called MailRed below your
      MAILEXE, so it is clear that MailRed belongs to MS Mail.

      Note: If you want to run MailRed as a Service on Microsoft NT, you
            need to install it on a local drive. For more information
            about MailRed as a Service read the section
            "Installing MailRed as a Microsoft NT Service" below.



   4) Edit MailRed.INI and change the configuration so that it will fit
      your needs.

      MailFax.INI is plain ASCII file where each option is on a different
      line. It is similar to your WIN.INI.


The options are:
----------------

MailDrive=<drive>                <drive> is the drive or path where your
                                 mail database is located. If you have
                                 more than one postoffice, add a line
                                 for every postoffice.
                                 The first line has to be the drive
                                 where MailRed's mailbox is located.
                                 (The one you created in step 2)

                                 <drive> can also be the full path or
                                 UNC name like M:\MAILDATA or
                                 \\SERVER\SHARENAME


                           Note: If you want to run MailRed as a Windows
                                 NT Service and your postoffice is not
                                 local, you need to use UNC.

                                 If your postoffice is local, you need
                                 to use C:\MAILDATA or C:\AGPO or
                                 C:\WGPO or whatever directory your
                                 postoffice is located.


MailBox=<mailbox>                <mailbox> is the mailbox which MailRed
                                 should use. Its the mailbox you created
                                 in step 2.

Password=<password>              <password> is the password for the
                                 mailbox you created in step 2.

Admin=<MSAddress>                <MSAddress> is the full MS address of
                                 MailRed's Admin. MailRed will send
                                 error reports (mostly attempts with a
                                 wrong passwords) to this address. A
                                 sample address is:
                                 YOURNETWORK/YOURPOSTOFFICE/YOURNAME

HelpFile=<file>                  <file> is the file which MailRed sends
                                 to the user if it receives a message
                                 with HELP in the subject or body of the
                                 message.

WriteLogFile=<logical>           If <logical> is True, MailRed will
                                 write a log file called MRYYMMDD.LOG,
                                 where YY is the year, MM is the month
                                 and DD is the day.

LogPath=<path>                   <path> is path where MailRed will
                                 write the log file. If <path> is empty,
                                 MailRed writes the log into the
                                 directory where MailRed.EXE resides.

Verbose=<logical>                If <logical> is True, MailRed displays
                                 and log everything, whereas if
                                 <logical> is False, it will display and
                                 log only if there is a real action.

WriteStatisticFile=<logical>     If <logical> is True, MailRed will
                                 write a statistic file called
                                 MRYYMMDD.CSV, where YY is the year, MM
                                 is the month and DD is the day.

                                 You can use Excel or any other program
                                 which imports delimited text files, to
                                 run your statistics.


StatisticPath=<path>             <path> is path where MailRed will write
                                 the statistic file. If <path> is empty,
                                 MailRed writes the statistic into the
                                 directory where MailRed.EXE resides.


Language=<language>              If <language> is ENG, MailRed uses
                                 English for all its messages and log
                                 files.

                                 Supported values for <language> are

                                 ENG      English
                                 DEU      German
                                 FRA      French


DetectInfiniteLoop=<logical>     If <logical> is True, MailRed will
                                 check each redirection for an infinite
                                 loop and will send a message to Admin
                                 if it detects one.

                                 A infinite loop is when "A" redirects
                                 to "B", "B" redirects to "C" and "C"
                                 redirects back to "A".

                                 Without detecting the infinite loop,
                                 MailRed would redirect every message
                                 from "A" to "B", then to "C" and then
                                 back to "A", which results in a lot of
                                 network traffic and fills the mailbox
                                 if the keep option is activated.

                           Note: MailRed checks only for a postoffice
                                 address, not for gateway address. So it
                                 would not detect infinite loops when a
                                 gateway is involved.


InfoMsgAsCCToAdmin=<logical>     If <logical> is True, MailRed will send
                                 a CC to admin for every system message
                                 sent to a user (status sheet and so on).


RedirToSender=<logical>          If <logical> is False, MailRed will
                                 check if the sender address is the same
                                 as the redirection address.

                                 If so, MailRed will not redirect the
                                 messages and keeps a copy of the
                                 message in the mailbox, even when
                                 message keep is not enabled.


DestroyMailHeader=<logical>      If <logical> is True, MailRed will not
                                 redirect the header of a message.

                                 The header is the first part of the
                                 message text which describes the
                                 routing information about the message
                                 (From,To,CC).

                                 Usualy you see this header only in the
                                 DOS Client of MSMail. The Windows
                                 Client of MSMail destroys the header.


AddRedirHeader=<logical>         If <logical> is True, MailRed will add
                                 a short header to every redirected
                                 message, so that the recipient knows
                                 from which address this message was
                                 redirected. It will show the From, To
                                 and CC's of the original message.


AddRedirHeaderCC=<logical>       If <logical> is False, MailRed will
                                 supress the CC's in the header of the
                                 message.


FastRedir=<logical>              If <logical> is True, MailRed will try
                                 to do a fast redirection.

                                 In a fast redirection, MailRed does not
                                 touch the message at all, it simply
                                 moves a pointer inside MSMail's
                                 database to point to another user.

                                 A fast redirection uses less network
                                 resources, because no files are
                                 written.

                                 MailRed checks every message if it can
                                 do a fast redirection and if there is
                                 something in the messages which makes a
                                 fast redirection impossible, it will
                                 continue with normal redirection.

                                 To qualify a message for fast
                                 redirection, the sender, all to's and
                                 CC's and the new recipient need to be
                                 on the same postoffice.

                           Note: DestroyMailHeader and AddRedirHeader
                                 are not applicable in fast mode,
                                 because MailRed does not touch the
                                 message.


StatusAllAsFile=<logical>        If <logical> is True, MailRed will
                                 convert STATUS ALL messages to a file
                                 and send it as an attachment.

                                 If <logical> is False, MailRed will
                                 send it as a note text.


ExcludeGateway=<gateway>         If <gateway> is given, MailRed will not
                                 redirect any messages to this gateway.

                                 For every gateway you want to exclude
                                 add one line. Assume you want to
                                 exclude your Fax, your MHS and your
                                 SMTP gateway, add three lines, each
                                 with the gateway you want to exclude,
                                 like:

                                 ExcludeGateway=FAX
                                 ExcludeGateway=MHS
                                 ExcludeGateway=SMTP


AbsentExcludeGateway=<gateway>   If <gateway> is given, MailRed will not
                                 send absent messages to this gateway.

                                 For every gateway you want to exclude
                                 add one line. Assume you want to
                                 exclude your Fax, your MHS and your
                                 SMTP gateway, add three lines, each
                                 with the gateway you want to exclude,
                                 like:

                                 AbsentExcludeGateway=FAX
                                 AbsentExcludeGateway=MHS
                                 AbsentExcludeGateway=SMTP


AbsentExcludeAddress=<address>   If <address> is given, MailRed will not
                                 send absent messages to this address.

                                 For every address you want to exclude
                                 add one line. Assume you want to
                                 exclude a Internet mailing list add
                                 line with the address you want, like

             AbsentExcludeAddress=SMTP:MSMAIL-L@YaleVM.CIS.Yale.Edu


SendAbsentEvery=<minutes>        <minutes> is the count of minutes that
                                 MailRed waits before sending a second
                                 absent notification to the same
                                 address.

                                 <minutes> default to 0, which means
                                 that every time a absent message is
                                 sent.

                                 Assume you want an absent notification
                                 only once a day to an address, add the line

                                 SendAbsentEvery=1440


ExcludeSubject=<text>            If <text> is at any place in the
                                 subject, MailRed will not redirect the
                                 messages.

                                 For every text you want to exclude add
                                 one line. Assume you want to exclude
                                 all messages with a subject of
                                 confidential or secret, add the lines

                                 ExcludeSubject=confidential
                                 ExcludeSubject=secret


SingleCycle=<logical>            If <logical> is True, MailRed will run
                                 only a single cycle and exits
                                 thereafter. This is usefull if you want
                                 to run MailRed and External on one DOS
                                 maschine.


Interval=<seconds>               <seconds> is the count of seconds that
                                 MailRed waits between processing
                                 messages.


BreakTime=<time>                 <time> is time when MailRed stops
                                 working and exits.
                                 The format of time is HH:MM

                                 Assume you want to stop MailRed at
                                 2:00pm, use

                                 BreakTime=14:00


BreakRelative=<string>           <string> is time and day relative to
                                 the start of MailRed, when MailRed stops
                                 working and exits.
                                 The format of time is DD:HH:MM , where
                                 DD: is optional.

                                 Assume you want to stop MailRed after
                                 two hours use

                                 BreakRelative=02:00

                                 Assume you want to stop MailRed after
                                 seven days and one hours use

                                 BreakRelative=07:01:00


ScreenMono=<logical>             If <logical> is True, use black and
                                 white for screen output.



   A sample MailRed.INI is included with MailRed.


   5) Edit MailRed.HPL so that it will fit your needs. It lists all
      valid keywords that MailRed accepts. You can translate it to your own
      language as long as the keywords are in English.

   6) Start MailRed and check if there is any error message.

   7) Start MRClient and log in using your mailbox and send a message to
      MailRed (to the mailbox you created in step 2).

      Check the checkbox "Require status sheet about the state of all
      redirections" and send the message.

      Start MailRed, it should send you back a status sheet which will be
      empty because you have not started any redirections yet.

      If you get the status sheet, everything is OK and MailRed shoud work as
      expected.


Using Redirection:
------------------

Note: Below you will find the documentation about the commands you can
      send to MailRed.
      In general it is better to use MRClient, which gives you an easy
      point and click interface and writes the message for you.

      Please refer to MRClient.txt for a documentation about MRClient.


Let's assume the name of your network is NETWORK, the name of postoffice
is POSTOFFICE and your name is RICK. Your address is therefore
NETWORK/POSTOFFICE/RICK. Note the forward slash between network and
postoffice and name. Do not use a back slash or you will get no result.

Let's further assume you want to redirect your mail to ANN.

To start redirection send a message to MailRed with the following
lines in the body of the message:

REDIR      NETWORK/POSTOFFICE/ANN
START
KEEP

The line with REDIR is the redirection address and START means "start
redirecting now" and KEEP means that MailRed shoud keep the messages
(without deleting them) after forwarding. After MailRed gets your message, it
processes the keywords and save the data into its database. MailRed then
sends you a confirmation so that it is clear to you what MailRed has done.

To stop redirection send a message to MailRed with the line
STOP in the body of the message.

MailRed will stop redirection, but will save the redirection address for
the next start command.

You can also redirect another mailbox to an address. This is usefull for
virtual mailboxes like "Sales".

To redirect SALES to ANN send the following messages:

ADDRESS    NETWORK/POSTOFFICE/SALES
PASSWORD   PASSWORD
REDIR      NETWORK/POSTOFFICE/ANN
START      1995-06-13 13:00

The line ADDRESS is the address of the sales mailbox, the one with
PASSWORD is the password of the sales mailbox (not your password), the
line with REDIR is the redirection address and START means "start
redirecting on 06/13/95 at 1:00pm" and as KEEP command is missing,
MailRed will delete the message after redirection.


Using Status:
-------------

When you want to know what redirections are active, simply send a message
with the following line:
STATUS
or if you want to know all redirections MailRed knows about, send
STATUS ALL
MailRed will mail you back a list of redirection(s).


Using Delete:
-------------

DELETE is used to delete a user from MailRed database, mostly because
you deleted the mailbox with ADMIN.EXE and your want to remove the
mailbox from MailRed also.



Running MailRed on the same machine as External
-----------------------------------------------

In order to work, MailRed has to poll MS Mail for messages from time to
time. In NT or OS/2 you can start a task with MailRed and so there is
not problem.

In DOS however, only one program can work at a time. The way it works
under DOS, is to run External and MailRed in a loop. The following batch
file shows how do do it.

Note: You need SingleCycle=True in MailRed.Ini to let it work.


@echo off
:Start

   rem Change to MailRed directory cd MailRed

   rem Execute MailRed MailRed

   rem Change back to directory where External is located
   cd ..

   rem Call External for 15 minutes
   external -BR0:0:15

   rem Check Externals errorlevel to find out if the
   rem operator pressed  ESC
   if errorlevel 66 goto End
   if errorlevel 63 goto Start
   if errorlevel 62 goto End
:End



Installing MailRed as a Microsoft NT Service ( Win32 version only )
-------------------------------------------------------------------

Keep in mind that MailRed needs to reside on a local disk or the Service
Controller can't start. For the samples below, we assume MailRed is
in C:\MAILRED.

Be sure that MailRed is running well in Console Mode and there is no
error, because once you run it as a Service, you cant see a screen and
a problem will only be visible in the log file.


There are two different install methods depending of the location of
your postoffice.


a) Your postoffice is is on a local disk

   Start MailRed one time with an argument of "install",

   i.e. type
   mailred install

   and MailRed will create the service. By default it's an AUTOSTART
   Service and any time your computer is started, MailRed will start.

   You can start and stop MailRed at any time via the "Control Panel".

   Note: In MailRed.Ini, MailDrive= had to point to a local
         directory, NOT to a sharename,

         i.e use  MailDrive=C:\MAILDATA
         and not  MailDrive=M



b) Your postoffice is on a network disk

   Start MailRed one time with an argument of "install",

   i.e. type
   mailred install

   and MailRed will create the service. By default it's an AUTOSTART
   Service and any time your computer is started, MailRed will start.

   Note: Its Before you step to tdo next part its a good idea to create a user
         "MailRed" on your NT machine

   Open "Control Panel", select "Services",
   locate MailRed and press the button labeled "Startup...".

   In section "Log On As" select "This account" and select a
   account (user) which MailRed should use for performing a log on into
   the network.

   The account need to have the right to "Log on as a Service".
   You can set this right when checking "Show Advanced Rights"
   in "User Manager". NT 3.51 does this automatic.
   Also the account needs to be a member of the group "Admin".


   It's a good idea to create a user "MailRed" on your NT machine and
   select this user instead of a human person, because if your ever
   change the password or delete the account, MailRed can't no longer
   log on into the network.

   You can start and stop MailRed at any time via the "Control Panel".

   Note: In MailRed.Ini, MailDrive= had to be an UNC name and not a drive.

         i.e use  MailDrive=\\SERVER\SHARENAME
         and not  MailDrive=M

         because there is no drive mapping for a Service.



Note: After you started MailRed as a Service, verify that MailRed has no
      errors ( i.e. it have access to all your postoffices ).
      You need to take a look into the log file to do this.




Removing MailRed as a Microsoft NT Service ( Win32 version only )
-----------------------------------------------------------------

Start MailRed one time with an argument of "remove",

i.e. type
mailred remove

and MailRed will delete the service.




More information
----------------

Enclosed you will find FAQ.TXT which answers frequently asked questions



Latest Version:
---------------

You will find the lastest version of MailRed on

ftp://ftp.ahub.co.at/demk        or
http://www.ahub.co.at/demk       or
CompuServe, GO PCAPP, LIB 9

Filenames are:

   MaRedDOS.ZIP   DOS   Version
   MaRedW32.ZIP   Win32 Version
   MaRedOS2.ZIP   OS/2  Version




Licensing Agreement
-------------------

    MailRed (c) is copyrighted 1993-1996 by DataEnter, Michael Kocum,
    portions (c) Microsoft Corp.

    This product and its documentation may not, in whole or in part, be
    copied, reproduced, transmitted, transcribed, stored in a retrieval
    system, or translated into any other natural or computer language, in
    any form or by any means whatsoever, be it electronic, mechanical,
    magnetic, optical, manual or otherwise, without the prior written
    consent of DataEnter.

    DataEnter makes no warranty or representation, either expressed or
    implied, with respect to the product MailRed and its
    documentation, their quality, perfomance, merchantability, or fitness
    for a particular purpose. DataEnter reserves the right to revise the
    user's guide and make changes in the content without obligation to
    notify any person or organization of such a change.

    In no event will DataEnter be liable for any direct, indirect,
    special, incidental or consequential damages, real or imagined,
    resulting from the use or purchase of this software.
    Under no circumstances shall DataEnter's liability for damages
    exceed the price paid for the software license.

    Should any remedy hereunder be determined to have failed, all
    limitations of liability and exclusion of damages set forth above
    shall remain in full force and effect.

    The extent of the DataEnter's warranty for the software and its
    documentation is limited to physical defects of the distribution media
    containing the software. Contact DataEnter to obtain return
    authorization for the replacement diskette within 30 days of the
    original date of purchase. Any further statement made by agents,
    employees, distributors or dealers of DataEnter do not constitute
    warranties and are not binding. No employee of DataEnter has the
    authority to modify any portion of this warranty.

    All brand and product names we refer to in the documentation are used
    solely for identification purposes and may be trademarks of other
    companies.

    DataEnter, (the licensor) grants the buyer (the licensee)
    the right to use this copy of MailRed (the program)
    on a single postoffice at a single location as long as the
    licensee complies with the terms of this license.

    The licensor reserves the right to terminate this license if the
    licensee violates any part of the agreement.

    The licensee agrees to make copies of the program only for backup
    purposes. The licensee agrees not to copy the documentation and to
    take all necessary precautions to ensure that the backup copies of the
    software are not distributed to or acquired by other parties.


    Microsoft Mail is a trademark of Microsoft Corp.
    Windows for Workgroups is a trademark of Microsoft Corp.
    Windows NT is a trademark of Microsoft Corp.
    Windows Windows 95 is a trademark of Microsoft Corp.
    OS/2 is a trademark of IBM Corp.


History:
--------

v3.00  96-05-11  Released

v3.01  96-05-13  Fixed a bug when StatusAllAsFile was enabled

v3.02  96-05-14  Access.glb and Access2.glb had to have one user or
                 postoffice is not valid

                 Added check to make sure we have a valid disk access
                 before deleting a redirection

                 Added old Redirection Address to Admin message when
                 a rediretion is deleted

                 If "TEMP" enviroment variable points to an invalid
                 directory MailRed uses now the directory where the EXE
                 resides. If this also fails, MailRed uses the current
                 directory.

v3.03  96-05-20  Fixed a bug where MailRed does not set user count.

v3.04  96-06-06  Fixed a confusing English message
                 Fixed MAILRED.INI example file
                 Removed check for disk access to speed up NT
                 Added cache for database

v3.05  96-06-19  Infinite loop message to admin is sent only once

                 Added full name and address in infinite loop message
                 instead of address only

v3.06  96-06-28  Fixed a memory problem

v3.07  96-06-28  Fixed missing absent files when MailRed was started
                 with an absolute path

