home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MLRUN11.ZIP / MAILRUN.DOC < prev    next >
Encoding:
Text File  |  1992-01-23  |  3.6 KB  |  73 lines
  1.  
  2. MAILRUN -- v1.1
  3. Time and Date Stamping Utility
  4. Copyright (c) 1991-1992 by Brian Showalter
  5. All Rights Reserved
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9. MAILRUN is a time and date stamping utility that provides BBS sysops with a
  10. quick and easy way to notify their users when the last mail run was made.
  11.  
  12. MAILRUN can be used to update any text file that is less than 32,767 bytes in
  13. size.  This limitation exists because MAILRUN reads the entire text file into
  14. memory to gain more speed in operation.
  15.  
  16. MAILRUN can be used to update any number of text files.  First the system time
  17. and date are retrieved and the update message is composed, and then the
  18. message is inserted into each of the specified text files.  If a prior update
  19. message exists in a text file, it is replaced with the new message.
  20.  
  21. Why MAILRUN?  I've looked at several similar programs, and none of them had
  22. the one thing I was looking for - the ability to update multiple text files. I
  23. place the "last mail run" message in several text files which are named
  24. according to PCBoard's security levels as follows:
  25.  
  26.                 Level 20 = D:\PCB\GEN\20.
  27.                 Level 30 = D:\PCB\GEN\30.
  28.                 Level 40 = D:\PCB\GEN\40.
  29.                         etc.
  30.  
  31. Doing this lets me restrict the "last mail run" message to only those users
  32. which have access to the echoed conferences.  The programs I looked at had to
  33. be run once for each file, which took a bit longer and made the BBS event
  34. batch file larger.  So, I decided to "roll my own" and the result is MAILRUN.
  35.  
  36. ------------------------------------------------------------------------------
  37.  
  38. OPERATING MAILRUN
  39.  
  40. The first thing you need to do before running MAILRUN for the first time is
  41. create a .RUN file, which tells MAILRUN what message is to be created or
  42. updated, and which text files are to contain that message.  The .RUN file
  43. should usually have the same name as the network for which mail runs are made
  44. (e.g. INTELEC.RUN = Intelec network,  ILINK.RUN = ILink network, etc.)  For
  45. more details on what goes into the .RUN file, refer to the sample INTELEC.RUN
  46. file included in this package.
  47.  
  48. MAILRUN.EXE can be placed into the same subdirectory as your event batch
  49. file, or it can be placed in any subdirectory.  The only stipulation is that
  50. the .RUN files MUST be in the same subdirectory as MAILRUN.EXE.  To add
  51. MAILRUN to your event, insert the following line:
  52.  
  53.         MAILRUN <filename>
  54.  
  55. where <filename> contains the name of the .RUN file.  Do NOT include the
  56. ".RUN" extension in this name.  MAILRUN will append this extension
  57. automatically.  The above line should be inserted in your event batch file at
  58. exactly the point where you want the date and time to be recorded.  I normally
  59. place it right after the command which inserts echoed messages into the BBS.
  60.  
  61. ------------------------------------------------------------------------------
  62.  
  63. MAILRUN is copyrighted by Brian Showalter.  You may use it as much as you want
  64. and the author does not expect any compensation for its use.  If you feel that
  65. you absolutely, positively have to compensate me, you can call my BBS at (703)
  66. 433-6903 and upload some good files.  You may also copy MAILRUN and give it to
  67. your friends, and you may upload it to any bulletin board system, as long as
  68. no modifications have been made to the original files.
  69.  
  70. If you find any nasty bugs in MAILRUN or wish to suggest enhancements, you can
  71. leave me a message on my BBS, or you can send a message to me in the Sysops
  72. conference on the Intelec or ILink echo networks.
  73.