home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 3 Comm
/
03-Comm.zip
/
masndos2.zip
/
MAILSEND.TXT
< prev
next >
Wrap
Text File
|
1996-11-14
|
14KB
|
412 lines
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/214 38 29
Introduction to MailSend
------------------------
MailSend is a add-on for Microsoft Mail and Windows for Workgroups.
MailSend sends messages from the command line or from batch files.
Some suggestion as to what you can do:
-After you do your overnight backup, send the backup log to your mailbox
-Send your monthly report to your 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 their database updates via MailSend and MailExtr.
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 MAILSEND.EXE into this
directory.
- Use your editor to create a MAILSEND.DEF file for your common used
arguments (see section "Using MAILSEND.DEF").
Arguments
---------
MailSend 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 is no password)
Note: Argument is not necessary if you use MAPI (-mt).
-t<Dest> Destination address in full Microsoft format
or in the format your gateway requires it.
Multiple addresses are allowed.
Format for MSMail 3.x is:
Network/Postoffice/User
Format for Exchange is:
EX:/o=Org/ou=ORGUNIT/cn=Recipients/cn=Mailbox
Note: When using MAPI (-mt) on a Windows NT
machine running MSMail for NT, the user part
of the address is case sensitive.
If you are sending a message to a user on you own
postoffice, you can use a simpler addressing format
and let MailSend resolve the address. You will find
more information about resolving addresses in the
section "Resolving address" below.
You can send to multiply addresses by using more
than one -t switch.
Note: Resolving an address is not available if you
use MAPI (-mt)
-c<Dest> Carbon Copy ( CC ) destination address in full
Microsoft format (Network/Postoffice/User) or in
the format your gateway requires it.
-s<Subject> Subject for message
-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).
If MailSend does not find a postoffice on the given
drive, it will scan all your 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 from 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 bod. If the file size is
more than 32KB it will be converted to an
attachment.
-a<AttachFile> File(s) to attach to message. Multiple files and
wildcards are allowed.
-b<Priority> Priority for the message (1-5 or R for Recipient)
-1 Enable Single To Mode.
In Single To Mode, MailSend sends one message for
every To address ( -t ) and every CC address ( -c )
instead of a single message with all the To's and
CC's. This is useful if you want to send a message
to more that one address, but each recipient should
not see all the other recipients.
-w Wait on exit for a keypress.
Useful if you start MailSend as a second task and
you want to see the screen output before MailSend
exits.
-@<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 )
-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>
Using MAILSEND.DEF
------------------
Every time MailSend starts its looks for MAILSEND.DEF in the directory
where MAILSEND.EXE resides. MAILSEND.DEF can be used to provide MailSend
with default arguments. If your postoffice is always at the same
drive its a good idea to use a MAILSEND.DEF to use your drive as the
default.
You can create MAILSEND.DEF with your editor or with NotePad and
write one line for every argument.
Here is a sample MAILSEND.DEF:
-dM
<End of file>
Resolving address
-----------------
Note: Resolving an address is not available if you use MAPI (-mt)
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 your input. First it looks at every mailbox name and then
at 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 is
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.
Return Codes
------------
MailSend supports the following return codes (errorlevel):
0 Message sent
1 Message not sent
More information
----------------
Enclosed you will find FAQ.TXT which answers frequently asked questions
Latest Version:
---------------
You will find the lastest version of MailSend on
ftp://ftp.ahub.co.at/demk or
http://www.ahub.co.at/demk or
CompuServe, GO PCAPP, LIB 9
Filenames are:
MaSndDOS.ZIP DOS Version
MaSndW16.ZIP Win16 Version
MaSndW32.ZIP Win32 Version
MaSndOS2.ZIP OS/2 Version
Licensing Agreement
-------------------
MailSend (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 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.
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 01.03.96 Fixed a bug in parsing the command line
Fixed online description
v3.02 96-03-27 Removed waitstate on error in DOS, Win32 and OS/2
v3.02a 96-04-08 Retry fileopen to prevent timeout when a lot of messages
are sent
Fixed a bug where deleting a ptr befor a waitstate in
Win16 caused a GPF
v3.02b 96-04-12 Fixed a bug where every address was prefixed with "MS"
in MAPI mode
Fixed a bug causes a GPF when a empty address was given
v3.03 96-04-23 Added support for FFAPI gateways
v3.04 96-05-15 If "TEMP" enviroment variable points to an invalid
directory MailSend uses now the directory where the EXE
resides. If this also fails, MailSend uses the current
directory.
v3.05 96-05-20 Fixed a bug where MailSend does not set user count.
v3.06 96-06-06 Allow processing of more than one -@
Logon sequence optimized for Exchange Client
Profile for Exchange can now be used in -f parameter
v3.07 96-06-19 Added display of full address. This should help Exchange
users finding there own address
Fixed a bug where MailSend tries to establish a
MAPI session in an enviroment that does not support it
( MailSend ignores -mt in DOS and OS/2 )
v3.08 96-08-31 Fixed a routing problem with SNADS and PROFS
Fixed display of MCI addresses
v3.09 96-11-14 Fixed command line parsing problem