home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / LSTRUN20.ZIP / LASTRUN.DOC < prev    next >
Text File  |  1992-09-08  |  11KB  |  266 lines
  1.                           ┌─────────────┐
  2.                           │ LASTRUN.EXE │
  3.                           └─────────────┘
  4.                                  
  5.                       Last Mail Run Bulletin
  6.                             Tom Kellen
  7.                    ßETATech Computer Consulting
  8.  
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.  
  11. PURPOSE:  This simple utility will create both mono and color
  12.           bulletins with your BBS name and the date and time of the
  13.           last successful PCRelay, PostLink, FireNet, CircuitNET or
  14.           other network Mail Run.  It will make this bulletin with
  15.           the information on up to 8 different networks.  This
  16.           program should work with any BBS software as you specify
  17.           the file name of the bulletins.
  18.  
  19.  
  20.  
  21. INTRODUCTION:
  22.  
  23. The PCRelay and Postlink programs create a one line text file listing
  24. the date and time of the last SUCCESSFUL mail import it does.  This
  25. is a nice feature, but I wanted a way to make a nice bulletin so that
  26. my user's would know exactly how current the RIME messages on board
  27. were.  Hence the birth of LASTRUN.EXE.  LASTRUN will create a
  28. monochrome and a color bulletin with the file names you supply it. 
  29. This bulletin will have your BBS name and the Date and Time of the
  30. last successful PCRelay import.  If you are connected to several
  31. different networks and are using PCRelay for all of them, it will
  32. create this bulletin showing the information on one to eight different
  33. networks.  In version 1.8, I've added support for PostLink's
  34. LASTTIME.TXT files.  PostLink is Kip Compton's follow up program to
  35. take PCRelay's place.  The LASTTIME.TXT files are in a slightly
  36. different format, but LASTRUN will automatically work with them.
  37.  
  38. Earlier versions of LASTRUN supported CircuitNET transfers using a
  39. program called STAMPER.  With version 2.0, I am dropping support for
  40. STAMPER files as the same can be accomplished with the included LTFAKE
  41. utility.  
  42.  
  43.  
  44.  
  45. INSTALLATION:
  46.  
  47. Installation of LASTRUN is very simple.  Place LASTRUN.EXE and
  48. LTFAKE.EXE into any directory that is on the PATH.  LASTRUN.EXE needs
  49. a configuration file called LASTRUN.CFG to also be in this directory. 
  50. I have included a sample one in the ZIP that you can edit to add the
  51. specifics for your BBS.
  52.  
  53. This configuration file should be created with an ASCII editor (like
  54. QEdit).  The configuration file uses a series of "key words" to
  55. identify each option.  Each "key word" ends with an = sign and should
  56. be followed immediately the value for that "key word".  A semi-colon
  57. can be used to add comments to lines in the configuration file.  Any
  58. text after a semi-colon will be ignored.  
  59.  
  60. Here is a sample LASTRUN.CFG:
  61.  
  62. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  63. BBSName=The Paradigm BBS
  64. MBulName=C:\SF\DISPLAY\ALL.BBS
  65. CBulName=C:\SF\DISPLAY\ALL.CLR
  66. DisMoreP=Yes
  67. MoreP=Yes
  68. Clear1st=Yes
  69. Net1Name=RIME
  70. Net1Dir=C:\PCRELAY1
  71. Net2Name=Local Net
  72. Net2Dir=C:\PCRELAY2
  73. Net3Name=CircuitNET
  74. Net3Dir=C:\SF\CN3
  75. Net4Name=PostLink
  76. Net4Dir=C:\POSTLINK
  77. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  78.  
  79. The first "key word" is BBSName=.  This should be followed immediately
  80. by your BBS's name.  This can be up to 40 characters long and will
  81. show up on the first line of the bulletin.  
  82.  
  83. MBulName= is the full file specification for the mono bulletin.  
  84.  
  85. CBulName= is the full file specification of the color bulletin.  Line 
  86.  
  87. The next several options enable some Spitfire BBS display control
  88. codes.  If you use the key word DisMoreP=Yes LASTRUN will disable the
  89. MORE prompt by placing a ^B at the beginning of the bulletins.  If you
  90. put No after this key word the ^B will not be placed in the bulletin. 
  91. SysOps of other BBS types, if ^B is not the same code for disabling
  92. MORE on your BBS place No after DisMoreP=.
  93.  
  94. Using MoreP=Yes will re-enable the MORE prompt and force a MORE by
  95. placing a ^E and then a ^P on the last line of the bulletins.  Putting
  96. No after MoreP= will omit these codes from the bulletin.  
  97.  
  98. Clear1st=Yes places a ^L on the first line of the bulletin.  Spitfire
  99. BBS recognizes this as the code to clear the screen before displaying
  100. the bulletin.  Some other BBS's may also recognize this code as it is
  101. the code for a form feed.  Using Clear1st=No will keep this code from
  102. being put into the bulletin. 
  103.  
  104. The next several codes tell LASTRUN what the names of the networks you
  105. use are and the directories where their LASTTIME.TXT files can be
  106. found.
  107.  
  108. Net1Name= would be followed by the name of the first network.  Network
  109. names can be up to 30 character's long.  
  110.  
  111. Net1Dir= would be followed by the directory where LASTRUN will find
  112. the LASTTIME.TXT file for that particular network.  
  113.  
  114. LASTRUN can handle up to 8 networks so you can specify names using the
  115. codes Net1Name= through Net8Name= and their directories by using
  116. Net1Dir= through Net8Dir=.
  117.  
  118. That is all there is for the configuration file.  Next you will need
  119. to edit the batch file that does your PCRelay or PostLink mail import
  120. and add a line calling LASTRUN right after the line that call's
  121. IMPORT.  This will assure you that the bulletin is created with the
  122. most up to date information.  Here is an example of my PCRelay mail
  123. run batch file.
  124.  
  125. :EVENT_H
  126. REM RIME Network Mail Run
  127. CD\PCR
  128. EXPORT
  129. CD\TC
  130. TELIX SMAILRUN
  131. CD\PCR
  132. IMPORT
  133. LASTRUN
  134. CD\SF
  135.  
  136. That is all there is to it.  IMPORT creates the LASTTIME.TXT file in
  137. the PCRelay subdirectory with the date and time of the last successful
  138. message import.  LASTRUN.EXE reads this file and creates a bulletin
  139. that looks like this:
  140.               ╒═══════════════════════════════════════════════╕
  141.             █ │              The Paradigm BBS's               │
  142.             █ │                                               │
  143.             █ │              Last Successful RIME             │ 
  144.             █ │        Transfer Was At 21:01 On 09-08-92.     │ 
  145.             █ │                                               │ 
  146.             █ │             Last Successful LocalNet          │ 
  147.             █ │        Transfer Was At 21:02 On 09-08-92.     │ 
  148.             █ │                                               │ 
  149.             █ │            Last Successful CircuitNet         │ 
  150.             █ │        Transfer Was At 10:03 On 09-08-92.     │ 
  151.             █ │                                               │
  152.             █ │           Last Successful PostLink            │ 
  153.             █ │        Transfer Was At 21:04 On 09-08-92.     │ 
  154.             █ ╘═══════════════════════════════════════════════╛
  155.             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  156.  
  157. The size of the bulletin varies with the number of networks you run.
  158.  
  159.  
  160.  
  161. OPERATION:
  162.  
  163. If you have placed the call to LASTRUN into your Net-Mail batch file,
  164. operation is totally automatic, and the bulletins will be updated
  165. every time you do a mail transfer.
  166.  
  167.  
  168.  
  169. LTFAKE:
  170.  
  171. LTFAKE.EXE creates a clone of the LASTTIME.TXT file created by
  172. PostLink.  It will create this clone LASTTIME.TXT in the current
  173. directory or you can specify the directory it should use on the
  174. command line.  LTFake will use the current date and time in this file. 
  175. This program can be used in your FireNet or other network batch files
  176. to create a fake LASTTIME.TXT when you've had a mail run.  To make
  177. this more accurate, I would suggest using a command that checks for
  178. the existence of your incoming mail packet.  Something like this:
  179.  
  180. IF EXIST PARADIGM.FN LTFAKE C:\FIRENET
  181.  
  182. This would ensure that LTFake is only run on a successful mail run.
  183.  
  184.  
  185.  
  186. EPILOGUE:
  187.  
  188. This utility is being distributed under the Shareware principal.  This
  189. means you get to try this utility before your buy it.  If it is useful
  190. to you, pay the author for it, otherwise, delete it.  I am trying to
  191. create quality, low cost software so any and all contributions are
  192. welcome.  Send what you feel the utility is worth to the address below
  193. (suggested registration is one dollar).  Thanks for supporting
  194. Shareware and keeping this type of distribution alive.
  195.  
  196.  
  197.  
  198. AUTHOR CONTACT:
  199.  
  200. Problems, solutions, kudos and ideas are welcomed.  I can be reached
  201. at the following:
  202.  
  203. The Paradigm BBS                   ßETATech Computer Consulting
  204. 404 / 671-1581                     P. O. Box 566742
  205. 1200-38,400 Baud 24 Hrs/Day        Atlanta, GA  31156-6013
  206.  
  207.  
  208.  
  209. DISCLAIMER:
  210.  
  211. Use of this program acknowledges this disclaimer of warranty: "This
  212. program is supplied as is.  ßETATech Computer Consulting disclaims all
  213. warranties, express or implied, including, without limitation, the
  214. warranties of merchantability and of fitness of this program for any
  215. purpose.  ßETATech Computer Consulting assumes no liability for
  216. damages direct or consequential, which may result from the use of this
  217. program."
  218.  
  219.  
  220.  
  221. ACKNOWLEDGMENTS:
  222.  
  223. My thanks to Mike Woltz for his fine Spitfire BBS Software and for
  224. providing sample Turbo Pascal source code for us novice programmers. 
  225. This program uses Buffalo Creek's BCShare Turbo Pascal File Locking
  226. and Sharing routines.  Thanks to John Newlin for being my mentor and
  227. for being an inspirational programmer and providing excellent
  228. shareware to the computing public, and to Sammy Mitchell for his
  229. superb QEdit text editor, how can anyone do without it?
  230.  
  231.  
  232.  
  233. REVISION HISTORY:
  234.  
  235. 23-AUG-1990    v1.0      Initial Release.
  236.  
  237. 17-SEP-1990    v1.1      Added support for up to 4 different
  238.                          networks.
  239.  
  240. 20-SEP-1990    v1.11     Minor fix to screen info.
  241.  
  242. 27-SEP-1990    v1.2      Added support for up to 8 different
  243.                          networks.
  244.  
  245. 29-SEP-1990    v1.3      Fixed Bug in reading 5-8 LASTTIME.TXT
  246.  
  247. 04-OCT-1990    v1.4      Added support for CircuitNET & STAMPER.
  248.  
  249. 11-NOV-1990    v1.5      Added Spitfire MORE display control codes.
  250.  
  251. 18-NOV-1990    v1.51     Recompiled with BCShare v0.7 to correct some
  252.                          error checking.
  253.  
  254. 01-DEC-1990    v1.6      Recompiled with Turbo Pascal v6.0.
  255.  
  256. 01-FEB-1992    v1.7      Changed the way the control characters are
  257.                          entered in the bulletins to work better with
  258.                          Spitfire 3.2.  Added LTFAKE.EXE utility.
  259.  
  260. 05-SEP-1992    v1.8      Added support for PostLink's LASTTIME.TXT.
  261.  
  262. 08-SEP-1992    v2.0      Dropped internal time and STAMPER support. 
  263.                          Optimized code and changed configuration
  264.                          file for more flexibility.  Added Spitfire
  265.                          Clear Screen command.
  266.