home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / GAPLOCK.ZIP / GAPLOCK.DOC < prev    next >
Encoding:
Text File  |  1993-03-21  |  5.1 KB  |  125 lines
  1.  ═══════════════════════════════════════════════════════════════════════════
  2.  
  3.                GAPLOCK Release 1.0
  4.  
  5.                       Multi-Node BBS Event Utility!
  6.  
  7.                               Written by:
  8.                               Jerry Liddle
  9.                             119 Edward Drive
  10.                       Swedesboro, New Jersey 08085
  11.  
  12.                              The Beckett BBS
  13.                   (609) 467-3898 USR 14.4 Dual Standard
  14.                   (609) 467-8612 USR 16.8 Dual Standard
  15.                      (609) 467-0515 14.4 Boca V.32bis
  16.  ═══════════════════════════════════════════════════════════════════════════
  17.  
  18.                    Warranty
  19.  
  20.  This product is provided "as is" without warranty of any kind. The entire
  21.  risk as to the results and  performance of the program is assumed by you.
  22.  Futhermore, the  author does  not warrant, guarantee, or  make any  other
  23.  representations regarding  the use of,  or the  results of the use of the
  24.  program,  and you  rely on the  program and  results  solely at  your own
  25.  risk.  The author  cannot and  will not accept  responsibility for system
  26.  damage, loss of profit, or any other special, consequential or incidental 
  27.  damages  resulting  from  the  use  or  inability  to  use this  product.
  28.  
  29. Overview of GAPLOCK
  30. ──────────────────────────────────────────────────────────────────────────
  31.   
  32. Since I run a multi-node BBS, and have events that require all nodes
  33. to be down, I wrote GAPLOCK to keep the other nodes busy while one was
  34. performing board maintenance.
  35.  
  36. Command Line Parameters for GAPLOCK are:
  37.  
  38.     GAPLOCK [Flag] [Path] [Delay] {BBS Name}
  39.     Items in [] are required.  Items in {} are optional.
  40.  
  41.     Valid entries for [Flag] :  LOCK    (sets a LOCK condition)
  42.                                 UNLOCK  (clears a LOCK condition)
  43.                                 CHECK   (checks for a LOCK condition)
  44.  
  45.     Valid entries for [Path] :  Any valid DOS path on your system.
  46.                                 GAPLOCK creates a data file called
  47.                                 GAPLOCK.DAT.  This file will contain
  48.                                 either one of two words (LOCK or UNLOCK)
  49.                                 GAPLOCK.DAT will be created where you
  50.                                 specify in the Path parameter.
  51.  
  52.    Valid entries for [Delay] :  Number of second to have GAPLOCK delay
  53.                                 before starting to check for a LOCK
  54.                                 condition.  You must enter a 0 (zero) in
  55.                                 the Delay parameter when Flag is LOCK or
  56.                                 UNLOCK.
  57.  
  58.  Optional entry for BBS Name :  Just out of my own vanity, I have my 
  59.                                 BBS name displayed on the delay screen
  60.                                 if a delay is set.  To display a BBS Name,
  61.                                 type it on the command line after the Delay
  62.                                 time when the Flag Check is used.  You can 
  63.                                 enter up to four words each separated by a
  64.                                 space.  As a matter of fact, all parameters
  65.                                 must be separated by a space, and naturally
  66.                                 don't include the brackets.
  67. EXAMPLE:
  68.  
  69. FIRST:
  70.  
  71. This is the way that I use GAPLOCK.  On the node that will be doing the 
  72. actual maintenance, insert the following as the first line in your 
  73. EVENT.BAT file.
  74.  
  75.     GAPLOCK lock f:\work 0
  76.  
  77. This will create the GAPLOCK.DAT file on f:\work, and it will contain
  78. the word LOCK.
  79.  
  80. The last line in the EVENT.BAT file should contain the following.
  81.  
  82.     GAPLOCK unlock f:\work 0
  83.  
  84. This will remove the LOCK condition in GAPLOCK.DAT
  85.  
  86. SECOND:
  87.  
  88. In each of my other nodes's EVENT.BAT files I have the following as the
  89. only command for that that event.
  90.  
  91.     GAPLOCK check f:\work 300 The Beckett BBS
  92.  
  93. When this event is executed, GAPLOCK waits for 5 minutes (just incase
  94. the node performing maintenance didn't get started on time.  After 5 minutes
  95. GAPLOCK will begin checking f:\work\gaplock.dat for a LOCK condition.
  96.  
  97. GAPLOCK will continue checking GAPLOCK.DAT every 5 seconds until the LOCK
  98. condition is removed by the node performing maintenance.
  99.  
  100. Files needed for GAPLOCK Operation
  101.  
  102.     The only file needed for GAPLOCK to operate is GAPLOCK.EXE
  103.     It creates it's own data file.
  104.  
  105.  
  106. One other note:
  107.  
  108.     The Delay screen can be aborted by pressing Any Key.
  109.     GAPLOCK can be aborted by pressing the ESC Key
  110.  
  111.     GAPLOCK can be tested from the command line, if you want to see
  112.     how it works...  
  113.  
  114. ──────────────────────────────────────────────────────────────────────────
  115. If you have any doubt about the integrity of the files contained in this
  116. Archive, feel free to call my BBS in Swedesboro, New Jersey and download
  117. the latest version.  The Beckett BBS, (609)467-3898/8612/0515
  118.  
  119. Registration - Support the Shareware Concept...
  120. ──────────────────────────────────────────────────────────────────────────
  121. GAPPLOCK is not crippled in any way.  If you find it useful, I would
  122. gladly accept a donation.  Whatever you feel it is worth...
  123.  
  124. Thanks for your support!
  125.