home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / INTERNET / GIGO0209.ZIP / GUTL0209.ZIP / ML.DOC < prev    next >
Text File  |  1994-02-09  |  7KB  |  172 lines
  1. ML - Mailing list processor for GIGO users.
  2.  
  3. Jason Fesler
  4. jfesler@wmeonlin.sacbbx.com
  5. fidonet 1:203/7707.0
  6.  
  7.  
  8. What it does:
  9.  
  10.   o Reads a given message base (*.MSG or squish style) for new
  11.     messages, redistributing to a list of participants via email
  12.   o Reads your netmail area, packing any messages it finds that are
  13.     meant to be for the gateway, into gigo's .PKT format
  14.  
  15. What you need to do:
  16.   o Edit the ML.CFG to your specification
  17.   o Add to your GIGO config file:  "PASSWORD yourpassword".
  18.     This password _must_ match line 5 of the ml.cfg file.
  19.     (This allows ML to use features normally that are not allowed
  20.      to be used by your users).
  21.   o RTFM!
  22.  
  23. Any problems, contact me for help.
  24.  
  25. [02/09/94]
  26.  
  27.   o ML recompiled to handle 2048 messages in your netmail folder instead
  28.     of 256 messages.  If you have over 2048 messages in your netmail
  29.     folder, it's _really_ time to clean it out..  your mailer will
  30.     thank you!
  31.  
  32. [01/14/94]
  33.  
  34.   o ML passes the attribute unaltered into the .PKT, so that it will
  35.     "remember" things like receipt requests and file attaches.
  36.  
  37. [12/29/93]
  38.  
  39.   o ML was not looking at the MSGSENT flag and properly ignoring messages
  40.     that have already been packed up by an alternate netmail packer. Fixed.
  41.  
  42. [12/05/93]
  43.  
  44.   o In the event your .MLL files get trashed, is now marking the messages
  45.     when it processes them, so that they will not all be sent back out again.
  46.     If you have a good message editor, your editor will mark the messages
  47.     as "Return Receipt" or something to that effect.
  48.  
  49.     If you genuinely need the message(s) rescanned, instruct your message
  50.     editor to turn that flag off.
  51.  
  52.     This addition to MLL has been added as we have found by experience that
  53.     the .MLL files are easy to lose when you have multiple mail processes
  54.     going on -- we've had the entire GIGO echo rescanned multiple times to
  55.     everyone, which not only cost a lot of phone time for everyone involved,
  56.     but was a nightmare answering "yes, I know it spewed".
  57.  
  58.     If you have a better idea for handling things, let me know.  Be warned,
  59.     I might offer you the source code or something.. ;-)
  60.  
  61.   o If you need to run maintenance on the .MSG directories, simply
  62.     delete the .MLL files.  Since they are marked as scanned (or, more
  63.     precisely, as message receipts), ML will look at them, but not send
  64.     them out a second time around.
  65.  
  66. [11/29/93]
  67.  
  68.   o Ability to _not_ send out messages based on the content of the
  69.     fidonet headers or any token in the message body.  No more sending
  70.     out messages from mail daemons that returned their mail to the mailing
  71.     list instead of the "Errors-To:" address.
  72.  
  73. [11/17/93]
  74.   o Writes netmail to the UUCP gateway (GIGO or compatible),
  75.     sending a copy of the new messages to GIGO for handling.
  76.     GIGO will take the message, along with the list of
  77.     mailing addresses, and send just one email message for the
  78.     entire list of recipients.
  79.  
  80. [11/18/93]
  81.   o Converts netmail to .PKT files for GIGO to use
  82.     - Scans for the GATEWAY'S address in your netmail directory
  83.     - also scans for YOUR address, and at least one of the following:
  84.         an internet address
  85.         the name "UUCP"
  86.       Any mail it finds will be converted to .PKT form for GIGO
  87.       to read, since GIGO itself is not written for any message
  88.       message base format at all, but instead the .PKT transport
  89.       mechanism.
  90.  
  91.  
  92.  
  93.  
  94. What it needs:
  95.   o Active experience in handling mailing lists, understanding
  96.     principles involved.
  97.   o GIGO, or compatible gateway program supporting the ^aPASSWORD
  98.     and ^aCCFILE kludge lines.
  99.  
  100. Why not build this into GIGO itself?
  101.   o Memory - the msgapi0 interface itself eats a good 60-80k of memory;
  102.     I'd rather not waste that space while GIGO is running
  103.   o Dupe management - GIGO would have a teribly hard time trying to
  104.     monitor traffic both to the mailing list address and to the
  105.     FTN echo itself.  It's easier to manage externally.
  106.   o ML will send the messages via netmail to GIGO to process, so that
  107.     GIGO has a chance to alter any email addresses if need, using the
  108.     gateway program's configuration, before dumping it all into the
  109.     spool directory.
  110.  
  111. Acknowledgements:
  112.   o ML is "Squish" compatible, as well as *.MSG.   I am using
  113.     a modified form of Scott Dudley's MSGAPI interface.  Full credit
  114.     goes to him for creating such a flexible and easy interface
  115.     to the message base.
  116.  
  117.  
  118. Sample cfg:
  119. --------8< cut here -------------
  120. 1:203/8055
  121. 1:203/2
  122. $C:\squish\netmail
  123. C:\gateway\pkts
  124. PASSWORD
  125. $E:\msgs\wannabe wannabe.ml wannabe-l@wmeonlin.sacbbx.com wannabe-err@wmeonlin.sacbbx.com
  126. $E:\msgs\wme wme.ml wme-l@wmeonlin.sacbbx.com wme-err@wmeonlin.sacbbx.com
  127. $E:\msgs\gigo gigo.ml gigo-l@wmeonlin.sacbbx.com gigo-err@wmeonlin.sacbbx.com
  128. --------8< cut here -------------
  129.  
  130. What each line is:
  131.   1:  "1:203/8055"   That's YOUR address
  132.   2:  "1:203/2"  That's the GATEWAY's designated fidonet address.
  133.   3:  "$C:\squish\netmail"  That's the netmail base that you use
  134.        for netmail.  If you are are not using Squish style bases,
  135.        do not specify the dollar sign.
  136.   4:  "PASSWORD"  This is the password that the gateway uses to allow
  137.        programs such as the mailing list to include extra headers,
  138.        such as "From:", "Reply-To:", etc, overriding the gateway's
  139.        defaults.
  140.   5:   Where GIGO is expecting the .PKT files to be
  141. 6-8:  These control the actual mailing lists.  They contain 4 parameters on
  142.       a single line:
  143.          message base name or directory  ($ denotes squish)
  144.          text file containing mailing list addresses of who to send
  145.             mail to (one address per line)
  146.          posting-address  (complete posting address, including domain!)
  147.          errors-address (complete posting address, including domain!)
  148.  
  149. Note, ML will _NOT_ translate your netmail to echomail areas, like Owl does.
  150. It assumes that the gateway software is capable of turning mailing list email
  151. to echos, such as GIGO can do.  In GIGO, you would add this to your map file:
  152.    @ gigo-l@yoursite.org GIGO null
  153. The @ signifies that it's for the mailing list.  Any messages sent to
  154. gigo-l@yoursite.org are turned into the echo called "GIGO".  Any messages
  155. written in the GIGO echo are sent to null (nowhere), since the ML program is
  156. already going to be handling things.
  157.  
  158. Your errors-address (in our case, gigo-err@wmeonlin.sacbbx.com) should ALWAYS
  159. be different than your posting address.  If not, if a person loses his
  160. internet address, and the messages bounce back to gigo-l, then all of the
  161. bounce messages are re-broadcast to everyone in the list, including the bad
  162. address, and starts the cycle over.  Very messy .. just like my docs! :-)
  163.  
  164. ML will also look for a file called "ML.BAD".  A sample of this file is
  165. included in the archive.  It allows you to tell ML which messages should not
  166. be re-broadcast to everyone in the list.  You can use this file to stop
  167. things like messages from mailer-daemons from being sent to everyone in your
  168. mailing list.
  169.  
  170.  
  171.  
  172.