home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / qbbsetc / qkbira20.lzh / QKBIRA.DOC < prev    next >
Text File  |  1990-11-24  |  4KB  |  104 lines
  1.                   QKBImodemRemoteAccess Interface v2.0
  2.  
  3.          (c) Copyright 1990, Christopher Hall - Albuquerque, NM
  4.                           All Rights Reserved
  5.  
  6.                             Christopher Hall
  7.                            6067 McKinney, NE
  8.                         Albuquerque, NM   87109
  9.                              (505)821-5341
  10.                             FidoNet 1:301/2
  11.                           CompuServe 72150,752
  12.  
  13. ----------------------------------------------------------------------------
  14.  
  15. Introduction:
  16.  
  17.   I recently converted my system over to the Remote Access BBS package
  18. after quite a few years running QuickBBS.  I won't go into the details
  19. as to why.  Anyway, since I already had a standard QuickBBS to Bimodem
  20. Interface (QkBiLog) I decided it would be easy to switch over and adapt
  21. the existing code for Remote Access.  QkBiRa is the result of that
  22. conversion.
  23.  
  24.   I've never liked having to run Bimodem through an external protocol
  25. selection since the user should already have a Bimodem.Pth file created.
  26. Thus, QkBira is designed to be run either through a Type 7 or Type 15
  27. exit from Remote Access.  Once invoked, QkBira will:
  28.  
  29.      - Read the ExitInfo.BBS file and determine all the necessary
  30.        information to pass to Bimodem - Time Remaining, Download Limits,
  31.        etc. are ALL taken into account.
  32.  
  33.      - Write a QkBiRa.Dir file as specified in the QkBira.Cfg.
  34.        Your Bimodem.Cfg should point to this file in the Filenames and
  35.        Paths section as the "Directory or List of Directories files are
  36.        sent from".  When written, this file reads FILES.RA and enables
  37.        all available file area a user has access to based on security
  38.        level and flag settings.
  39.  
  40.      - Once the transfer is completed, the Files.BBS (or PFile.BBS if
  41.        Private is enabled in the QkBira.Cfg) is updated with
  42.        successfully uploaded filenames and descriptions (and the [x]
  43.        Download counter is placed if Counters is enabled).
  44.  
  45.        If NO descriptions were entered in the user's Bimodem.Pth file,
  46.        the FOSSIL driver is initiated to prompt the user for file
  47.        descriptions. There is a time-out delay if no user activity takes
  48.        place in 5 minutes, as well as, a Carrier Detect routine so that
  49.        QkBiRa will exit and cycle back to the board.
  50.  
  51.      - The ExitInfo.BBS file is updated with all pertinent User stats.
  52.  
  53.      - A Log Entry is written to the RA.LOG.
  54.  
  55.      - A Log Entry is made to the transfer log as specified in the
  56.        Bimodem.Cfg file if Log is enabled in the QkBiRa.Cfg.
  57.  
  58. Note:  Since Bimodem uses the QkBiRA.Dir file for searching for
  59. downloads, etc.  - Users can d/l from ANY file area that they have
  60. access to! See the Bimodem Documentation for details on this feature, as
  61. well as, how to set up the Bimodem.Cfg file.
  62. ----------------------------------------------------------------------
  63.  
  64. Setup:
  65.  
  66.   The easiest setup is simply to:
  67.  
  68.    - UnZip QkBira into your Remote Access system directory.
  69.  
  70.    - Edit the QkBiRa.Cfg file to suit your own configuration.
  71.      (I've found it best to copy the Bimodem.Cfg file over to your RA
  72.      System directory to minimize the command parameter length)
  73.  
  74.    - Add a Menu Option in your File Template to run Bimodem.
  75.      (I use a separate Bimodem.Mnu that gives the caller a second
  76.      chance just in case they hit the Hot Key in error)
  77.  
  78.      Specify a Type 7 Menu with Optional Data as:
  79.      QkBira.Exe QkBiRa.Cfg [Locked Baud Rate]
  80.  
  81. That's all there is to it!
  82.  
  83. Command Syntax:  QkBira [QkBira.Cfg [Locked_Baud_Rate]]
  84.  
  85. If no parameters are given - QkBira.Cfg is assumed.  In order to use a
  86. Locked Baud Rate, the config file name MUST be used.
  87.  
  88. ------------------------------------------------------------------------
  89.  
  90. Thanks go to:
  91.  
  92.    John Erickson   - Bimodem (Phoenix, Az)
  93.    Andrew Milner   - Remote Access (Perth, Australia)
  94.    Ed Meloan       - US Contact for Remote Access (Great Support!)
  95.    Chris Carpenter - My local Beta Tester.
  96.  
  97. ************************** NOTE ****************************************
  98. If you use this program and find it of value, a contribution of $10.00
  99. would be greatly appreciated! In any event, I would appreciate hearing
  100. from any Sysops who are using this program. I can be reached through the
  101. Bimodem Echo or directly through PC Network.
  102. ************************************************************************
  103.  
  104.