home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / share95 / msend / mailsend.txt < prev    next >
Text File  |  1995-12-19  |  9KB  |  266 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 MailSend
  17. ------------------------
  18.  
  19. MailSend is a add-on for Microsoft Mail and Windows for Workgroups.
  20.  
  21. Its purpose is to send MS Mail messages from the command line or from
  22. batch files.
  23.  
  24. Some suggestion as to what you can do:
  25.  
  26. -After you do your overnight backup, send the backup log to your mailbox
  27.  
  28. -Send your monthly report to your boss
  29.  
  30. -In a more sophisticated enviroment, you can export data out of your
  31.  application, pass it to MailSend as an attachment. MailSend will send
  32.  it to the destination and there you can use MailExtr to convert it back
  33.  to a file and import it in your application. (In fact, a lot of
  34.  customers make their database updates via MailSend and MailExtr fully
  35.  automated)
  36.  
  37.  
  38.  
  39. System Requirements
  40. -------------------
  41.   DOS 3.3 or higher
  42.   Microsoft Mail, version 3.0 or above or
  43.   Windows for Workgroups, versions 3.1 or above
  44.  
  45.  
  46.  
  47. Installation
  48. ------------
  49.  
  50. Create a directory on your server and copy MAILSEND.EXE, APPGET.EXE and
  51. APPPUT.EXE into this directory. We suggest that you create this directory
  52. below your MAILEXE, so it is  clear that MailSend belongs to MS Mail.
  53.  
  54.  
  55. Arguments
  56. ---------
  57.  
  58. MailSend uses the following arguments:
  59.  
  60. -f<Mailbox>          Mailbox name
  61. -p<Password>         Mailbox password (default is no password)
  62.  
  63. -t<Dest>             Destination address in full Microsoft format
  64.                      (Network/Postoffice/User) or in the format your
  65.                      gateway requires it.
  66.                      If you are sending a message to a user on you own
  67.                      postoffice, you can use a simpler addressing format
  68.                      and let MailSend resolve the address. You will find
  69.                      more information about resolving addresses in the
  70.                      section "Resolving address" below.
  71.  
  72.                      You can send to multiply addresses by using more
  73.                      than one -t switch.
  74.  
  75. -c<Dest>             Carbon Copy ( CC ) destination address in full
  76.                      Microsoft format (Network/Postoffice/User) or in
  77.                      the format your gateway requires it.
  78.  
  79.  
  80.  
  81. -s<Subject>          Subject for message (if the subject contains
  82.                      spaces, put it between quotes, like -s'More than
  83.                      one word')
  84.  
  85. -d<Drive>            Drive where MailData is located (default drive M)
  86.                      or full path to MailData with trailing backslash
  87.                      like M:\MAILDATA\ If MailSend does not find a
  88.                      postoffice on the given drive, it will scan all
  89.                      your drives from C: to Z: for a postoffice and uses
  90.                      the first one it finds.
  91.  
  92.                      If there is still no postoffice found, it will try
  93.                      to find your MSMAIL.INI and read the postoffice
  94.                      drive from it.
  95.  
  96.                      In the unlikly event that MailSend can't find the
  97.                      postoffice in this way, it will give you an error.
  98.  
  99.                      You can start MailSend with the -l option and
  100.                      it will help you finding the postoffice.
  101.  
  102.  
  103. -i<ImportFile>       File to import for message body
  104.  
  105. -a<AttachFile>       File to attach to message. Multiple files and
  106.                      wildcards are allowed.
  107.  
  108. -b<Priority>         Priority for the message (1-5 or R for Recipient)
  109.  
  110. -@<ArgFile>          Read additional argument from a file (-qFILE.EXT)
  111.                      (each argument requries one line)
  112.  
  113. -l                   Scans your drives for a postoffice
  114.  
  115.                      If you have no idea where your postoffice is
  116.                      located and MailSend will not find it, you can use
  117.                      this option. After completion, write down the path
  118.                      and use it the next time you send a message.
  119.  
  120.  
  121. Samples
  122. -------
  123.  
  124.  
  125.    To send mail from Admin with a password of PASSWORD to
  126.    Rick (located on Network NET and postoffice POST) and your maildrive
  127.    is M: use the following.
  128.  
  129.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestmail
  130.  
  131.  
  132.    To attach a file to the message:
  133.  
  134.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestMail -aATTACH.XLS
  135.  
  136.    Same as above with an argument file:
  137.  
  138.    MailSend -@ARG.TXT
  139.  
  140.    Sample ARG.TXT
  141.    --------------
  142.  
  143.    -fAdmin
  144.    -pPassword
  145.    -dM
  146.    -tNet/Post/Rick
  147.    -sTestMail
  148.    -aATTACH.XLS
  149.    <End of file>
  150.  
  151.  
  152. Resolving address
  153. -----------------
  154.  
  155. MailSend can resolve your address to a full address. This is a real
  156. shortcut if you send a message to a user in your own network/postoffice
  157. or if you don't know your network/postoffice. WFW and Win95 users can
  158. always use this option, because there is only one postoffice.
  159.  
  160. How it works:
  161.  
  162. When MailSend detects that there is no valid address given, it will take
  163. a look inside the global address book and will try to find an address
  164. with matches your input. First it looks at every mailbox name and then
  165. at every alias name on you postoffice, and if it finds one, its uses its
  166. address.
  167.  
  168. Assume your network is called "Network" and your postoffice is
  169. "Postoffice" and you want to send to a mailbox "MillerC" with an alias
  170. of "Carl Miller".
  171.  
  172. The traditional way is to use -tNetwork/Postoffice/MillerC, which is
  173. the full address of "MillerC".
  174.  
  175. The shortcut is to use -tMillerC instead of -tNetwork/Postoffice/MillerC
  176.  
  177. MailSend now searches for a mailbox "MillerC" and resolves the address.
  178.  
  179. Another way is to use -tCarl Miller or -tCarlMiller
  180. (The space does not care when resolving addresse). In this example
  181. MailSend searches for an alias name of "CarlMiller".
  182.  
  183. If you know that there is only one alias name starting with "Carl" you
  184. can further trim it down to -tCarl and MailSend will find it.
  185.  
  186.  
  187.  
  188. Sending to gateways and groups
  189. ------------------------------
  190.  
  191. Enclosed you will find additional information from Microsoft's knowledge
  192. base about MSMail addressing schemes (Q94410.TXT) and how to send to a
  193. group (Q119685.TXT)
  194.  
  195.  
  196. Return Codes
  197. ------------
  198.  
  199. MailSend supports the following return codes (errorlevel):
  200.  
  201.    0   Message sent
  202.    1   Message not sent
  203.  
  204.  
  205.  
  206.  
  207. Licensing Agreement
  208. -------------------
  209.  
  210.     MailSend (c) is copyrighted 1993-1995 by DataEnter, Michael Kocum,
  211.     portions (c) Microsoft Corp.
  212.  
  213.     This product and its documentation may not, in whole or in part, be
  214.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  215.     system, or translated into any other natural or computer language, in
  216.     any form or by any means whatsoever, be it electronic, mechanical,
  217.     magnetic, optical, manual or otherwise, without the prior written
  218.     consent of DataEnter.
  219.  
  220.     DataEnter makes no warranty or representation, either expressed or
  221.     implied, with respect to the product MailSend and its
  222.     documentation, their quality, perfomance, merchantability, or fitness
  223.     for a particular purpose. DataEnter reserves the right to revise the
  224.     user's guide and make changes in the content without obligation to
  225.     notify any person or organization of such a change.
  226.  
  227.     In no event will DataEnter be liable for any direct, indirect,
  228.     special, incidental or consequential damages, real or imagined,
  229.     resulting from the use or purchase of this software.
  230.     Under no circumstances shall DataEnter's liability for damages
  231.     exceed the price paid for the software license.
  232.  
  233.     Should any remedy hereunder be determined to have failed, all
  234.     limitations of liability and exclusion of damages set forth above
  235.     shall remain in full force and effect.
  236.  
  237.     The extent of the DataEnter's warranty for the software and its
  238.     documentation is limited to physical defects of the distribution media
  239.     containing the software. Contact DataEnter to obtain return
  240.     authorization for the replacement diskette within 30 days of the
  241.     original date of purchase. Any further statement made by agents,
  242.     employees, distributors or dealers of DataEnter do not constitute
  243.     warranties and are not binding. No employee of DataEnter has the
  244.     authority to modify any portion of this warranty.
  245.  
  246.     All brand and product names we refer to in the documentation are used
  247.     solely for identification purposes and may be trademarks of other
  248.     companies.
  249.  
  250.     DataEnter, (the licensor) grants the buyer (the licensee)
  251.     the right to use this copy of MailSend (the program)
  252.     on a single postoffice at a single location as long as the
  253.     licensee complies with the terms of this license. The licensor
  254.     reserves the right to terminate this license if the licensee
  255.     violates any part of the agreement.
  256.  
  257.     The licensee agrees to make copies of the program only for backup
  258.     purposes. The licensee agrees not to copy the documentation and to
  259.     take all necessary precautions to ensure that the backup copies of the
  260.     software are not distributed to or acquired by other parties.
  261.  
  262.     Microsoft Mail is a trademark of Microsoft Corp.
  263.     Windows for Workgroups is a trademark of Microsoft Corp.
  264.  
  265.  
  266.