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

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

Its purpose is to send MS Mail messages from the command line or from
batch files.

Some suggestion what you can do:

-After you overnight backup, send the backup log to your mailbox

-Send your monthly report to you boss

-In a more sophisticated enviroment, you can export data out of your
 application, pass it to MailSend as an attachment. MailSend will send
 it to the destination and there you can use MailExtr to convert it back
 to a file and import it in your application. (In fact, a lot of
 customers make there database updates via MailSend and MailExtr fully
 automated)



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



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

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


Arguments
---------

MailSend uses the following arguments:

-f<Mailbox>          Mailbox name
-p<Password>         Mailbox password (default no password)

-t<Dest>             Destination address in full Microsoft format
                     (Network/Postoffice/User) or in the format your
                     gateway will require it.
                     If you are sending a message to a user in you own
                     postoffice, you can use a simpler addressing format
                     and let MailSend resolving the address. You find
                     more information about resolving addresses in
                     section "Resolving address" below.

                     You can send to multiply addresses by using more
                     than one -t switch.

-s<Subject>          Subject for message (if the subject contains spaces,
                     put it between quotes, like -s'More than one word')

-d<Drive>            Drive where MailData is located (default drive M)
                     or full path to MailData with trailing backslash
                     like M:\MAILDATA\

                     If MailSend does not find a postoffice on the given
                     drive, it will scan all you drives from C: to Z:
                     for a postoffice and uses the first one it finds.

                     If there is still no postoffice found, it will try
                     to find your MSMAIL.INI and read the postoffice
                     drive out of it.

                     In the unlikly event that MailSend can't find the
                     postoffice in this way, it will give you an error.

                     You can start MailSend with the -l option and
                     it will help you finding the postoffice.


-i<ImportFile>       File to import for message body

-a<AttachFile>       File to attach to message (Multiply files are
                     allowed)

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

-l                   Scans your drives for a postoffice

                     If you have no idea where your postoffice is
                     located and MailSend will not find it, you can use
                     this option. After completion, write down the path
                     and use it the next time you send a message.




Samples
-------


   To send mail from Admin with a password of PASSWORD to
   Rick (located on Network NET and postoffice POST) and your maildrive
   is M: use the following.

   MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestmail


   To attach a file to the message:

   MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestMail -aATTACH.XLS

   Same as above with an argument file:

   MailSend -@ARG.TXT

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

   -fAdmin
   -pPassword
   -dM
   -tNet/Post/Rick
   -sTestMail
   -aATTACH.XLS
   <End of file>


Resolving address
-----------------

MailSend can resolve your address to a full address. This is a real
shortcut if you send a message to a user in your own network/postoffice
or if you don't know your network/postoffice. WFW and Win95 users can
always use this option, because there is only one postoffice.

How it works:

When MailSend detects that there is no valid address given, it will take
a look inside the global address book and will try to find an address
with matches you input. First it looks on every mailbox name and then
on every alias name on you postoffice, and if it finds one, its uses its
address.

Assume your network is called "Network" and your postoffice is
"Postoffice" and you want to send to a mailbox "MillerC" with an alias
of "Carl Miller".

The traditional way is to use -tNetwork/Postoffice/MillerC, which ist
the full address of "MillerC".

The shortcut is to use -tMillerC instead of -tNetwork/Postoffice/MillerC

MailSend now searches for a mailbox "MillerC" and resolves the address.

Another way is to use -tCarl Miller or -tCarlMiller
(The space does not care when resolving addresse). In this example
MailSend searches for an alias name of "CarlMiller".

If you know that there is only one alias name starting with "Carl" you
can further trim it down to -tCarl and MailSend will find it.



Sending to gateways and groups
------------------------------

Enclosed you will find additional information from Microsoft's knowledge
base about MSMail addressing schemes (Q94410.TXT) and how to send to a
group (Q119685.TXT)


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

MailSend supports the following return codes (errorlevel):

   0   Message sent
   1   Message not sent




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

    MailSend (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 MailSend 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 MailSend (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.


