
            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.

MailExtr polls MS Mail for messages sent to it and if it gets
one, copys the attachments to a directory of your choice and, as an
option, notify another user via a message.

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



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

  DOS   version :  DOS 3.3
  Win16 version :  Windows 3.1
  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 or
  Microsoft Exchange 4.0 or
  MAPI.DLL ( optional in Win16 version ) or
  MAPI32.DLL ( optional in Win32 version )


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


  - Create a directory of your choice copy MAILEXTR.EXE into this
    directory.

  - Start ADMIN.EXE or "Postoffice Manager" to create a mailbox
    for which acts as a default mailbox. We suggest that you use
    "MailExtr" as the mailbox name.
    Creating a mailbox is optional, but it it makes testing easy.

  - Use your editor to create a MAILEXTR.DEF file for your common used
    arguments (see section "Using MAILEXTR.DEF").


Arguments
---------

MailExtr uses the following arguments:


-mt                  Use MAPI as transport service
                     ( Win16 and Win32 version only )


-f<Mailbox>          Mailbox name
                     or transport service name of you use the Exchange
                     Client and MAPI (-mt)

                     Note: Argument is not necessary if you use MAPI (-mt).


-p<Password>         Mailbox password (default = no password)

                     Note: Argument is not necessary if you use MAPI (-mt).


-d<Drive>            Drive where MailData is located (default drive M)
                     or full path to MailData.

                     Note: Argument is not necessary if you use MAPI (-mt).


-e<Path>             Path where an attached file will be extracted to

-t<Dest>             Destination address in full Microsoft format
                     (Network/Postoffice/User) or in the format your
                     gateway requires it. Multiple addresses are allowed.

                     Note: When using MAPI (-mt) on a Windows NT
                           machine running MSMail for NT, the user part
                           of the address is case sensitive.


-@<ArgFile>          Read additional argument from a file (-@FILE.EXT)

                     You can create the file with your editor or
                     with NotePad and write one line for every argument.
                     ( see example for ARG.TXT below )

Examples:


   To extract mail from MailExtr with a password of PASSWORD, save
   attachments into H:\IN and send an info message to Rick
   (located on Network NET and postoffice POST)
   and your maildrive is M: use the following:

   MailExtr -fMailExtr -pPassword -dM -tNet/Post/Rick -eH:\IN

   Same as above but using a ARG file:

   MailExtr -fMailExtr -pPassword -@ARG.TXT

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

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



Using MAILEXTR.DEF
------------------

Every time MAILEXTR starts its looks for MAILEXTR.DEF in the directory
where MAILEXTR.EXE resides. MAILEXTR.DEF can be used to provide MAILEXTR
with default arguments. If your postoffice is always at the same
drive its a good idea to use a MAILEXTR.DEF to use your drive as the
default.

You can create MAILEXTR.DEF with your editor or with NotePad and
write one line for every argument.

Here is a sample MAILEXTR.DEF:

   -dM
   <End of file>



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

MailExtr supports the following return codes (errorlevel):

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



Polling
-------

In order to work, MailExtr has to poll MS Mail for messages from time to
time. As good way to do this is to run MailExtr in a loop with
EXTERNAL.EXE.

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


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

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


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

You will find the lastest version of MailExtr on

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

Filenames are:

   MaExtDOS.ZIP   DOS   Version
   MaExtW16.ZIP   Win16 Version
   MaExtW32.ZIP   Win32 Version
   MaExtOS2.ZIP   OS/2  Version


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

    MailExtr (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 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.
    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            Released

v3.01  96-05-15  If "TEMP" enviroment variable points to an invalid
                 directory MailExt uses now the directory where the EXE
                 resides. If this also fails, MailExtr uses the current
                 directory.

                 MailExtr ( Win32 ) detects now a system shutdown,
                 a logoff or a close event and terminates

v3.02  96-05-20  Fixed a bug where MailExtr does not set user count.

v3.03  96-06-06  Logon sequence optimized for Exchange Client
                 Profile for Exchange can now be used in -f parameter

