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 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 = no password) Note: Argument is not necessary if you use MAPI (-mt). -d 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 where an attached file will be extracted to -t 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. -@ 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 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 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