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 name -p Mailbox password (default no password) -t 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 for message (if the subject contains spaces, put it between quotes, like -s'More than one word') -d 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 File to import for message body -a File to attach to message (Multiply files are allowed) -@ 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 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.