home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_mail / carbon43.arj / CARBON.DOC next >
Text File  |  1991-01-11  |  7KB  |  196 lines
  1.                           CARBON COPY MAKER
  2.                              VERSION 4.3
  3.                               (c) 1991
  4.  
  5. For those of you involved in E-Mail that do not have the Carbon Copy
  6. function in your message editor, this program is for you.  It will search
  7. your netmail area and create carbon copies of messages that you wish to
  8. send to several people.
  9.  
  10. First:  This is public domain.  Enjoy it and pass it around.
  11.  
  12. Second: To use this program you must have two files in directory you run it
  13. from: CONFIG.DOG and USERLIST.DOG  If you don't have them, use a simple
  14. text editor and create each one.  The format for each is below:
  15.  
  16. CONFIG.DOG contains your net/node number, your netmail directory, and
  17. incoming files directory.  (The netmail directory is the only entry this
  18. program really needs, the rest are ignored.)
  19.  
  20. Sample CONFIG.DOG:
  21.  
  22. Node 1:14/626
  23. Mail C:\Bink\Netmail\
  24. Files C:\Bink\Inbound\
  25.               
  26. (Trailing backslash doesn't matter, omit it if you choose)
  27.  
  28. USERLIST.DOG contain a list of those who you send mail to.  It is
  29. ALPHABETICAL and the RIGHT MARGIN is justified.  Point addresses can be
  30. included but this version of my program ignores them and only uses the
  31. net/node number.
  32.  
  33. Example USERLIST.DOG:
  34.  
  35. Blow, Joe                                      12/345
  36. Blow, Joseph                                   12/345
  37. Jones, Tom                                     15/234
  38. Lancaster, Burt                                 120/1
  39. Mouse, Mickey                                 222/1.7
  40. Zorro, Frank                                     13/1
  41.  
  42. NOTE!: There MUST be at least 30 spaces between the names and the numbers.
  43.  
  44. Here's how it works:
  45.  
  46. Create the message you want to copy with the FIRST LINE of the message
  47. beginning with CC: or cc: followed by each name separated by commas. Add as
  48. many names as you like and then follow them with a CR/LF.  Then write your
  49. message.  Example:
  50.  -------------------------
  51. Enter a message to Joe Blow, and put this on the FIRST line:
  52.  
  53. CC: Mickey Mouse, Burt Lancaster
  54.  
  55. Hi, Guys!  How are you?  This is being copied to all of you.  Pretty neat,
  56. huh!
  57.  --------------------------
  58.  
  59. After you save the message and exit your editor, but BEFORE you bundle it
  60. for mailing, run CARBON (again, make sure you are in the directory
  61. containing the above programs).  When it's finished you will have three
  62. identical messages. One for Joe Blow, one for Mickey Mouse, and one for
  63. Burt Lancaster.
  64.  
  65. Each will be addressed to the proper person and include their net/node in
  66. the destination.  You can then bundle them for mailing.
  67.  
  68. Each copy will also have a line added to the beginning of the text 
  69. indicating who the orginal was sent to. (otherwise there would be no way 
  70. of knowing.)
  71.  
  72. Also, any hidden FMPT or TOPT addressing will become visible but will 
  73. not affect the newly created addresses.
  74.  
  75. To see all this, create a test message with a CC: Name, Name, Etc. on 
  76. the first line. Run the Carbon Copy program by typing CARBON.  Then use 
  77. your message editor to look at the newly created messages.  
  78.  
  79.  --------------------------------------------------------------------------
  80.  
  81. LIMITATIONS:
  82.  
  83. Maximum of 500 messages in your netmail area.
  84. Maximum of 1000 lines in the USERLIST.DOG file
  85.  
  86.  --------------------------------------------------------------------------
  87.  
  88. QUIRKS:
  89.  
  90. I FORWARD FILES/REMAPPING
  91.  
  92. If you use a utility to allow Files to be routed through your system,
  93. then run that BEFORE CARBON.
  94.  
  95. If you use REMAPPER, POINTMAP, or a utility to readdress messages, you
  96. probably should run them AFTER CARBON.
  97.  
  98.  
  99. The sequence should be as follows:  1. Forward Files
  100.                                     2. Carbon Copy
  101.                                     3. Remap for Points
  102.               
  103. At least that works best on our system.
  104.  
  105. II KILL/SENT
  106.  
  107. To keep the message base trimmed down, each message carbon copied is
  108. flagged Kill/Sent.  Sorry if that is not the way you like it. Maybe in
  109. future versions, I can make it optional.
  110.  
  111. III FILE ATTACHES
  112.  
  113. You can also use this function to send files to several people, just file
  114. attach the file to the message before running CARBON.
  115.  
  116. IV  FLAGGING MESSAGES
  117.  
  118. CARBON should ONLY be run after YOU enter messages.  You can see that if
  119. you receive a message from someone that has the CC: line in it, this
  120. program would make copies. (something you don't want it to do)  To avoid
  121. making copies of somebody else's message, run FLAGGER after receiving
  122. and tossing incoming netmail.  FLAGGER will mark each message so when
  123. CARBON is run, it will ignore the flagged messages. FLAGGER needs the
  124. CONFIG.DOG file and should be run from the directory CONFIG.DOG is in.
  125. I know this is a sloppy way of doing things but CARBON doesn't know who
  126. created the message and will do it's job unless it sees the hidden flag in
  127. the message.
  128.  
  129. Just remember:
  130.  
  131.        Incoming NetMail                Locally created NetMail
  132.              |                                   |
  133.              V                                   V
  134.   Unbundle/Remap/Forward Files                CARBON
  135.              |                                   |
  136.              V                                   V
  137.           FLAGGER                              Remap
  138.              |                                   |
  139.              V                                   V
  140.         Bundle Mail                         Bundle Mail
  141.  
  142.  --------------------------------------------------------------------------
  143.  
  144. V  ERROR MESSAGES:
  145.  
  146. Some of the error codes (on the rare occasion that you might get an error):
  147.  
  148.  7  OUT OF MEMORY
  149.  9  SUBSCRIPT OUT OF RANGE
  150.  14 OUT OF STRING SPACE
  151.  52 BAD FILE NAME OR NUMBER
  152.  53 FILE NOT FOUND
  153.  62 INPUT PAST END OF FILE
  154.  76 PATH NOT FOUND
  155.  
  156. Note: Error 62 will occur if you have a NULL NetMail message. (Header only,
  157. no text.)
  158.  
  159. If you get an error that is not listed here, drop me a netmail message.
  160.  
  161. VI DISCLAIMERS:
  162.  
  163. These programs (CARBON and FLAGGER) were written in QuickBasic and
  164. compiled. They have been running successfully on our IBM XT Clone. BUT, I
  165. take no responsibility for any hardware or software corrupted on your
  166. system.  (These are simple programs, so I don't anticipate any problems.)
  167.  
  168. These are released to the public domain.
  169.  
  170. I'm no professional programmer. I wrote these because we needed them for
  171. our system.  If you can use them, great!  If not, that's OK, too.
  172.  
  173. I'm happy to help with any problems you may have in setting them up, and
  174. would love to hear comments or suggestions for future enhancements.  Just
  175. drop me a netmail message at 1:14/626
  176.  
  177. Mike DeStefano
  178. Sysop 1:14/626
  179.  
  180. 1/10/91
  181.  
  182. Revision History
  183.  
  184. Version 2.2  First released to the public domain.
  185.  
  186. Version 3.0  Fixed Kill/Sent flag which had a tendency to UnCrash any Crash
  187.              messages. Now all flags stay the same; Kill/Sent is just
  188.              added.
  189.  
  190. Version 4.3  Took the "Orignal message to" statement out of the Subject 
  191.              line; moved it to the text of the message.
  192.              Hid the flag in a safer part of the message header.
  193.              Fixed the FMPT and TOPT hidden addressing so it doesn't 
  194.              affect the newly created Address.
  195.              
  196.