home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RBBSV101.ZIP / RBBSV101.EXE / RVBULL.DOC < prev    next >
Encoding:
Text File  |  1993-07-20  |  7.6 KB  |  149 lines
  1.     ──────────────────────────────────────────────────────────────────────
  2.         RVBULL.EXE v1.00 - Bulletin Maintenance Utility For RBBS-Verify    
  3.         Copyright  (C) 1993 By Lightning Software,  All Rights Reserved
  4.     ──────────────────────────────────────────────────────────────────────
  5.  
  6.                        Written & Coded By Jerry W. Highland
  7.  
  8.            *** SYSOP DOCUMENTATION - READ CAREFULLY BEFORE USING! ***
  9.                        
  10.     WARRANTY
  11.     ──────────────────────────────────────────────────────────────────────
  12.     RVBULL  1.00  is  distributed  without  warranty.  In  no  event  will
  13.     Lightning Software be liable to you  for any damages from running this
  14.     program.  Including any consequential damages arising out of your  use
  15.     of or inability  to use the program,  even if Lightning Software  or a
  16.     authorized  representative has been advised of the possibility of such
  17.     damages.
  18.  
  19.     Lightning Software will not be  liable for any such claim by any other
  20.     party.  All risk associated with  using this program  are the complete
  21.     responsibility of the user.
  22.  
  23.     ACKNOWLEDGEMENTS
  24.     ──────────────────────────────────────────────────────────────────────
  25.     RVBULL.EXE  v1.00 - Copyright  (C) 1993  By  Lightning  Software,  All
  26.     Rights Reserved Worldwide.
  27.     
  28.     RVBULL.EXE v1.00 is written,  coded and debugged entirely in Microsoft
  29.     QuickBasic  4.5,  it  utilizes  the  Assembly  Lanaguage  Toolbox  For
  30.     QuickBasic (by Christy  Gemmell)  as  well as  the QB4BAS  library  of
  31.     assembly functions (by Harold Thompson).
  32.     
  33.     WHAT IS RVBULL.EXE?
  34.     ──────────────────────────────────────────────────────────────────────
  35.     RVBULL.EXE is a utility designed for use with the RBBS-Verify 1.00 and
  36.     above  callback  verification  door  which  will  "purge"  the  door's
  37.     statistic bulletins.  The statistic bulletins RBBS-Verify creates  are
  38.     very interesting bulletins for caller's to view,  however as time goes
  39.     by  and more and more user's use the door,  the bulletins can get very
  40.     large,  then become  too big for the  user to view.  RVBULL eliminates
  41.     this problem by  purging all old statistics and  keeping the  last xxx
  42.     number of lines,  so caller's will no longer have to  browse through a
  43.     huge  bulletin  just to see  the latest  and most  recent  statistics.
  44.     RVBULL also protects you from  loss by always creating backup bulletin
  45.     files, so if in the unlikely event something should go wrong, you will
  46.     still  have your  original unaltered bulletins for  restoration at any
  47.     time.
  48.  
  49.     WARNING: RVBULL   is   intended  for  use  ONLY  with   the  bulletins
  50.              RBBS-Verify creates  and  should NEVER  be  run on any  other
  51.              type  of  bulletin!  RVBULL is  designed  to read  and  write
  52.              bulletins RBBS-Verify creates only  and will more than likely
  53.              damage another bulletin format.
  54.  
  55.                          [ SYSOP DOCUMENTATION PAGE 1 ]
  56.  
  57.     SETTING UP
  58.     ──────────────────────────────────────────────────────────────────────
  59.     The only  step necessary  to  install the RVBULL utility is  to simply
  60.     copy  the executable  (RVBULL.EXE) file  to the directory  holding all
  61.     of your RBBS-Verify files  which you have probably already done anyway,
  62.     there is no initial setup required!
  63.  
  64.     COMMAND LINE SYNTAX
  65.     ──────────────────────────────────────────────────────────────────────
  66.     The key to the operation of RVBULL is it's command line, this is where
  67.     you  will tell the utility necessary information it  needs in order to
  68.     process  your RBBS-Verify statistic  bulletins correctly,  the command
  69.     syntax  is really very simple.  RVBULL uses 2 command line parameters,
  70.     the syntax is as follows:
  71.  
  72.     RVBULL [path/filename of bulletin] [lines to keep]
  73.  
  74.     The  first parameter tells RVBULL the  path and base filename of  your
  75.     statistic bulletins, the bulletin specification should NOT include the
  76.     graphic designator i.e: (C or G), only the base filename.
  77.  
  78.     The  second parameter tells RVBULL how many lines it is to keep in the
  79.     output bulletin,  RVBULL will automatically purge  all old records and
  80.     will  save the last xxx number of lines that you  specify which is the
  81.     most recent statistics. This value can range from 1 to 9999.
  82.  
  83.     The  following is a few example command lines along with  descriptions
  84.     of what each line does:
  85.  
  86.     Example command line #1: RVBULL C:\RBBS\BULLETIN\BULLET1 50
  87.  
  88.     The  above line will  process the bulletin named 'BULLET1' located  in
  89.     the  directory 'C:\RBBS\BULLETIN',  50 most recent lines in the output
  90.     bulletin will be kept.  All old statistics will be purged and removed.
  91.  
  92.     Example command line #2: RVBULL C:\RBBS\BULLETIN\RULES 20
  93.  
  94.     The above line will  process the bulletin named 'RULES' located in the
  95.     directory  'C:\RBBS\BULLETIN',  20 most  recent  lines in  the  output
  96.     bulletin will be kept.  All old statistics will be purged and removed.
  97.  
  98.                          [ SYSOP DOCUMENTATION PAGE 2 ]
  99.  
  100.     OTHER NOTES
  101.     ──────────────────────────────────────────────────────────────────────
  102.     For  even easier use,  you might wish to consider installing RVBULL in
  103.     your  nightly system  event so you will always have a  recent callback
  104.     statistic  bulletin available  for your caller's to  read,  RVBULL has
  105.     been  developed as a completely stand-alone program  requiring no user
  106.     interaction,  therefore it can easily be run as a  nightly event task.
  107.     If you do  however install RVBULL as a nightly system event,  although
  108.     not required,  it is STRONGLY recommended to  disable all nodes  while
  109.     RVBULL  purges  the  statistic  bulletin,  since the  files are  being
  110.     constantly  read and  written  to during  processing,  all  files  are
  111.     managed using  file sharing,  however it is much safer to  disable all
  112.     nodes during processing.
  113.     
  114.     RVBULL always  creates  backup  files everytime the utility is  run to
  115.     protect you from loss, the backup files will be created using the same
  116.     path and filename as the original bulletins,  however will contain the
  117.     extension *.BAK.
  118.  
  119.     RVBULL.EXE is written in QuickBasic 4.5, the program handles it's own
  120.     error  trapping  routines and will  exit cleanly if  an error  occurs
  121.     during execution.
  122.  
  123.     This utility is released as freeware, and may be freely distributed to
  124.     all  BBS's and  online  services  provided  (1.)  the program  is  not
  125.     modified  in ANY WAY SHAPE OR FORM and (2.)  no fee may be charged for
  126.     the program other than a modest disk duplication and packaging charge,
  127.     not to  exceed $6.00 per disk.  As long as the above is followed,  you
  128.     may freely copy and share this program.
  129.  
  130.     SUPPORT FOR RVBULL
  131.     ──────────────────────────────────────────────────────────────────────
  132.     Support for the RVBULL utility can always be obtained from our 24 hour
  133.     a day, 7 day a week technical support BBS (Software Express), set your
  134.     modem to 8,N,1 or 7 data bits and dial (404) 941-2822.
  135.  
  136.            You may also contact us by mail at the following address:
  137.  
  138.                                  Lightning Software
  139.                                     P.O. Box 177
  140.                                Lithia Springs, Ga 30057
  141.  
  142.     We  hope you find RVBULL to  be a useful utility to  help  manage your
  143.     RBBS-Verify  callback verification  door,  if you have  any  comments,
  144.     suggestions,  or improvements you would like to see in RVBULL,  please
  145.     let us know, we would like to hear from you!
  146.  
  147.                          [ SYSOP DOCUMENTATION PAGE 3 ]
  148.  
  149.