home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / FMAIL100.ZIP / FMAIL.DOC < prev    next >
Text File  |  1991-05-23  |  7KB  |  206 lines
  1.  
  2.  
  3.                                  FMAIL
  4.  
  5.                             Mailer for OS/2
  6.                              version 1.00
  7.  
  8. This is the first generally released version. It is performing well on
  9. my system and handling a huge mail volume every night. My feed is
  10. running Qmail and those I feed are running most anything and
  11. everything.
  12.  
  13. It must be used in conjunction with OMMM to get a full function mailer.
  14. OMMM adds just the right features to do the packing and routing, and
  15. takes almost no time to do it.
  16.  
  17. At this time these and the FMAIL.CFG are the only docs. It's all pretty
  18. straight forward.  You need an AREAS.BBS file (which I'm sure you already
  19. have), and to tailor the FMAIL.CFG file that comes with this set.
  20.  
  21. Then fight with OMMM for a while and write a  .cmd   file to invoke it
  22. and you're all set to go.  There aren't yet any command line switches to
  23. worry about.
  24.  
  25. By request, I'm now including copies of my OMbatch.cmd ommm.ctl and ommm.cfg
  26. files to make it a little easier to set things up the first time.
  27.  
  28. How to use it:
  29.  
  30. NOTE: The command words: toss, scan, tlog, and delete are case SENSITIVE!
  31. NOTE: The   tlog   command is new with ver .24.
  32. NOTE: It will become unhappy and terminate if you have an area-tag in your
  33.         areas.bbs but the path is incorrect.
  34.  
  35. It expects to be invoked in the same directory as the Fmail.cfg and the
  36. Areas.bbs files. Invocation is simply   FMAIL  scan   OR   FMAIL toss   the
  37. rest of the information will be extracted from the Fmail.cfg.  Unlike
  38. QMAIL you cannot have the toss and scan in the same invocation of FMAIL.
  39. If the FMAIL scan also has the   tlog   command (e.g. FMAIL scan tlog)  then
  40. only the areas listed in the echotoss.log (as specified in the FMAIL.cfg
  41. file) will be scanned.
  42.  
  43. After Max_Msgs has been reached, it will spawn to the command file for
  44. OMMM to pack things up before continuing.
  45.  
  46. For pass-through areas there is now a function to delete the messages.
  47. it is invoked with    FMAIL delete   .  This goes through the areas.bbs
  48. file, and deletes ALL the messages in all areas that the line begins with
  49. a   #  .
  50.  
  51. It is marginally faster than QMAIL, and I think that makes it the
  52. fastest mailer available.
  53.  
  54.  Major Qmail features not (yet) included:
  55.  
  56.  
  57.          Max dupes
  58.                  This is currently hard coded at 2000
  59.  
  60.          It will not yet toss from the netmail directory, or the bad_msgs
  61.          directory. (soon)
  62.  
  63.  OK, What's left???
  64.  
  65.          The configuration file is similiar to QMAIL with some additions
  66.          and a fair number of deletions.
  67.  
  68.          Dupes are well checked.
  69.  
  70.          It reads the standard AREAS.BBS for the areas information. The pass
  71.          through sign (#) is currently used differently.
  72.  
  73.          Regular echotoss.log is generated.
  74.  
  75.          It is fast. Not as fast as I'd like, I'd like to double the speed
  76.          of the scan.
  77.  
  78.  
  79.  
  80. Known Lacks-Bugs:
  81.  
  82.  
  83.  
  84. Case sensitive on the command line.
  85.  
  86. Case sensitive to the TAG in Areas.bbs.
  87.  
  88. Some extraneous garbage in the toss log.
  89.  
  90. Does not toss messages from the bad message area or the netmail area.
  91.  
  92.  
  93. General comments:
  94.  
  95.  If you are converting directly from QMAIL, watch out for OMMM! The syntax
  96.  in the routing file (OMMM.CTL) is not as similar as it seems. OMMM seems to
  97.  do quite well here, but it was a real hassle figuring out the .ctl file.
  98.  
  99.  
  100.  All sugestions you have about priorities of adding features will be acted
  101.  upon.
  102.  
  103.  
  104.  
  105. Future additions: (please feel free to add to this list)
  106.  
  107. A basic function router/packer (probably .31 or .32)
  108.  
  109. Some REAL docs for it!
  110.  
  111. A command line switch to change Ommm batch file names, or include a switch on
  112. invoking the batch file to make it easier to change schedules.
  113.  
  114. I want to have the renumbering as well included in FMAIL.
  115.  
  116. The more I use OMMM the more I want to get the packing/routing built in. It
  117. does the job but not the way I'm used to or want to.
  118.  
  119.  
  120. Warantee:
  121.  
  122. There is none beyond guaranteeing to occupy disk space. If it trashes
  123. your disk or your mail it is your responsability (even if I can't
  124. spell).
  125.  
  126.  
  127. Support:
  128.  
  129. I'll try to respond to Netmail. I also hang around the OS2BBS echo for
  130. general type questions.
  131.                         Patrick O'Riva
  132.                         AsmLang and OS/2
  133.                         1:143/37
  134.  
  135. If you don't like it, then don't use it.
  136.  
  137. If you have comments or suggestions I'd be happy to hear them.
  138.  
  139.  
  140. Source code:
  141.  
  142. With version .21 the source is now available. Temporaily only by freq here
  143. as fmailsrc.zip. It will be included in the release package later on.
  144. A special thanks is due at this point to Rick Moore and Mark Lehrer.
  145. Without their active help FMAIL may never have reached this point.
  146. The very understanding members of Net 143 are also due great appreciation.
  147.  
  148. Pat
  149.  
  150.  
  151.                                  FMAIL HISTORY
  152.  
  153.  
  154. ver 1.00 - Fixed remaining problem with locally generated messages.
  155.  
  156. ver -32 - Fixed short netmail problem AGAIN.
  157.  
  158. ver -31 - Fixed bug of comparing 1 less than the number of chars in the Tag
  159.         name, and hang bug on occasional non-compliant short packets.
  160.  
  161. ver -30 - Fixed short netmail message problem, and screen scrolling on netmail
  162.         messages.
  163.  
  164. ver -28 - Mainly changes to the docs
  165.  
  166. ver -27 - Fixed recursive unpacking of bundles. Removed the extra Tag line
  167.         from the outgoing msgs. Fixed BAD_ARC numbering problem.
  168.  
  169. ver -26 - Fixed bombing with 0 length toss log. Fixed date in packets
  170.         added "unpacking" to log file.
  171.  
  172. ver -25 - Applied MORE fixes to the scanning (it looks solid now)
  173.  
  174. ver -24 - Added scan support for echotoss.log via the tlog command. Fixed
  175.         twice and it still broken the tossing of multiple bundles. Applied
  176.         more fixes to the scanning. Improved handling of empty packets.
  177.  
  178. ver -23 - Fixed problem with first net/node in PATH line. Many small fixes
  179.         to acommodate abberant mailers. Fixed more scanning problems
  180.  
  181. ver -22 - Fixed bug with netmail, empty bundles, and proper write back of
  182.         scanned messages.
  183.  
  184. ver .21 - changed the origin node problem in messages. Added a time and msg
  185.         count to the display and the log file. Will now unpack multiple
  186.         bundles.
  187.  
  188. ver .20 - If path is not found, one will be generated rather than generating
  189.         an error. During scan msg seen-bys are modified to reflect the scan.
  190.  
  191. ver .19 - Not released
  192.  
  193. beta test ver .18
  194.  
  195. Added the ability to add a Path line to a message on export. Without this
  196. the attempt to scan a message without a pathline caused a Trap.
  197.  
  198. Added more logging.
  199.  
  200. beta test ver .17
  201.  
  202. Fixed divide error, fixed incompatibility with some mailers using only a
  203. single null terminator. Added some more logging (untested)
  204.  
  205. <previous history deleted>
  206.