home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BBDAT401.ZIP / BBSDAT.DOC < prev    next >
Encoding:
Text File  |  1996-01-15  |  8.4 KB  |  241 lines
  1.  
  2.                               The BBS Database     
  3.                                     v4.0
  4.  
  5.                       (C)Copyright 1995 Lounge Software
  6.                             A BBS Listing Utility 
  7.                              Written by Jim Webb
  8.                              
  9.  
  10.                                 Support board:
  11.  
  12.                               Zippy's Lounge BBS 
  13.                              
  14.                                (403) 475-8703
  15.                               Edmonton, Alberta
  16.                                    Canada
  17.                               
  18.  
  19.  
  20.  
  21.  
  22. WARRANTY:
  23. ---------
  24.  
  25. This product is provided "as is" without warranty of any kind. The entire
  26. risk as to the results and performance of the program is assumed by you.
  27. Futhermore, the author does not warrant, guarantee, or make any other
  28. representations regarding the use of, or the results of the use of the
  29. program, and you rely on the program and results solely at your own
  30. risk. The author cannot and will not accept responsibility for system
  31. damage, loss of profit, or any other special, consequential or incidental 
  32. damages resulting from the use or inability to use this product.
  33.  
  34. USAGE:
  35. ------
  36.  
  37. This product is being distributed as Shareware. Under this concept you 
  38. may use the SHAREWARE (unregistered) version for a reasonable period of 
  39. time for evaluation after which you should either register your copy 
  40. or discontinue usage.
  41.  
  42.  
  43. DISTRIBUTION:
  44. -------------
  45.  
  46. You are encouraged to distribute The BBS Database provided that all 
  47. files contained in the archive are distributed in their original and
  48. unmodified state.
  49.  
  50.  
  51. DESCRIPTION:
  52. ------------    
  53.  
  54. The BBS Database is a BBS Listing Utility Program that can be used on ANY
  55. BBS which creates a DOOR.SYS file(52 line version).  Callers are allowed to
  56. View other BBS's, Extended information on other BBS's, and add their BBS to
  57. the Database.
  58.  
  59.  
  60. REGISTRATION INFORMATION:
  61. -------------------------
  62.  
  63. There are a couple of ways in which you can Register the BBS Database and
  64. recieve your individual key file, which will allow the program to operate in
  65. FULL Registered mode.  Look for details on how to do this in the file:
  66. REGISTER.FRM included with this archive.
  67.  
  68.  
  69. SHAREWARE VS REGISTERED:
  70. ------------------------
  71.  
  72. The SHAREWARE version of The BBS Database has no limitations or is not 
  73. crippled in any way, other than a pause going into the program and out of                             
  74. the program.  This pause is disabled once you have Registered your copy
  75. and you recieve your individual key file.  This is not in place to be
  76. annoying, just to encourage Registration of the product to cover the cost
  77. of programming time and support.  Future versions, updates, and support
  78. of The BBS Database are yours FREE with Registration.
  79.                               
  80.                               
  81. INSTALLATION:                              
  82. -------------
  83.  
  84. Installation of The BBS Database is very simple.  The first thing you 
  85. should do is unzip the entire archive into whichever directory you plan
  86. to operate The BBS Database from.  
  87.  
  88. Then edit the sample configuration file (bbsdat.cfg) that came with the 
  89. archive.  This .cfg file MUST keep the same name bbsdat.cfg!
  90. An explanation of this file is included next. This file resides in the same
  91. directory you have the rest of the archive in: 
  92.  
  93.    
  94.                               CONFIGURATION FILE
  95.                               ==================
  96.  
  97. The format of the configuration file used with The BBS Database is:
  98.  
  99. C:\BBS\DOOR.SYS                 <- FULL path to your DOOR.SYS file
  100. Zippy's Lounge                  <- BBS name
  101. Jim                             <- Sysop's first name
  102. Webb                            <- Sysop's last name
  103. 1000                            <- Security Level needed to access editing
  104.                                    and deleting features!
  105.                                    Includes this Security Level and anything
  106.                                    GREATER than this level.
  107.  
  108. The bbsdat.cfg file MUST contain 5 lines.  You should set line 5 so you as
  109. Sysop and maybe you Co-Sysop(s) also have access to this.  Initially this
  110. line is set to 0 so if you decide to test The BBS Database in local mode at
  111. the Dos Prompt you will be able to see and use the editing and deleting
  112. features.  The BBS Database reads back a security level of 0 when running
  113. from the Dos Prompt in local mode.  Be sure to set line 5 to at least a
  114. Sysop security level before putting The BBS Database on your BBS.  If you
  115. leave it set to 0 then EVERYONE will be able to edit and delete BBS's!
  116.  
  117.  
  118. That's it!  Now you're ready to run The BBS Database on your BBS!
  119.  
  120.  
  121. RUNNING THE PROGRAM:
  122. --------------------
  123.  
  124. This part is basically up to you.  Depending on which BBS program you are 
  125. running, the .bat file may look a little different.  Refer to your BBS
  126. Manual for information on running Doors from your BBS.  We will use a
  127. sample .bat file which would run The BBS Database from a Wildcat System:
  128.  
  129. DOOR10.BAT
  130. ==========
  131.  
  132. CD\DOORS\DATABASE
  133. BBSDAT BBSDAT.CFG
  134. CD\WC30
  135.  
  136.  
  137. If you would like to test The BBS Database before putting it up on the BBS,
  138. you can run it locally at any time by typing LOCAL after the call line:
  139.  
  140. EX: BBSDAT BBSDAT.CFG LOCAL
  141.  
  142.  
  143.  
  144. FOSSIL DRIVER SUPPORT:
  145. ----------------------
  146.  
  147. The BBS Database supports the use of Fossil drivers.  To tell it to use the
  148. Fossil driver instead of the standard COM ports, just put /FD on the command
  149. line when running the door. For example:
  150.      
  151.      BBSDAT BBSDAT.CFG /FD
  152.  
  153. indicates that a Fossil driver is present and should be used. If no Fossil
  154. driver is detected, The BBS Database will print a message to that effect 
  155. and exit back to the BBS gracefully.
  156.  
  157.  
  158. ENVIRONMENT VARIABLES:
  159. ----------------------
  160.  
  161. The BBS Database supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 
  162. and COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  163. number after the configuration filename. Let's assume you want to use COM1 
  164. and IRQ5. The command line passed in the .bat file would be:
  165.     
  166.     BBSDAT BBSDAT.CFG /5  or
  167.     BBSDAT BBSDAT.CFG /%IRQ%  for the environment variable.
  168.  
  169. The /5 tells The BBS Database to use IRQ5 rather than the standard IRQ4 that
  170. is normally used with COM1. No /x parameter is needed for the standard IRQ's.
  171.  
  172.  
  173. UP AND RUNNING:
  174. ---------------
  175.  
  176. When The BBS Database is up and running, it will create one file.  This file
  177. is called bbs.dat.  This stores the information entered by the caller when
  178. they add a BBS to the Database.  At any point and time you may delete this
  179. file and clear the contents of the Database.  
  180.  
  181. While online The BBS Database will recognize your security level of being one 
  182. that allows editing and deleting, this will activate the SPECIAL EDIT 
  183. FEATURES!  When you select [V]iew BBS's from the Main Menu, The BBS Database 
  184. will give YOU two additional options:
  185.  
  186. [E]dit a BBS
  187. [D]elete a BBS
  188.  
  189. When deleting, The BBS Database will ask you which BBS and all you have to do
  190. is type in the BBS's number.   
  191.  
  192. The same goes for [E]dit a BBS...This option brings up the chosen BBS's info
  193. and allows you to edit through it as you see fit.  It will then save the NEW
  194. information that you provide.
  195. That's about it!  Any comments, suggestions or problems, please contact me
  196. at the below mentioned BBS.  Thanks for trying The BBS Database!
  197.  
  198.  
  199. 486DX CPU's:
  200. ------------
  201.  
  202. The math coprocessor in 486DX CPUs cannot handle floating point math which
  203. all MicroSoft Basic's use. This can show up as an ERROR 5, a keyboard 
  204. timeout, etc.
  205.  
  206. Fortunately there is an easy fix for this problem. Simply place the following
  207. line in your AUTOEXEC.BAT file:
  208.  
  209. SET NO87=ON
  210.  
  211.  
  212. ERRORS & PROBLEMS:
  213. ------------------
  214.  
  215. If you encounter any problems while the door is running, it will generate a 
  216. file called "dframe.err" and list the error in there.  I have included the
  217. error codes and some additional information on fixing them in the file
  218. "error.qb" included with this archive.
  219.  
  220.                   
  221.  
  222. SPECIAL THANKS TO:
  223. ------------------
  224.  
  225. My wife Lynn for her continued support & assistance.  Without out her I would
  226. be a babbling idiot and the computer would be in a million pieces!
  227.  
  228.  
  229. PRODUCT SUPPORT & UPGRADES:
  230. ---------------------------
  231.  
  232. You can recieve support and newer versions of The BBS Database as they come
  233. out, by calling:
  234.  
  235. Zippy's Lounge BBS
  236.  
  237. (403) 475-8703
  238.  
  239. Edmonton, Alberta
  240. Canada
  241.