home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / RAINUSE1.ZIP / RA-INUSE.DOC < prev   
Encoding:
Text File  |  1991-11-10  |  10.2 KB  |  252 lines
  1.                   ╓─╖ ╓─╖    ╓╥╖ ╓╖ ╓     ╓ ╓ ╓─ ╓──
  2.                   ║ ║ ║ ║     ║  ║║ ║     ║ ║ ║  ║
  3.                   ╟╥╜ ╟─╢    ║  ║╙╖║    ║ ║ ╙╖ ╟─
  4.                   ║╙╖ ║ ║     ║  ║ ║║     ║ ║  ║ ║
  5.                   ╙ ╙ ╙ ╙    ╙╨╜ ╙ ╙╜     ╙─╜ ─╜ ╙──
  6.  
  7.        Multi-Node Door Kit v1.00 by Brian Tardiff & Mark Warnat
  8.  
  9.             HysteriaWare Software from The MASS Hysteria BBS
  10.             Line #1: (508)465-3198  300-9600 HST  Mail/Users
  11.             Line #2: (508)462-1565  300-2400 Bps  Users Only
  12.                          Fido-Net 1:324/174
  13.  
  14. ════════════════════════════════════════════════════════════════════════════
  15.  
  16.  
  17. What is RA-In-Use?
  18. ══════════════════
  19.  
  20.    RA-In-Use is the "fixed up" version of a program we have been using on
  21.    our system for almost a year now.  This program will allow a multi-node
  22.    system to safely run doors that were designed for single node systems.
  23.  
  24.  How?
  25.  
  26.    RA-In-Use will only allow one user in a specific door at a time.  If
  27.    a user enters a door which is already being used on another node, the
  28.    user will get an information screen saying why he or she can't enter
  29.    the door INSTEAD of being granted access to the system.
  30.  
  31.  Is it easy to set up?
  32.  
  33.    We have included numerous batch files on how to run certain doors under
  34.    a multi-node environment.  We have even gone so far as rigged doors
  35.    to run that have to specify only 1 communication port in their config
  36.    file.  Lets be honest.  IF YOU ARE A NOVICE SYSOP AND HAVE NO KNOWLEDGE
  37.    OF HOW BATCH FILES WORK, you may have some trouble with this program.
  38.    However, if you are a beginner, and FOLLOW our examples, its really
  39.    not that hard.
  40.  
  41.  Will it work on my system?
  42.  
  43.    If you run QuickBBS, RemoteAccess, or ANY other BBS package that uses
  44.    the Quick/RA DORINFO1.DEF file, then this will work for you!  The
  45.    DORINFO1.DEF file is the only "system file" used by this package.
  46.  
  47.  
  48. Installing RA-In-Use
  49. ════════════════════
  50.  
  51.    The RA-In-Use program must be installed on a door-to-door basis.  However,
  52.    once you have one door set-up, you can usually simply duplicate the
  53.    batch file and change the program names inside it.  Also, if you run
  54.    a door that we have included, simply change the paths to match your
  55.    system and use it!  This section will include:
  56.  
  57.                   1) Overview of the two programs
  58.                   2) Running the door from RA or QUICKBBS
  59.                   3) A detailed description of an actual batch file
  60.  
  61.    1) DOORINUSE.EXE and PUTINUSE.EXE
  62.  
  63.       These are the two external programs that make up this package.  Place
  64.       these in a PATHED DIRECTORY WHERE THEY CAN BE RUN FROM ANY DIRECTORY.
  65.       If you do not wish to put them in a pathed directory, you will have
  66.       to copy them into each individual door directory.
  67.  
  68.              PUTINUSE.EXE
  69.  
  70.                      Put-In-Use is the program that makes the door "In-Use"
  71.                      once a user enters it.  This part takes down the
  72.                      system information and the name of the user who is
  73.                      using the door.  It creates the data file INUSE.DAT.
  74.  
  75.                       syntax  : PUTINUSE.EXE [Path to DORINFO1.DEF]
  76.  
  77.                       example : PUTINUSE.EXE C:\RA\LINE1
  78.  
  79.              DORINUSE.EXE
  80.  
  81.                      Door-In-Use is the part of the program that informs
  82.                      the user trying to use the in-use door that the door
  83.                      is currently being used on the other line.
  84.  
  85.                       syntax  : DORINUSE.EXE [Path DORINFO1.DEF] [Name_Door]
  86.  
  87.                       example : DORINUSE.EXE C:\RA\LINE1 Trade_Wars
  88.  
  89.                      All spaces in the Name of Door must be replaced with
  90.                      the _ character.  They will be stripped out before
  91.                      they are displayed.
  92.  
  93.  
  94.    2) Running from the Bulletin Board
  95.  
  96.       Hopefully you run a system where the only difference in paths is the
  97.       difference in the node number.  (ie: \RA\LINE1 and \RA\LINE2).  If
  98.       you use this type of system, then this will work for you.  You'll
  99.       see why later.
  100.  
  101.       To run a door from the bbs, you must run the door and pass the
  102.       communication port along to the batch file.  To do this with
  103.       a QuickBBS or RemoteAccess system, execute a Type 7 door command
  104.       with the optional data:
  105.  
  106.                      COMMAND.COM /C FILENAME.BAT *N
  107.  
  108.             Note: If you aren't using QuickBBS or RA, check your BBS
  109.                   docs to see how to pass com port # to a batch file.
  110.  
  111.       The *N will be passed to the batch file as the first parameter.
  112.       Otherwise known as %1.  When these batch files look for the
  113.       system files, they look in C:\RA\LINE%1.  If the %1 was a 1 (for node
  114.       one) then the program will look in C:\RA\LINE1 and if the %1 was
  115.       a 2, it would look in C:\RA\LINE2 and so on... Your paths will
  116.       probably be different than ours, but as mentioned earlier, if
  117.       the only difference between the paths is the node it represents,
  118.       this will work!
  119.  
  120.  
  121.    4) An example batch file!
  122.  
  123.       This will probably be the most valuable section of the docs.  The
  124.       following is a batch file that runs a door that simply needs to
  125.       find the directory that the system files are in.
  126.  
  127.  
  128.               CD\PROGRAM
  129.  
  130.               If Exist InUse.Dat Goto SkipDoor
  131.  
  132.         PutInuse.Exe C:\RA\LINE%1
  133.         PROGRAM C:\RA\LINE%1
  134.                 Del InUse.Dat
  135.                 Goto End
  136.  
  137.               :SkipDoor
  138.                 DorInUse.Exe C:\QUICKBBS\LINE%1 Dummy_Program
  139.  
  140.           :End
  141.               CD\
  142.               CD\RA\LINE%1
  143.  
  144.           Overview: The batch file switches to the door directory.  The next
  145.             line tells the batch file that "if you find the file
  146.             INUSE.DAT (which means the door is currently being
  147.             used), then skip to the heading marked :SkipDoor and
  148.             run the Door-In-Use Program".  If the file doesn't
  149.                     exist, it procedes with the batch file.  By
  150.             continuing, it does the following:
  151.  
  152.                   ■ Puts the door in use
  153.                   ■ Runs the door telling it which dir to find
  154.                 its data files.
  155.                   ■ Deletes the INUSE.DAT file so the door is
  156.                 now open to all lines.
  157.                   ■ Skips to the :END so DorInUse won't run.
  158.  
  159.  
  160. Special Techniques
  161. ══════════════════
  162.  
  163.         All doors should follow the example batch file.  However, HOW the
  164. door needs to be run with vary from program to program.  Therefore, after
  165. the door is Put-In-Use, you may have to "rig" your specific door to
  166. work.  The above example was easy because the door took all information
  167. (such as Com Port) from the Quick/RA EXITINFO.BBS or DORINFO1.DEF files.
  168. Heres what to do in the following situations:
  169.  
  170.    1) The COM is specified in the door's config file
  171.  
  172.         Some doors require that you specify which COM port the door is
  173.         to be run on.  To get around this problem, make more than one
  174.         config file.  If you have two nodes, you will create a
  175.         FILENAME.CF1 and FILENAME.CF2, each with the com port for
  176.         each node.
  177.  
  178.         If the door allows you to specify the config file name, simply
  179.         run the door like this:
  180.  
  181.                         PROGRAM.EXE FILENAME.CF%1
  182.  
  183.                         If its node 1, it will look for FILENAME.CF1 and if
  184.                         its node 2, it will look for FILENAME.CF2.
  185.  
  186.         However, say the door has to have a certain config file.  If the
  187.         door always looks for FILENAME.CFG, then do this:
  188.  
  189.                         COPY FILENAME.CF%1 FILENAME.CFG
  190.  
  191.                         If its node 1, it copies the CF1 file to the name
  192.                         the door looks for.  If its CF2 then it copies
  193.                         the node 2 file.
  194.  
  195.  
  196.    2) Door must be run where EXITINFO.BBS/DORINFO1.DEF are.
  197.  
  198.         The original example shows what to do if a path can be specified
  199.         where the door can locate system files.  If the door was written
  200.         to run the directory where DORINFO1.DEF or EXITINFO.BBS were
  201.         created, simply copy the appropriate file into the directory
  202.         where you want to run the door from.  To get the right node's
  203.         files, do the following:
  204.  
  205.                         COPY C:\RA\LINE%1\DORINFO1.DEF
  206.                         COPY C:\RA\LINE%1\EXITINFO.BBS
  207.  
  208.                         If its node 1, the system files created will
  209.                         be copied from C:\RA\LINE1 into the directory
  210.                         which the door is run.  If its node 2, the
  211.                         files from C:\RA\LINE2 are copied.
  212.  
  213.  
  214. Assistance
  215. ══════════
  216.  
  217.         Hopefully you understand the concept of this package.  This
  218. documentation file was incredibly difficult to write because of the
  219. "concept" of it.   Here at MASS Hysteria, we have not come across
  220. a door setup yet that we haven't been able to run multi-node.  If
  221. you cannot get a door set-up, we will try and assist you.  Please
  222. do the following:
  223.  
  224.                 Send the following to 1:324/174 (or call as a user)
  225.  
  226.                         1) The .ZIP door package you are running
  227.                         2) NET-Mail explaining your problem and
  228.                            a filename.  We will attempt to run get
  229.                            the door running, and if successful,
  230.                            we will make a zip file using the name
  231.                            you sepcify so you can F'Req it.  The
  232.                            zip will have the batch file in it.
  233.  
  234.                 Note: PLEASE check and see that we haven't included
  235.                       a batch file for your door before you call
  236.                       our system for assistance.
  237.  
  238.  
  239. One final note
  240. ══════════════
  241.  
  242.    Since we never charge a lot of money to register our "BIG" doors, it
  243. only makes sense to allow the public to use things like this for free.  Our
  244. attitude at Hysteria is that computer programming should be fun and the
  245. author should get satisfaction that other people have interest in his
  246. programs.  People that require $10.00+ dollars for insignificant programs
  247. are greedy.  We enjoy what we do....so please, you enjoy it too!
  248.  
  249.  
  250.                                         Brian R. Tardiff & Mark R. Warnat
  251.                                         HysteriaWare Software
  252.