home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / masndos2.zip / MAILSEND.TXT < prev    next >
Text File  |  1996-06-19  |  14KB  |  407 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/214 38 29
  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. MailSend sends messages from the command line or from batch files.
  21.  
  22.  
  23. Some suggestion as to what you can do:
  24.  
  25. -After you do your overnight backup, send the backup log to your mailbox
  26.  
  27. -Send your monthly report to your boss
  28.  
  29. -In a more sophisticated enviroment, you can export data out of your
  30.  application, pass it to MailSend as an attachment. MailSend will send
  31.  it to the destination and there you can use MailExtr to convert it back
  32.  to a file and import it in your application. In fact, a lot of
  33.  customers make their database updates via MailSend and MailExtr.
  34.  
  35.  
  36.  
  37. System Requirements
  38. -------------------
  39.  
  40.   DOS   version :  DOS 3.3
  41.   Win16 version :  Windows 3.1
  42.   Win32 version :  Windows NT 3.1 or Windows 95
  43.   OS/2  version :  OS/2 2.x
  44.  
  45.   Microsoft Mail, version 3.2 or
  46.   Windows for Workgroups or
  47.   Microsoft Exchange 4.0 or
  48.   MAPI.DLL ( optional in Win16 version ) or
  49.   MAPI32.DLL ( optional in Win32 version )
  50.  
  51.  
  52. Installation
  53. ------------
  54.  
  55.   - Create a directory of your choice copy MAILSEND.EXE into this
  56.     directory.
  57.  
  58.   - Use your editor to create a MAILSEND.DEF file for your common used
  59.     arguments (see section "Using MAILSEND.DEF").
  60.  
  61.  
  62. Arguments
  63. ---------
  64.  
  65. MailSend uses the following arguments:
  66.  
  67.  
  68. -mt                  Use MAPI as transport service
  69.                      ( Win16 and Win32 version only )
  70.  
  71.  
  72. -f<Mailbox>          Mailbox name
  73.                      or transport service name of you use the Exchange
  74.                      Client and MAPI (-mt)
  75.  
  76.                      Note: Argument is not necessary if you use MAPI (-mt).
  77.  
  78.  
  79. -p<Password>         Mailbox password (default is no password)
  80.  
  81.                      Note: Argument is not necessary if you use MAPI (-mt).
  82.  
  83.  
  84. -t<Dest>             Destination address in full Microsoft format
  85.                      or in the format your gateway requires it.
  86.                      Multiple addresses are allowed.
  87.  
  88.                      Format for MSMail 3.x is:
  89.                      Network/Postoffice/User
  90.  
  91.                      Format for Exchange is:
  92.                      EX:/o=Org/ou=ORGUNIT/cn=Recipients/cn=Mailbox
  93.  
  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.                      If you are sending a message to a user on you own
  100.                      postoffice, you can use a simpler addressing format
  101.                      and let MailSend resolve the address. You will find
  102.                      more information about resolving addresses in the
  103.                      section "Resolving address" below.
  104.  
  105.                      You can send to multiply addresses by using more
  106.                      than one -t switch.
  107.  
  108.                      Note: Resolving an address is not available if you
  109.                            use MAPI (-mt)
  110.  
  111.  
  112. -c<Dest>             Carbon Copy ( CC ) destination address in full
  113.                      Microsoft format (Network/Postoffice/User) or in
  114.                      the format your gateway requires it.
  115.  
  116.  
  117. -s<Subject>          Subject for message
  118.  
  119.  
  120. -d<Drive>            Drive where MailData is located (default drive M)
  121.                      or full path to MailData.
  122.  
  123.                      Note: Argument is not necessary if you use MAPI (-mt).
  124.  
  125.                      If MailSend does not find a postoffice on the given
  126.                      drive, it will scan all your drives from C: to Z:
  127.                      for a postoffice and uses the first one it finds.
  128.  
  129.                      If there is still no postoffice found, it will try
  130.                      to find your MSMAIL.INI and read the postoffice
  131.                      drive from it.
  132.  
  133.                      In the unlikly event that MailSend can't find the
  134.                      postoffice in this way, it will give you an error.
  135.  
  136.                      You can start MailSend with the -l option and
  137.                      it will help you finding the postoffice.
  138.  
  139.  
  140. -i<ImportFile>       File to import for message bod. If the file size is
  141.                      more than 32KB it will be converted to an
  142.                      attachment.
  143.  
  144.  
  145. -a<AttachFile>       File(s) to attach to message. Multiple files and
  146.                      wildcards are allowed.
  147.  
  148.  
  149. -b<Priority>         Priority for the message (1-5 or R for Recipient)
  150.  
  151.  
  152. -1                   Enable Single To Mode.
  153.                      In Single To Mode, MailSend sends one message for
  154.                      every To address ( -t ) and every CC address ( -c )
  155.                      instead of a single message with all the To's and
  156.                      CC's. This is useful if you want to send a message
  157.                      to more that one address, but each recipient should
  158.                      not see all the other recipients.
  159.  
  160.  
  161. -w                   Wait on exit for a keypress.
  162.                      Useful if you start MailSend as a second task and
  163.                      you want to see the screen output before MailSend
  164.                      exits.
  165.  
  166.  
  167. -@<ArgFile>          Read additional argument from a file (-@FILE.EXT)
  168.  
  169.                      You can create the file with your editor or
  170.                      with NotePad and write one line for every argument.
  171.                      ( see example for ARG.TXT below )
  172.  
  173.  
  174. -l                   Scans your drives for a postoffice
  175.  
  176.                      If you have no idea where your postoffice is
  177.                      located and MailSend will not find it, you can use
  178.                      this option. After completion, write down the path
  179.                      and use it the next time you send a message.
  180.  
  181.  
  182. Samples
  183. -------
  184.  
  185.  
  186.    To send mail from Admin with a password of PASSWORD to
  187.    Rick (located on Network NET and postoffice POST) and your maildrive
  188.    is M: use the following:
  189.  
  190.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestmail
  191.  
  192.  
  193.    To attach a file to the message:
  194.  
  195.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestMail -aATTACH.XLS
  196.  
  197.    Same as above with an argument file:
  198.  
  199.    MailSend -@ARG.TXT
  200.  
  201.  
  202. Sample ARG.TXT
  203. --------------
  204.  
  205.    -fAdmin
  206.    -pPassword
  207.    -dM
  208.    -tNet/Post/Rick
  209.    -sTestMail
  210.    -aATTACH.XLS
  211.    <End of file>
  212.  
  213.  
  214.  
  215. Using MAILSEND.DEF
  216. ------------------
  217.  
  218. Every time MailSend starts its looks for MAILSEND.DEF in the directory
  219. where MAILSEND.EXE resides. MAILSEND.DEF can be used to provide MailSend
  220. with default arguments. If your postoffice is always at the same
  221. drive its a good idea to use a MAILSEND.DEF to use your drive as the
  222. default.
  223.  
  224. You can create MAILSEND.DEF with your editor or with NotePad and
  225. write one line for every argument.
  226.  
  227. Here is a sample MAILSEND.DEF:
  228.  
  229.    -dM
  230.    <End of file>
  231.  
  232.  
  233.  
  234.  
  235. Resolving address
  236. -----------------
  237.  
  238. Note: Resolving an address is not available if you use MAPI (-mt)
  239.  
  240. MailSend can resolve your address to a full address. This is a real
  241. shortcut if you send a message to a user in your own network/postoffice
  242. or if you don't know your network/postoffice. WFW and Win95 users can
  243. always use this option, because there is only one postoffice.
  244.  
  245. How it works:
  246.  
  247. When MailSend detects that there is no valid address given, it will take
  248. a look inside the global address book and will try to find an address
  249. with matches your input. First it looks at every mailbox name and then
  250. at every alias name on you postoffice, and if it finds one, its uses its
  251. address.
  252.  
  253. Assume your network is called "Network" and your postoffice is
  254. "Postoffice" and you want to send to a mailbox "MillerC" with an alias
  255. of "Carl Miller".
  256.  
  257. The traditional way is to use -tNetwork/Postoffice/MillerC, which is
  258. the full address of "MillerC".
  259.  
  260. The shortcut is to use -tMillerC instead of -tNetwork/Postoffice/MillerC
  261.  
  262. MailSend now searches for a mailbox "MillerC" and resolves the address.
  263.  
  264. Another way is to use -tCarl Miller or -tCarlMiller
  265. (The space does not care when resolving addresse). In this example
  266. MailSend searches for an alias name of "CarlMiller".
  267.  
  268. If you know that there is only one alias name starting with "Carl" you
  269. can further trim it down to -tCarl and MailSend will find it.
  270.  
  271.  
  272.  
  273. Return Codes
  274. ------------
  275.  
  276. MailSend supports the following return codes (errorlevel):
  277.  
  278.    0   Message sent
  279.    1   Message not sent
  280.  
  281.  
  282.  
  283. More information
  284. ----------------
  285.  
  286. Enclosed you will find FAQ.TXT which answers frequently asked questions
  287.  
  288.  
  289.  
  290. Latest Version:
  291. ---------------
  292.  
  293. You will find the lastest version of MailSend on
  294.  
  295. ftp://ftp.ahub.co.at/demk        or
  296. http://www.ahub.co.at/demk       or
  297. CompuServe, GO PCAPP, LIB 9
  298.  
  299. Filenames are:
  300.  
  301.    MaSndDOS.ZIP   DOS   Version
  302.    MaSndW16.ZIP   Win16 Version
  303.    MaSndW32.ZIP   Win32 Version
  304.    MaSndOS2.ZIP   OS/2  Version
  305.  
  306.  
  307.  
  308. Licensing Agreement
  309. -------------------
  310.  
  311.     MailSend (c) is copyrighted 1993-1996 by DataEnter, Michael Kocum,
  312.     portions (c) Microsoft Corp.
  313.  
  314.     This product and its documentation may not, in whole or in part, be
  315.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  316.     system, or translated into any other natural or computer language, in
  317.     any form or by any means whatsoever, be it electronic, mechanical,
  318.     magnetic, optical, manual or otherwise, without the prior written
  319.     consent of DataEnter.
  320.  
  321.     DataEnter makes no warranty or representation, either expressed or
  322.     implied, with respect to the product MailSend and its
  323.     documentation, their quality, perfomance, merchantability, or fitness
  324.     for a particular purpose. DataEnter reserves the right to revise the
  325.     user's guide and make changes in the content without obligation to
  326.     notify any person or organization of such a change.
  327.  
  328.     In no event will DataEnter be liable for any direct, indirect,
  329.     special, incidental or consequential damages, real or imagined,
  330.     resulting from the use or purchase of this software.
  331.     Under no circumstances shall DataEnter's liability for damages
  332.     exceed the price paid for the software license.
  333.  
  334.     Should any remedy hereunder be determined to have failed, all
  335.     limitations of liability and exclusion of damages set forth above
  336.     shall remain in full force and effect.
  337.  
  338.     The extent of the DataEnter's warranty for the software and its
  339.     documentation is limited to physical defects of the distribution media
  340.     containing the software. Contact DataEnter to obtain return
  341.     authorization for the replacement diskette within 30 days of the
  342.     original date of purchase. Any further statement made by agents,
  343.     employees, distributors or dealers of DataEnter do not constitute
  344.     warranties and are not binding. No employee of DataEnter has the
  345.     authority to modify any portion of this warranty.
  346.  
  347.     All brand and product names we refer to in the documentation are used
  348.     solely for identification purposes and may be trademarks of other
  349.     companies.
  350.  
  351.     DataEnter, (the licensor) grants the buyer (the licensee)
  352.     the right to use this copy of MailSend (the program)
  353.     on a single postoffice at a single location as long as the
  354.     licensee complies with the terms of this license. The licensor
  355.     reserves the right to terminate this license if the licensee
  356.     violates any part of the agreement.
  357.  
  358.     The licensee agrees to make copies of the program only for backup
  359.     purposes. The licensee agrees not to copy the documentation and to
  360.     take all necessary precautions to ensure that the backup copies of the
  361.     software are not distributed to or acquired by other parties.
  362.  
  363.     Microsoft Mail is a trademark of Microsoft Corp.
  364.     Windows for Workgroups is a trademark of Microsoft Corp.
  365.     Windows NT is a trademark of Microsoft Corp.
  366.     Windows Windows 95 is a trademark of Microsoft Corp.
  367.     OS/2 is a trademark of IBM Corp.
  368.  
  369. History:
  370. --------
  371.  
  372. v3.00            Released
  373. v3.01  01.03.96  Fixed a bug in parsing the command line
  374.                  Fixed online description
  375.  
  376. v3.02  96-03-27  Removed waitstate on error in DOS, Win32 and OS/2
  377.  
  378. v3.02a 96-04-08  Retry fileopen to prevent timeout when a lot of messages
  379.                  are sent
  380.                  Fixed a bug where deleting a ptr befor a waitstate in
  381.                  Win16 caused a GPF
  382.  
  383. v3.02b 96-04-12  Fixed a bug where every address was prefixed with "MS"
  384.                  in MAPI mode
  385.                  Fixed a bug causes a GPF when a empty address was given
  386.  
  387. v3.03  96-04-23  Added support for FFAPI gateways
  388.  
  389. v3.04  96-05-15  If "TEMP" enviroment variable points to an invalid
  390.                  directory MailSend uses now the directory where the EXE
  391.                  resides. If this also fails, MailSend uses the current
  392.                  directory.
  393.  
  394. v3.05  96-05-20  Fixed a bug where MailSend does not set user count.
  395.  
  396. v3.06  96-06-06  Allow processing of more than one -@
  397.                  Logon sequence optimized for Exchange Client
  398.                  Profile for Exchange can now be used in -f parameter
  399.  
  400. v3.07  96-06-19  Added display of full address. This should help Exchange
  401.                  users finding there own address
  402.  
  403.                  Fixed a bug where MailSend tries to establish a
  404.                  MAPI session in an enviroment that does not support it
  405.                  ( MailSend ignores -mt in DOS and OS/2 )
  406.  
  407.