home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / mred225.zip / MOREINFO.ZIP / MAILEXTR.TXT next >
Text File  |  1995-05-09  |  7KB  |  230 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. Its purpose is to poll MS Mail for messages send to it and if it got
  22. one, copy the attachments to a directory of your choice and as an
  23. option, notify another user via a message.
  24.  
  25. In conjunction with MailSend, you can make automatic data transfers
  26. between postoffices.
  27.  
  28.  
  29.  
  30. System Requirements
  31. -------------------
  32.   DOS 3.3 or higher
  33.   Microsoft Mail, version 3.0 or above or
  34.   Windows for Workgroups, versions 3.1 or above
  35.  
  36.  
  37.  
  38. Installation
  39. ------------
  40.  
  41. MailExtr requires a user mailbox on your Microsoft Mail system in order
  42. to work with Microsoft Mail. You have to create this mailbox before
  43. installing MailExtr.
  44.  
  45. On a Microsoft Mail Postoffice this is done via ADMIN.EXE, whereas
  46. in Windows for Workgroup without the postoffice upgrade you use
  47. "Postoffice Manager".
  48.  
  49. We suggest, that you use "MailExtr" as the mailbox
  50. name and "MailExtr at <fill in your postoffice>" as the alias.
  51. Using "at postoffice" will make it simpler to select the right MailExtr
  52. in the address book.
  53.  
  54. Further create a directory on your server and copy MAILEXTR.EXE,
  55. APPGET.EXE and APPPUT.EXE into this directory. We suggest that you make
  56. a directory called MailExtr below your MAILEXE, so its clear that
  57. MailExtr belongs to MS Mail.
  58.  
  59.  
  60. Arguments
  61. ---------
  62.  
  63. MailExtr uses the following arguments:
  64.  
  65. -f<Mailbox>          Mailbox name
  66. -p<Password>         Mailbox password (default no password)
  67. -d<Drive>            Drive where MailData is located (default drive M)
  68.                      or full path to MailData with trailing backslash
  69.                      like M:\MAILDATA\
  70.  
  71. -e<Path>             Path where an attached files will be extracted
  72.  
  73. -t<Dest>             Destination address in full Microsoft format
  74.                      which get notified when a file arrives
  75.                      (Network/Postoffice/User)
  76.                      Multiply addresses are allowed
  77.  
  78. -@<ArgFile>          Read additional argument from a file (-qFILE.EXT)
  79.                      (each argument requries one line)
  80.  
  81. Samples:
  82.    MailExtr -fMailExtr -pPassword -dM -tNet/Post/Rick -eH:\IN
  83.    MailExtr -fMailExtr -pPassword -@ARG.TXT
  84.  
  85.  
  86.    Sample ARG.TXT
  87.    --------------
  88.  
  89.    -dM
  90.    -tNet/Post/Rick
  91.    -eH:\IN
  92.    <End of file>
  93.  
  94.  
  95. Return Codes
  96. ------------
  97.  
  98. MailExtr supports the following return codes (errorlevel):
  99.  
  100.    0   No message waiting
  101.    1   Send or recive error
  102.    2   Message found
  103.  
  104.  
  105. Polling
  106. -------
  107.  
  108. In order to work, MailExtr has to poll MS Mail for messages from time to
  109. time. This can be done in two different ways.
  110.  
  111. If you have Microsoft Mail Postoffice than you have a maschine which
  112. runs EXTERNAL.EXE. You can put MailExtr in a loop with External and
  113. so MailExtr will be called periodic.
  114.  
  115. A sample batch file may look like:
  116.  
  117. @echo off
  118. :Start
  119.  
  120.    rem Change to MailExtr directory
  121.    cd MailExtr
  122.  
  123.    rem Execute MailExtr
  124.    MailExtr -fPingPong -pPassword -dM
  125.  
  126.    rem Change back to directory where External is located
  127.    cd ..
  128.  
  129.    rem Call External for 15 minutes
  130.    external -BR0:0:15
  131.  
  132.    rem Check Externals errorlevel to find out if the
  133.    rem operator pressed  ESC
  134.    if errorlevel 66 goto End
  135.    if errorlevel 63 goto Start
  136.    if errorlevel 62 goto End
  137. :End
  138.  
  139.  
  140. You can also run MailExtr in the background of Windows. A special
  141. programm, MAILWAIT.EXE is included for this porpose. MailWait accepts one
  142. argument and this is the time to wait in seconds. MailWait is designed
  143. so that it releases all recources to Windows and runs smoothly in the
  144. background.
  145.  
  146.  
  147. A sample batch file may look like:
  148.  
  149. @echo off
  150. :Start
  151.  
  152.    rem Change to MailExtr directory
  153.    cd MailExtr
  154.  
  155.    rem Execute MailExtr
  156.    MailExtr -fPingPong -pPassword -dM
  157.  
  158.    rem Change back to directory where MailWait is located
  159.    cd ..
  160.  
  161.    rem Call MailWait for 900 seconds (= 15 minutes)
  162.    MailWait 900
  163.  
  164.    rem Check MailWaits errorlevel to find out if the
  165.    rem operator pressed  ESC
  166.    if errorlevel 1 goto End
  167.    goto Start
  168. :End
  169.  
  170.  
  171. Licensing Agreement
  172. -------------------
  173.  
  174.     MailExtr (c) is copyrighted 1993-1995 by DataEnter, Michael Kocum,
  175.     portions (c) Microsoft Corp.
  176.  
  177.     This product and its documentation may not, in whole or in part, be
  178.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  179.     system, or translated into any other natural or computer language, in
  180.     any form or by any means whatsoever, be it electronic, mechanical,
  181.     magnetic, optical, manual or otherwise, without the prior written
  182.     consent of DataEnter.
  183.  
  184.     DataEnter makes no warranty or representation, either expressed or
  185.     implied, with respect to the product MailExtr and its
  186.     documentation, their quality, perfomance, merchantability, or fitness
  187.     for a particular purpose. DataEnter reserves the right to revise the
  188.     user's guide and make changes in the content without obligation to
  189.     notify any person or organization of such a change.
  190.  
  191.     In no event will DataEnter be liable for any direct, indirect,
  192.     special, incidental or consequential damages, real or imagined,
  193.     resulting from the use or purchase of this software.
  194.     Under no circumstances shall DataEnter's liability for damages
  195.     exceed the price paid for the software license.
  196.  
  197.     Should any remedy hereunder be determined to have failed, all
  198.     limitations of liability and exclusion of damages set forth above
  199.     shall remain in full force and effect.
  200.  
  201.     The extent of the DataEnter's warranty for the software and its
  202.     documentation is limited to physical defects of the distribution media
  203.     containing the software. Contact DataEnter to obtain return
  204.     authorization for the replacement diskette within 30 days of the
  205.     original date of purchase. Any further statement made by agents,
  206.     employees, distributors or dealers of DataEnter do not constitute
  207.     warranties and are not binding. No employee of DataEnter has the
  208.     authority to modify any portion of this warranty.
  209.  
  210.     All brand and product names we refer to in the documentation are used
  211.     solely for identification purposes and may be trademarks of other
  212.     companies.
  213.  
  214.     DataEnter, (the licensor) grants the buyer (the licensee)
  215.     the right to use this copy of MailExtr (the program)
  216.     on a single computer at a single location as long as the
  217.     licensee complies with the terms of this license. The licensor
  218.     reserves the right to terminate this license if the licensee
  219.     violates any part of the agreement.
  220.  
  221.     The licensee agrees to make copies of the program only for backup
  222.     purposes. The licensee agrees not to copy the documentation and to
  223.     take all necessary precautions to ensure that the backup copies of the
  224.     software are not distributed to or acquired by other parties.
  225.  
  226.     Microsoft Mail is a trademark of Microsoft Corp.
  227.     Windows for Workgroups is a trademark of Microsoft Corp.
  228.  
  229.  
  230.