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 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 Mailbox password (default is no password) Note: Argument is not necessary if you use MAPI (-mt). -t 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 Carbon Copy ( CC ) destination address in full Microsoft format (Network/Postoffice/User) or in the format your gateway requires it. -s Subject for message -d 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 File to import for message bod. If the file size is more than 32KB it will be converted to an attachment. -a File(s) to attach to message. Multiple files and wildcards are allowed. -b 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. -@ 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 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 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