home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / PCBUW10.ZIP / PCBUWAIT.DOC < prev    next >
Text File  |  1994-03-06  |  7KB  |  180 lines
  1.  
  2.  
  3.  
  4.  
  5.                            PCBUtility Package
  6.                      PCBoard UserNet Wait Utility  v1.0
  7.                         Version 1.0    03/06/94
  8.                           Copyright (c)  1994
  9.                              Casto Software
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 WARNING
  17.                                 -------
  18.  
  19.           As with all new software it is * strongly * recommended that
  20.         you have a recent backup just in case.
  21.  
  22.  
  23.  
  24.  
  25.                                 LEGAL
  26.                                 -----
  27.  
  28.           David Casto hereby disclaims all warranties relating to this
  29.         software, whether express or implied, including without
  30.         limitation any implied warranties of merchant ability or
  31.         fitness for a particular purpose. David Casto will not be
  32.         liable for any special, incidental, consequential, indirect or
  33.         similar damages due to loss of data or any other reason, even
  34.         if David Casto or an agent of David Casto has been advised of
  35.         the possibility of such damages.  In no event shall David
  36.         Casto liability for any damages ever exceed the price paid for
  37.         the license to use software, regardless of the form of the
  38.         claim.  The person using the software bears all risk as to the
  39.         quality and performance of the software.
  40.  
  41.           You are free to distribute this software as long as there
  42.         are no modifications to any files in this archive.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                 What Is It?
  49.                                 -----------
  50.  
  51.           This program is an event wait utility that will poll the
  52.         PCBoard UserNet.xxx file and hold a node down until the other
  53.         node reloads PCBoard or exits PCBoard.  This is not a blind
  54.         wait utility as it will release the node only if the other
  55.         node is up or down (or if the MAX. time limit has been reached).
  56.  
  57.           This program will return a DOS ERRORLEVEL of 10 if the node
  58.         it is waiting on is either up or down.
  59.  
  60.  
  61.                                 Installation
  62.                                 ------------
  63.  
  64.           You must have PCBUtility set up in order to use this
  65.         program.  Use a text editor and edit your event batch file(s)
  66.         to resemble the ones below.
  67.  
  68.           The following event examples assumes that node 1 is
  69.         running the system event on a three node system and:
  70.  
  71.                 Node 1 is in the C:\PCB directory
  72.                 Node 2 is in the C:\PCB2 directory
  73.                 Node 3 is in the C:\PCB3 directory.
  74.  
  75.           In your system event batch file place these lines:
  76.  
  77.                 REM -- Make sure Node 2 dropped to the event --
  78.                 PCBUWait Down:2:999
  79.                 REM -- Make sure Node 3 dropped to the event --
  80.                 IF ERRORLEVEL == 10 PCBUWait Down:3:999
  81.                 REM -- IF Node 2 and Node 3 dropped to their events --
  82.                 REM -- it is safe to run the system event. --
  83.                 IF ERRORLEVEL == 10 GOTO EVENT
  84.                 REM -- One of the Nodes did not drop to the event. --
  85.                 REM -- Play it safe and skip the system event --
  86.                 REM -- and reload this node. --
  87.                 GOTO END
  88.                 :EVENT
  89.                 REM -- Node 2 and Node 3 are down --
  90.                 REM -- It's safe to run the system event. --
  91.                 REM * Your Event Process Goes Here *
  92.                 :END
  93.                 C:
  94.                 CD\PCB
  95.                 Board
  96.  
  97.           In your node 2 event batch file place these lines:
  98.  
  99.                 REM -- Make sure Node 1 dropped to the event --
  100.                 PCBUWait Down:1:999
  101.                 REM -- If node 1 dropped to the event then wait --
  102.                 REM -- otherwise bypass the next --
  103.                 REM -- two lines and reload this node or reboot --
  104.                 IF ERRORLEVEL == 10 PCBUWait UP:1:999
  105.                 IF ERRORLEVEL == 10 GOTO RELOAD
  106.                 REM -- Node 1 did not reload is it locked? --
  107.                 REM -- If node 1 is locked you could use --
  108.                 REM -- a reboot utility here. Or let it continue --
  109.                 REM -- to reload this node. --
  110.                 :RELOAD
  111.                 REM -- If the ErrorLevel was 10 then node 1 --
  112.                 REM -- reloaded so reload this node. --
  113.                 C:
  114.                 CD\PCB2
  115.                 Board
  116.  
  117.           In your node 3 event batch file place these lines:
  118.  
  119.                 REM -- Make sure Node 1 dropped to the event --
  120.                 PCBUWait Down:1:999
  121.                 REM -- If node 1 dropped to the event then wait --
  122.                 REM -- otherwise bypass the next --
  123.                 REM -- two lines and reload this node or reboot --
  124.                 IF ERRORLEVEL == 10 PCBUWait UP:1:999
  125.                 IF ERRORLEVEL == 10 GOTO RELOAD
  126.                 REM -- Node 1 did not reload is it locked? --
  127.                 REM -- If node 1 is locked you could use --
  128.                 REM -- a reboot utility here. Or let it continue --
  129.                 REM -- to reload this node. --
  130.                 :RELOAD
  131.                 REM -- If the ErrorLevel was 10 then node 1 --
  132.                 REM -- reloaded so reload this node. --
  133.                 C:
  134.                 CD\PCB3
  135.                 Board
  136.  
  137.  
  138.  
  139.  
  140.                            Command Line Syntax
  141.                            -------------------
  142.  
  143.                 PCBUWait Action:Node#:MaxSeconds
  144.  
  145.                          Action is either UP or DOWN
  146.                          Node# is the node to poll (wait on)
  147.                          MaxSeconds is the maximum seconds to wait
  148.  
  149.  
  150.               Examples:
  151.  
  152.                 PCBUWait Down:1:999
  153.  
  154.                         This node will wait 999 seconds for node 1 to
  155.                         drop to the event.  If node 1 drops to the
  156.                         event before 999 seconds PCBUWait will return
  157.                         a DOS ErrorLevel of 10.
  158.  
  159.  
  160.                 PCBUWait Up:1:999
  161.  
  162.                         This node will wait 999 seconds for node 1 to
  163.                         reload PCBoard.  If node 1 reloads PCBoard
  164.                         before 999 seconds PCBUWait will return a DOS
  165.                         ErrorLevel of 10.
  166.  
  167.  
  168.  
  169.  
  170.                                 Summary
  171.                                 -------
  172.  
  173.                   If you would like to see further enhancements of
  174.                 this program then please communicate them to me by
  175.                 voice or BBS.
  176.  
  177.                 Voice: 614-882-0993 
  178.  
  179.                 BBS: 614-882-0994 
  180.