home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / mailextr.arj / MAILEXTR.TXT < prev    next >
Encoding:
Text File  |  1996-07-30  |  9.7 KB  |  318 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.                      or in the format your gateway requires it.
  93.                      Multiple addresses are allowed.
  94.  
  95.                      Format for MSMail 3.x is:
  96.                      Network/Postoffice/User
  97.  
  98.                      Format for Exchange is:
  99.                      EX:/o=Org/ou=ORGUNIT/cn=Recipients/cn=Mailbox
  100.  
  101.                      Note: When using MAPI (-mt) on a Windows NT
  102.                            machine running MSMail for NT, the user part
  103.                            of the address is case sensitive.
  104.  
  105.  
  106. -@<ArgFile>          Read additional argument from a file (-@FILE.EXT)
  107.  
  108.                      You can create the file with your editor or
  109.                      with NotePad and write one line for every argument.
  110.                      ( see example for ARG.TXT below )
  111.  
  112. -c<MessageCount>     Process only <MessageCount> messages at one cycle
  113.  
  114. -v                   Enable verbose output
  115.                      ( Displays To, CC, Subject and NoteText )
  116.  
  117.  
  118. Examples:
  119.  
  120.  
  121.    To extract mail from MailExtr with a password of PASSWORD, save
  122.    attachments into H:\IN and send an info message to Rick
  123.    (located on Network NET and postoffice POST)
  124.    and your maildrive is M: use the following:
  125.  
  126.    MailExtr -fMailExtr -pPassword -dM -tNet/Post/Rick -eH:\IN
  127.  
  128.    Same as above but using a ARG file:
  129.  
  130.    MailExtr -fMailExtr -pPassword -@ARG.TXT
  131.  
  132.    Sample ARG.TXT
  133.    --------------
  134.  
  135.    -dM
  136.    -tNet/Post/Rick
  137.    -eH:\IN
  138.    <End of file>
  139.  
  140.  
  141.  
  142. Using MAILEXTR.DEF
  143. ------------------
  144.  
  145. Every time MAILEXTR starts its looks for MAILEXTR.DEF in the directory
  146. where MAILEXTR.EXE resides. MAILEXTR.DEF can be used to provide MAILEXTR
  147. with default arguments. If your postoffice is always at the same
  148. drive its a good idea to use a MAILEXTR.DEF to use your drive as the
  149. default.
  150.  
  151. You can create MAILEXTR.DEF with your editor or with NotePad and
  152. write one line for every argument.
  153.  
  154. Here is a sample MAILEXTR.DEF:
  155.  
  156.    -dM
  157.    <End of file>
  158.  
  159.  
  160.  
  161. Return Codes
  162. ------------
  163.  
  164. MailExtr supports the following return codes (errorlevel):
  165.  
  166.    0   No message waiting
  167.    1   Send or receive error
  168.    2   Message found
  169.  
  170.  
  171.  
  172. Polling
  173. -------
  174.  
  175. In order to work, MailExtr has to poll MS Mail for messages from time to
  176. time. As good way to do this is to run MailExtr in a loop with
  177. EXTERNAL.EXE.
  178.  
  179. A sample batch file may look like:
  180.  
  181. @echo off
  182. :Start
  183.  
  184.    rem Change to MailExtr directory
  185.    cd MailExtr
  186.  
  187.    rem Execute MailExtr
  188.    MailExtr -fPingPong -pPassword -dM
  189.  
  190.    rem Change back to directory where External is located
  191.    cd ..
  192.  
  193.    rem Call External for 15 minutes
  194.    external -BR0:0:15
  195.  
  196.    rem Check Externals errorlevel to find out if the
  197.    rem operator pressed  ESC
  198.    if errorlevel 66 goto End
  199.    if errorlevel 63 goto Start
  200.    if errorlevel 62 goto End
  201. :End
  202.  
  203.  
  204. More information
  205. ----------------
  206.  
  207. Enclosed you will find FAQ.TXT which answers frequently asked questions
  208.  
  209.  
  210. Latest Version:
  211. ---------------
  212.  
  213. You will find the lastest version of MailExtr on
  214.  
  215. ftp://ftp.ahub.co.at/demk        or
  216. http://www.ahub.co.at/demk       or
  217. CompuServe, GO PCAPP, LIB 9
  218.  
  219. Filenames are:
  220.  
  221.    MaExtDOS.ZIP   DOS   Version
  222.    MaExtW16.ZIP   Win16 Version
  223.    MaExtW32.ZIP   Win32 Version
  224.    MaExtOS2.ZIP   OS/2  Version
  225.  
  226.  
  227. Licensing Agreement
  228. -------------------
  229.  
  230.     MailExtr (c) is copyrighted 1993-1996 by DataEnter, Michael Kocum,
  231.     portions (c) Microsoft Corp.
  232.  
  233.     This product and its documentation may not, in whole or in part, be
  234.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  235.     system, or translated into any other natural or computer language, in
  236.     any form or by any means whatsoever, be it electronic, mechanical,
  237.     magnetic, optical, manual or otherwise, without the prior written
  238.     consent of DataEnter.
  239.  
  240.     DataEnter makes no warranty or representation, either expressed or
  241.     implied, with respect to the product MailExtr and its
  242.     documentation, their quality, perfomance, merchantability, or fitness
  243.     for a particular purpose. DataEnter reserves the right to revise the
  244.     user's guide and make changes in the content without obligation to
  245.     notify any person or organization of such a change.
  246.  
  247.     In no event will DataEnter be liable for any direct, indirect,
  248.     special, incidental or consequential damages, real or imagined,
  249.     resulting from the use or purchase of this software.
  250.     Under no circumstances shall DataEnter's liability for damages
  251.     exceed the price paid for the software license.
  252.  
  253.     Should any remedy hereunder be determined to have failed, all
  254.     limitations of liability and exclusion of damages set forth above
  255.     shall remain in full force and effect.
  256.  
  257.     The extent of the DataEnter's warranty for the software and its
  258.     documentation is limited to physical defects of the distribution media
  259.     containing the software. Contact DataEnter to obtain return
  260.     authorization for the replacement diskette within 30 days of the
  261.     original date of purchase. Any further statement made by agents,
  262.     employees, distributors or dealers of DataEnter do not constitute
  263.     warranties and are not binding. No employee of DataEnter has the
  264.     authority to modify any portion of this warranty.
  265.  
  266.     All brand and product names we refer to in the documentation are used
  267.     solely for identification purposes and may be trademarks of other
  268.     companies.
  269.  
  270.     DataEnter, (the licensor) grants the buyer (the licensee)
  271.     the right to use this copy of MailExtr (the program)
  272.     on a single computer at a single location as long as the
  273.     licensee complies with the terms of this license. The licensor
  274.     reserves the right to terminate this license if the licensee
  275.     violates any part of the agreement.
  276.  
  277.     The licensee agrees to make copies of the program only for backup
  278.     purposes. The licensee agrees not to copy the documentation and to
  279.     take all necessary precautions to ensure that the backup copies of the
  280.     software are not distributed to or acquired by other parties.
  281.  
  282.     Microsoft Mail is a trademark of Microsoft Corp.
  283.     Windows for Workgroups is a trademark of Microsoft Corp.
  284.     Windows NT is a trademark of Microsoft Corp.
  285.     Windows Windows 95 is a trademark of Microsoft Corp.
  286.     OS/2 is a trademark of IBM Corp.
  287.  
  288.  
  289. History:
  290. --------
  291.  
  292. v3.00            Released
  293.  
  294. v3.01  96-05-15  If "TEMP" enviroment variable points to an invalid
  295.                  directory MailExt uses now the directory where the EXE
  296.                  resides. If this also fails, MailExtr uses the current
  297.                  directory.
  298.  
  299.                  MailExtr ( Win32 ) detects now a system shutdown,
  300.                  a logoff or a close event and terminates
  301.  
  302. v3.02  96-05-20  Fixed a bug where MailExtr does not set user count.
  303.  
  304. v3.03  96-06-06  Logon sequence optimized for Exchange Client
  305.                  Profile for Exchange can now be used in -f parameter
  306.  
  307. v3.04  96-07-30  Added display of full address. This should help Exchange
  308.                  users finding there own address
  309.  
  310.                  Fixed a bug where MailSend tries to establish a
  311.                  MAPI session in an enviroment that does not support it
  312.                  ( MailSend ignores now -mt in DOS and OS/2 )
  313.  
  314.                  Added -Cx to process only x messages at one cycle
  315.  
  316.                  Added -V for verbose output ( displaying message text )
  317.  
  318.