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