home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / maextos2.zip / MAILEXTR.TXT < prev    next >
Text File  |  1996-06-06  |  9KB  |  295 lines
  1.  
  2.             DataEnter, Michael Kocum
  3.             Taborstrasse 27/23
  4.             A-1020 Vienna
  5.             AUSTRIA
  6.  
  7.         CIS: 70143,1667
  8.         MHS: MICHAEL @ DEMK (via CSERVE)
  9.    Internet: michael@demk.co.at
  10.         Fax: +43/1/2143829
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Introduction to MailExtr
  17. ------------------------
  18.  
  19. MailExtr is a addon for Microsoft Mail and Windows for Workgroups.
  20.  
  21. MailExtr polls MS Mail for messages sent to it and if it gets
  22. one, copys the attachments to a directory of your choice and, as an
  23. option, notify another user via a message.
  24.  
  25. In conjunction with MAILEXTR, you can make automatic data transfers
  26. between postoffices.
  27.  
  28.  
  29.  
  30. System Requirements
  31. -------------------
  32.  
  33.   DOS   version :  DOS 3.3
  34.   Win16 version :  Windows 3.1
  35.   Win32 version :  Windows NT 3.1 or Windows 95
  36.   OS/2  version :  OS/2 2.x
  37.  
  38.   Microsoft Mail, version 3.2 or
  39.   Windows for Workgroups or
  40.   Microsoft Exchange 4.0 or
  41.   MAPI.DLL ( optional in Win16 version ) or
  42.   MAPI32.DLL ( optional in Win32 version )
  43.  
  44.  
  45. Installation
  46. ------------
  47.  
  48.  
  49.   - Create a directory of your choice copy MAILEXTR.EXE into this
  50.     directory.
  51.  
  52.   - Start ADMIN.EXE or "Postoffice Manager" to create a mailbox
  53.     for which acts as a default mailbox. We suggest that you use
  54.     "MailExtr" as the mailbox name.
  55.     Creating a mailbox is optional, but it it makes testing easy.
  56.  
  57.   - Use your editor to create a MAILEXTR.DEF file for your common used
  58.     arguments (see section "Using MAILEXTR.DEF").
  59.  
  60.  
  61. Arguments
  62. ---------
  63.  
  64. MailExtr uses the following arguments:
  65.  
  66.  
  67. -mt                  Use MAPI as transport service
  68.                      ( Win16 and Win32 version only )
  69.  
  70.  
  71. -f<Mailbox>          Mailbox name
  72.                      or transport service name of you use the Exchange
  73.                      Client and MAPI (-mt)
  74.  
  75.                      Note: Argument is not necessary if you use MAPI (-mt).
  76.  
  77.  
  78. -p<Password>         Mailbox password (default = no password)
  79.  
  80.                      Note: Argument is not necessary if you use MAPI (-mt).
  81.  
  82.  
  83. -d<Drive>            Drive where MailData is located (default drive M)
  84.                      or full path to MailData.
  85.  
  86.                      Note: Argument is not necessary if you use MAPI (-mt).
  87.  
  88.  
  89. -e<Path>             Path where an attached file will be extracted to
  90.  
  91. -t<Dest>             Destination address in full Microsoft format
  92.                      (Network/Postoffice/User) or in the format your
  93.                      gateway requires it. Multiple addresses are allowed.
  94.  
  95.                      Note: When using MAPI (-mt) on a Windows NT
  96.                            machine running MSMail for NT, the user part
  97.                            of the address is case sensitive.
  98.  
  99.  
  100. -@<ArgFile>          Read additional argument from a file (-@FILE.EXT)
  101.  
  102.                      You can create the file with your editor or
  103.                      with NotePad and write one line for every argument.
  104.                      ( see example for ARG.TXT below )
  105.  
  106. Examples:
  107.  
  108.  
  109.    To extract mail from MailExtr with a password of PASSWORD, save
  110.    attachments into H:\IN and send an info message to Rick
  111.    (located on Network NET and postoffice POST)
  112.    and your maildrive is M: use the following:
  113.  
  114.    MailExtr -fMailExtr -pPassword -dM -tNet/Post/Rick -eH:\IN
  115.  
  116.    Same as above but using a ARG file:
  117.  
  118.    MailExtr -fMailExtr -pPassword -@ARG.TXT
  119.  
  120.    Sample ARG.TXT
  121.    --------------
  122.  
  123.    -dM
  124.    -tNet/Post/Rick
  125.    -eH:\IN
  126.    <End of file>
  127.  
  128.  
  129.  
  130. Using MAILEXTR.DEF
  131. ------------------
  132.  
  133. Every time MAILEXTR starts its looks for MAILEXTR.DEF in the directory
  134. where MAILEXTR.EXE resides. MAILEXTR.DEF can be used to provide MAILEXTR
  135. with default arguments. If your postoffice is always at the same
  136. drive its a good idea to use a MAILEXTR.DEF to use your drive as the
  137. default.
  138.  
  139. You can create MAILEXTR.DEF with your editor or with NotePad and
  140. write one line for every argument.
  141.  
  142. Here is a sample MAILEXTR.DEF:
  143.  
  144.    -dM
  145.    <End of file>
  146.  
  147.  
  148.  
  149. Return Codes
  150. ------------
  151.  
  152. MailExtr supports the following return codes (errorlevel):
  153.  
  154.    0   No message waiting
  155.    1   Send or receive error
  156.    2   Message found
  157.  
  158.  
  159.  
  160. Polling
  161. -------
  162.  
  163. In order to work, MailExtr has to poll MS Mail for messages from time to
  164. time. As good way to do this is to run MailExtr in a loop with
  165. EXTERNAL.EXE.
  166.  
  167. A sample batch file may look like:
  168.  
  169. @echo off
  170. :Start
  171.  
  172.    rem Change to MailExtr directory
  173.    cd MailExtr
  174.  
  175.    rem Execute MailExtr
  176.    MailExtr -fPingPong -pPassword -dM
  177.  
  178.    rem Change back to directory where External is located
  179.    cd ..
  180.  
  181.    rem Call External for 15 minutes
  182.    external -BR0:0:15
  183.  
  184.    rem Check Externals errorlevel to find out if the
  185.    rem operator pressed  ESC
  186.    if errorlevel 66 goto End
  187.    if errorlevel 63 goto Start
  188.    if errorlevel 62 goto End
  189. :End
  190.  
  191.  
  192. More information
  193. ----------------
  194.  
  195. Enclosed you will find FAQ.TXT which answers frequently asked questions
  196.  
  197.  
  198. Latest Version:
  199. ---------------
  200.  
  201. You will find the lastest version of MailExtr on
  202.  
  203. ftp://ftp.ahub.co.at/demk        or
  204. http://www.ahub.co.at/demk       or
  205. CompuServe, GO PCAPP, LIB 9
  206.  
  207. Filenames are:
  208.  
  209.    MaExtDOS.ZIP   DOS   Version
  210.    MaExtW16.ZIP   Win16 Version
  211.    MaExtW32.ZIP   Win32 Version
  212.    MaExtOS2.ZIP   OS/2  Version
  213.  
  214.  
  215. Licensing Agreement
  216. -------------------
  217.  
  218.     MailExtr (c) is copyrighted 1993-1996 by DataEnter, Michael Kocum,
  219.     portions (c) Microsoft Corp.
  220.  
  221.     This product and its documentation may not, in whole or in part, be
  222.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  223.     system, or translated into any other natural or computer language, in
  224.     any form or by any means whatsoever, be it electronic, mechanical,
  225.     magnetic, optical, manual or otherwise, without the prior written
  226.     consent of DataEnter.
  227.  
  228.     DataEnter makes no warranty or representation, either expressed or
  229.     implied, with respect to the product MailExtr and its
  230.     documentation, their quality, perfomance, merchantability, or fitness
  231.     for a particular purpose. DataEnter reserves the right to revise the
  232.     user's guide and make changes in the content without obligation to
  233.     notify any person or organization of such a change.
  234.  
  235.     In no event will DataEnter be liable for any direct, indirect,
  236.     special, incidental or consequential damages, real or imagined,
  237.     resulting from the use or purchase of this software.
  238.     Under no circumstances shall DataEnter's liability for damages
  239.     exceed the price paid for the software license.
  240.  
  241.     Should any remedy hereunder be determined to have failed, all
  242.     limitations of liability and exclusion of damages set forth above
  243.     shall remain in full force and effect.
  244.  
  245.     The extent of the DataEnter's warranty for the software and its
  246.     documentation is limited to physical defects of the distribution media
  247.     containing the software. Contact DataEnter to obtain return
  248.     authorization for the replacement diskette within 30 days of the
  249.     original date of purchase. Any further statement made by agents,
  250.     employees, distributors or dealers of DataEnter do not constitute
  251.     warranties and are not binding. No employee of DataEnter has the
  252.     authority to modify any portion of this warranty.
  253.  
  254.     All brand and product names we refer to in the documentation are used
  255.     solely for identification purposes and may be trademarks of other
  256.     companies.
  257.  
  258.     DataEnter, (the licensor) grants the buyer (the licensee)
  259.     the right to use this copy of MailExtr (the program)
  260.     on a single computer at a single location as long as the
  261.     licensee complies with the terms of this license. The licensor
  262.     reserves the right to terminate this license if the licensee
  263.     violates any part of the agreement.
  264.  
  265.     The licensee agrees to make copies of the program only for backup
  266.     purposes. The licensee agrees not to copy the documentation and to
  267.     take all necessary precautions to ensure that the backup copies of the
  268.     software are not distributed to or acquired by other parties.
  269.  
  270.     Microsoft Mail is a trademark of Microsoft Corp.
  271.     Windows for Workgroups is a trademark of Microsoft Corp.
  272.     Windows NT is a trademark of Microsoft Corp.
  273.     Windows Windows 95 is a trademark of Microsoft Corp.
  274.     OS/2 is a trademark of IBM Corp.
  275.  
  276.  
  277. History:
  278. --------
  279.  
  280. v3.00            Released
  281.  
  282. v3.01  96-05-15  If "TEMP" enviroment variable points to an invalid
  283.                  directory MailExt uses now the directory where the EXE
  284.                  resides. If this also fails, MailExtr uses the current
  285.                  directory.
  286.  
  287.                  MailExtr ( Win32 ) detects now a system shutdown,
  288.                  a logoff or a close event and terminates
  289.  
  290. v3.02  96-05-20  Fixed a bug where MailExtr does not set user count.
  291.  
  292. v3.03  96-06-06  Logon sequence optimized for Exchange Client
  293.                  Profile for Exchange can now be used in -f parameter
  294.  
  295.