
            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 MailExtr
------------------------

MailExtr is a addon for Microsoft Mail and Windows for Workgroups.

Its purpose is to poll MS Mail for messages send to it and if it got
one, copy the attachments to a directory of your choice and as an
option, notify another user via a message.

In conjunction with MailSend, you can make automatic data transfers
between postoffices.



System Requirements
-------------------
  DOS 3.3 or higher
  Microsoft Mail, version 3.0 or above or
  Windows for Workgroups, versions 3.1 or above



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

MailExtr requires a user mailbox on your Microsoft Mail system in order
to work with Microsoft Mail. You have to create this mailbox before
installing MailExtr.

On a Microsoft Mail Postoffice this is done via ADMIN.EXE, whereas
in Windows for Workgroup without the postoffice upgrade you use
"Postoffice Manager".

We suggest, that you use "MailExtr" as the mailbox
name and "MailExtr at <fill in your postoffice>" as the alias.
Using "at postoffice" will make it simpler to select the right MailExtr
in the address book.

Further create a directory on your server and copy MAILEXTR.EXE,
APPGET.EXE and APPPUT.EXE into this directory. We suggest that you make
a directory called MailExtr below your MAILEXE, so its clear that
MailExtr belongs to MS Mail.


Arguments
---------

MailExtr uses the following arguments:

-f<Mailbox>          Mailbox name
-p<Password>         Mailbox password (default no password)
-d<Drive>            Drive where MailData is located (default drive M)
                     or full path to MailData with trailing backslash
                     like M:\MAILDATA\

-e<Path>             Path where an attached files will be extracted

-t<Dest>             Destination address in full Microsoft format
                     which get notified when a file arrives
                     (Network/Postoffice/User)
                     Multiply addresses are allowed

-@<ArgFile>          Read additional argument from a file (-qFILE.EXT)
                     (each argument requries one line)

Samples:
   MailExtr -fMailExtr -pPassword -dM -tNet/Post/Rick -eH:\IN
   MailExtr -fMailExtr -pPassword -@ARG.TXT


   Sample ARG.TXT
   --------------

   -dM
   -tNet/Post/Rick
   -eH:\IN
   <End of file>


Return Codes
------------

MailExtr supports the following return codes (errorlevel):

   0   No message waiting
   1   Send or recive error
   2   Message found


Polling
-------

In order to work, MailExtr has to poll MS Mail for messages from time to
time. This can be done in two different ways.

If you have Microsoft Mail Postoffice than you have a maschine which
runs EXTERNAL.EXE. You can put MailExtr in a loop with External and
so MailExtr will be called periodic.

A sample batch file may look like:

@echo off
:Start

   rem Change to MailExtr directory
   cd MailExtr

   rem Execute MailExtr
   MailExtr -fPingPong -pPassword -dM

   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


You can also run MailExtr in the background of Windows. A special
programm, MAILWAIT.EXE is included for this porpose. MailWait accepts one
argument and this is the time to wait in seconds. MailWait is designed
so that it releases all recources to Windows and runs smoothly in the
background.


A sample batch file may look like:

@echo off
:Start

   rem Change to MailExtr directory
   cd MailExtr

   rem Execute MailExtr
   MailExtr -fPingPong -pPassword -dM

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

   rem Call MailWait for 900 seconds (= 15 minutes)
   MailWait 900

   rem Check MailWaits errorlevel to find out if the
   rem operator pressed  ESC
   if errorlevel 1 goto End
   goto Start
:End


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

    MailExtr (c) is copyrighted 1993-1995 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 MailExtr 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 MailExtr (the program)
    on a single computer 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.


