home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / tgnm500.zip / NEWMAIL.DOC < prev    next >
Text File  |  1994-06-13  |  5KB  |  130 lines
  1. ■ NEWMAIL.EXE Version 5.00αlpha
  2. ■ Telegard 2.7s AUTO.MSG Utility -Released as FREEWARE
  3.  
  4. WHAT THIS PROGRAM DOES:
  5.  
  6. Upon logon I wanted to tell my users that "new mail" had arrived, or had been
  7. posted in the message bases.  Orginally Newmail simply stamped the time and
  8. date in to the AUTO.MSG file when executed from my mailer's UNPACK.BAT.  So
  9. Users would know that last time InBound Mail was processed.
  10.  
  11. Newmail could also generate a random Oneliner Quote from the NEWMAIL.DAX 
  12. database file.  Newmail still generates quotes, but the file and format are
  13. different.
  14.  
  15. I stated in an earlier doc that Newmail would be able to tell you exactly
  16. what message bases received "new mail".  It does that now, along with a
  17. status and how many messages are in that message base.
  18.  
  19. CHANGES:
  20.  
  21. NEWMAIL.DAX: no longer the Oneliner Quote database, now an on-site index that
  22. contains information for the "-V"erbose switch.  If this file should get lost
  23. or doesn't exist, don't worry, Newmail will rebuild it automatically.  When
  24. you first run Newmail in the "-V"erbose mode this file is created and updated
  25. accordingly.  Generally speaking, this file is created and maintained by the
  26. program and you don't have to mess with it at all.
  27.  
  28. NEWMAIL.ONE: (new file) Newmail no longer keeps a standard database for its'
  29. quotes, it keeps them in straight ASCII, you can use a text/ascii editor to
  30. add, delete, rewrite, whatever to this file.  If you use the "-Q"uote command
  31. and the NEWMAIL.ONE file doesn't exist, Newmail will use one of (very few) the
  32. internal quotes it has and write it to the AUTO.MSG file.  All I did was take
  33. an ASCII file of Oneliners, rename it to NEWMAIL.ONE.  Simple.  A sample
  34. NEWMAIL.ONE Oneliner file should be included in this archive.
  35.  
  36. NEWMAIL.HDR: (new file) this is a Header File, whatever information in this
  37. file exists, it will be appended before the newmail data.  This is an OPTIONAL
  38. FILE, and only will be added to the auto.msg if it exists in the current
  39. directory.
  40.  
  41. NEWMAIL.FTR: (new file) this is a Footer File, whatever information in this
  42. file exists, it will be appended after the newmail data.  This is an OPTIONAL
  43. FILE, and only will be added to the auto.msg if if exists int he current
  44. directory.
  45.  
  46. BUILDOL: there is no true use for Buildol anymore, now that the Quote file is
  47. straight ASCII.  However, using the "-B"uild command will allow you to extract
  48. the OLD NEWMAIL.DAX file in to ASCII format for use as NEWMAIL.ONE file. Pretty
  49. slick, Huh?
  50.  
  51. SWITCHES: command switches have changed, take a look either futhure along in
  52. this doc or just type NEWMAIL at the dos prompt to access help.
  53.  
  54. ERROR HANDLING: mostly in the switch arrangements, finding files.  There are
  55. somethings that Newmail can't handle and it will "bail" if something really
  56. nasty happens.
  57.  
  58. TESTING: ya, beleive it or not, I tested this version before I released it.
  59. Nice of me, huh?
  60.  
  61. AUTO.MSG: Newmail now OVERWRITES this file with its' new information, it no
  62. longer appends it.  So any scribling your users do in the AUTO.MSG file will
  63. be overwritten by Newmail, it has no mercy.
  64.  
  65. SYSOP.LOG: Newmail now makes a brief entry in the sysop log file, time/date
  66. at run time.
  67.  
  68.  
  69. PROGRAM SET-UP:
  70.  
  71. Place Newmail and (if you have one) the NEWMAIL.ONE file in you directory with
  72. STATUS.DAT, has to have this file to find the AFILES, MSGS, and GFILES 
  73. directories.  The first time you use the "-V"erbose command the NEWMAIL.DAX file
  74. will be created.
  75.  
  76. PROGRAM SWITCHES:
  77.  
  78. syntax: NEWMAIL -<command> -<command>
  79.  
  80.  
  81. Switch:              Function:
  82. <no switch or -?>    Help Screen
  83. -B                   Access internal BUILDOL, extract old NEWMAIL.DAX to ASCII       
  84. -V                   Verbose message base listing, what base got mail & status
  85. -Q                   Generate Random Oneliner from NEWMAIL.ONE
  86. -S                   See the Oneliner that was generated, put it on screen
  87. -N                   Normal output, time/date stamp only
  88.  
  89. examples:
  90.  
  91. NEWMAIL -v -q -s
  92. Verbose information, generate a oneliner, I want to also see the oneliner
  93.  
  94. NEWMAIL -N
  95. Normal output, no quotes, no verbose, just time/date stamped in AUTO.MSG
  96.  
  97. NEWMAIL -V -N
  98. This don't work, normal output and verbose output? I don't think so.
  99.  
  100. NOTE: upper/lower case makes no difference
  101.  
  102. TECHNICAL:
  103.  
  104. Compulation: QuickBASIC 4.5
  105.  
  106. NEWMAIL.DAX Record Size: 80 bytes (82 real)
  107.  
  108. Oneliner Generation Method: Timer is RANDOMIZED, Number of Lines Calculated in
  109. the NEWMAIL.ONE, the Oneliner is chosen by a random number, or rather a line.
  110. So if you have 2000 Oneliners it may take a few seconds.
  111.  
  112. Board Access Method: Reads BOARDS.DAT
  113.  
  114. Maxium Message Bases Processed: Hell if I know, I have 30 and it does just fine
  115.  
  116. Internal Oneliners: 24 of them, all stupid
  117.  
  118. LAST NOTES:
  119.  
  120. I run Newmail in my Mailer's UNPACK.BAT, which is ran everytime I receive
  121. New InBound Echomail.
  122.  
  123.  
  124. The NEWMAIL.HDR and NEWMAIL.FTR files, these are optional files.  Good for
  125. placing whatever information in them you want to display along with the
  126. newmail data.  They are only added if they exist in the current directory.
  127.  
  128. Ron Dean 3811/514 fido
  129. System Operator, Comnet SEML BBS
  130.