home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / lan / mtools.arj / MAILTOOL.DOC < prev    next >
Text File  |  1992-07-12  |  9KB  |  248 lines
  1. LANtastic (tm) from Artisoft ships with a rudimentary email system.  While
  2. more that ships with other peer to peer systems, the system is simple and
  3. lacks most of the features found in many commercial email products.
  4.  
  5. Some of the features most requested are:
  6. 1) A command line interface so the net menu system is not needed.
  7. 2) The ability to edit and send larger files.
  8. 3) The ability to send true group mail.
  9.  
  10. The Mail Tool toolkit from r3 Systems consists of several small programs
  11. (developed using the LANtastic API as found in the LANtastic Programmers
  12. Interface(tm) ) that give these abilities.
  13.  
  14. The toolkit consists of:
  15.  
  16. Getmail - This utility scans all servers for mail addressed to the user,
  17. downloads the mail into a text file( either appending to an archival file
  18. or creating a new file) and optionally deletes the mail after it is down-
  19. loaded.  This allows you to read the mail at your leisure using your favorite
  20. word processor or text editor.
  21.  
  22. Sendmail - This utility allows you to compose one or more messages in your 
  23. favorite editor or word processor and send the messages to several users
  24. on one or more servers.
  25.  
  26. Grpmail - This utility allows you to send one message to a predefined group
  27. of users on one or more servers.  This is true group mail, ie the message is 
  28. sent once to each user so if one receiptiant deletes his copy the others re-
  29. main.  The message can be of any length, and there are no limits to the number 
  30. of users who can be in each group.
  31.  
  32.  
  33.  
  34. GETMAIL.EXE 1.2 - (c) 1992
  35.  
  36. 1. What is GETMAIL
  37.      Getmail is a short program that checks all servers your computer is
  38.    logged into for mail addressed to your login name.  All these messages are
  39.    then downloaded into one file.  The name of this file is specified on the 
  40.    command line.  
  41.    
  42.    The syntax is getmail pathname [A|D].  
  43.    
  44.    The switches A, and D together or separately modify getmail's function.
  45.    
  46.    By default getmail overwrites the file specified if it exists, and does
  47.    NOT delete the messages after they are copied to the file.
  48.    
  49.    Adding the A switch causes getmail to append the new messages to the file
  50.    if it exists.
  51.    
  52.    Adding the D switch causes getmail to delete all messages after they have
  53.    been read into the file.
  54.    
  55.    Either A or D or both can be added to the command line.
  56.    
  57.    Getmail inserts the following lines into this file:
  58.  
  59.      Message from:
  60.      From Server:
  61.      Comment:
  62.    
  63.    Before each message.  Getmail returns an error level equal to the number 
  64.    of messages copied. Getmail lists the message headers as the messages 
  65.    downloaded.
  66.  
  67.  
  68. 2. How do I use GETMAIL?
  69.    After Logging into all servers with your individual user name, run:
  70.  
  71.    GETMAIL test 
  72.    
  73.    Getmail search all servers with mail resources for messages addressed to
  74.    you and copy these messages into the file test. (Getmail supports 
  75.    wildcard searches so mail address to * will be read as well). If the file 
  76.    "test" already exists it will be over written.
  77.  
  78.    GETMAIL test A
  79.  
  80.    This command does the same thing EXCEPT the messages are APPENDED to the
  81.    end of "test" if it exists.
  82.  
  83.    GETMAIL test AD
  84.  
  85.    This deletes the messages after they are appended to the file "test".
  86.  
  87.    GETMAIL test D
  88.  
  89.    This command deletes the messages after they are written to the file 
  90.    "test" overwriting the file if it already exists.
  91.  
  92.    The messages are now on your computer stored in the file test ready to
  93.    be read and acted on.  The file can be archived to maintain a permanent
  94.    record of your correspondence.
  95. SENDMAIL.EXE 1.0 - (c) 1992
  96.  
  97. 1. What is SENDMAIL ?
  98.  
  99.    SENDMAIL is a short program that sends messages typed into a 
  100.    file to one or more users on one or more servers.  
  101.  
  102.    The syntax is SENDMAIL filename.       
  103.    
  104.    Sendmail reads the file and sends the messages to the users/servers 
  105.    specified.  The mail is announced using the standard LANtastic(tm)
  106.    popups.
  107.  
  108. 2. How do I use SENDMAIL?
  109.  
  110.    Use your favorite word processor or text editor to create a file of 
  111.    outgoing messages.  The format of the messages are:
  112.  
  113. $$username   
  114. \\server
  115. comment line up to 40 characters
  116.    
  117. Body of message   
  118. $$end
  119.    
  120.    The message MUST be saved as a standard text file.  DO not use files in
  121.    a word processor format.
  122.  
  123.    There can be several messages in the file, the messages can be addressed
  124.    to several different users, and the message can be stored on any server
  125.    you are currently logged into.
  126.  
  127.    Any text in the file NOT inclosed between the $$username and $$end markers
  128.    will be ignored.  This means that you can actually reply to messages down-
  129.    loaded with getmail by editing the message file and inserting your replies
  130.    into the file.  This also allow you to quote all or part of the original
  131.    in your reply.  All text outside of the markets will be ignored.
  132.  
  133.    See send.txt for an example.
  134.    
  135.  
  136. GRPMAIL.EXE 1.0 - (c) 1992
  137.  
  138. 1. What is GRPMAIL?
  139.    
  140.    GRPMAIL is a short program that sends a prewritten message from a file
  141.    to a group of users specified in a group definition file. There is no 
  142.    limit to the size of the message, or the number of people in the group.
  143.    The people in the group can receive the messages stored on any mail
  144.    server you are logged into.
  145.      
  146.    The syntax is GRPMAIL Group_file Message_file "optional comment"       
  147.    
  148.    The command:  GRPMAIL users1.grp mailtool.doc "Docs for mail tool toolkit"
  149.  
  150.    Will send this file to all users listed in the file users1.grp.  The
  151.    messages will be announced with the standard LANtastic popup message, 
  152.    and the mail system will show the comment "Docs for mail tool toolkit."
  153.    
  154. 2. How do I use GRPMAIL?
  155.  
  156.    Use your favorite word processor or text editor to create a file of 
  157.    outgoing messages.  There is no limitation on the format of the message.
  158.  
  159.    The format of the group files is very simple, each entry consists of:
  160.  
  161. $$username
  162. \\servername
  163.    
  164.    Any other lines in this file not beginning with either a $$ or \\ are
  165.    treated as comments and ignored.
  166.  
  167.    See the included file users1.grp for an example.
  168.  
  169.  
  170.  
  171.  
  172. GENERAL
  173.  
  174. If you like this program please let me know, if you have any suggestions
  175. or comments please forward them to the address below. This toolkit is 
  176. in a continual process or growth and change, all suggestions will be given
  177. serious consideration even if not acted on.
  178.  
  179. 1. How do I install the r3 Mail Toolkit?
  180.    
  181.    Copy Getmail.exe Sendmail.exe and Grpmail.exe unto your hard drive.
  182.  
  183.  
  184. 2. Legalities
  185.    GETMAIL.EXE, SENDMAIL.EXE and GRPMAIL.EXE are not in the public domain.  
  186.    It is a copyrighted program.
  187.  
  188.    The entire program and documentation are Copyright (C) 1991, 1992 
  189.    Rick R. Roth, Tucson, Az.  You are encouraged to copy the package 
  190.    freely, including distribution by BBS, shareware library, or other 
  191.    means, provided that (1) the distribution shall consist of the 
  192.    original archive containing the program and this documentation file, 
  193.    and (2) no fee of more than five US dollars ($5) shall be charged 
  194.    for the copy.
  195.  
  196.    Lantastic is a registered trademark of Artisoft, INC.
  197.  
  198. 3. Registration
  199.    To register your copy of the toolkit send $5.00 to:
  200.   
  201.    Rick R. Roth
  202.    4072 E. 22nd St.
  203.    Suite 178
  204.    Tucson, Az 85711
  205.    
  206.    THIS COPY IS LICENSED FOR THE EXCLUSIVE USE OF THE LICENSEE.  
  207.    This license is good for one network, and the software can be installed
  208.    on all computers on this network.
  209.  
  210. 7. Liability
  211.  
  212.  ╔═══════════════════════════════════════════════════════════════╗
  213.  ║                                                               ║
  214.  ║                    LIMIT OF LIABILITY                         ║
  215.  ║                    ──────────────────                         ║
  216.  ║      The author disclaims all warranties, expressed or        ║
  217.  ║ implied and assumes no liability for damages either from its  ║
  218.  ║ direct use or as a consequence of its use.  Have you hugged   ║
  219.  ║ your backup today?                                            ║
  220.  ║                                                               ║
  221.  ╚═══════════════════════════════════════════════════════════════╝
  222.  
  223.  
  224.   I have tested it on several computers and found that found that it works 
  225.   well on all of them.  All computers have been running LANtastic(tm) NOS v3.03
  226.   and above and all running MS DOS 3.3 and above.
  227.  
  228.   Please note that while the author is an employee of Artisoft, Inc., Artisoft 
  229.   is not responsible for the contents of this file; the functioning of STRING.COM 
  230.   (or any damages resulting from the use or misuse of the program); and further, 
  231.   Artisoft Technical Support and other employees of Artisoft, Inc. are 
  232.       
  233.           NOT RESPONSIBLE FOR SUPPORTING THIS PROGRAM!  
  234.       
  235.   If you have problems or suggestions when using this program, direct them to 
  236.   me Rick R. Roth through one of the following channels:
  237.  
  238.      US Mail:          4702 E 22nd St,  Tucson, AZ  85711
  239.      CompuServ:        Artisoft forum, 75300,1377
  240.      Arti-facts BBS:   If you have a current account there.
  241.  
  242.  
  243.   Do NOT call the author during business hours for support, this program was
  244.   not written during business hours, it will not be supported during business 
  245.   hours.
  246.  
  247.  
  248.