home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CPS10.ZIP / CPS.DOC < prev    next >
Text File  |  1995-02-05  |  12KB  |  294 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │============================│
  4.                       │Consumer Product Safety Door│
  5.                       │============================│
  6.                       │COPYRIGHT 1995 T&J Software │
  7.                       └────────────────────────────┘
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.                UltraBBS, Telegard, TriBBS, and Remote Access.
  11.  
  12.  
  13.                        VERSION 1.00     02/05/95
  14.  
  15.                                    By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.                    *between 6:00 & 8:00 p.m. Eastern Time
  23.  
  24.                                   From
  25.  
  26.                            The T&J Software BBS
  27.                         NODE 1: (717)325-9481 28.8k
  28.                         NODE 2: (717)325-4369 28.8k
  29.                         NODE 3: (717)325-2054 28.8k
  30.                                24 Hours/Day
  31.  
  32.                  INTERNET:  tjsoft@postoffice.ptd.net
  33.  
  34.  
  35. LATEST VERSION:
  36. ^^^^^^^^^^^^^^^
  37. Please call the T&J BBS for the latest version of this program.
  38.  
  39. LEGALITIES:
  40. ^^^^^^^^^^^
  41. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  42. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  43. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  44. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  45. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  46. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  47.  
  48. DISTRIBUTION:
  49. ^^^^^^^^^^^^^
  50. Please feel free to distribute this door.
  51.  
  52. PROGRAM DESCRIPTION:
  53. ^^^^^^^^^^^^^^^^^^^^
  54. The Consumer Product Safety Door contains databases that your BBS users
  55. may find beneficial dealing with important information on product recalls
  56. and safety. They may search the entire database online and also read the
  57. information online.
  58.  
  59. The demo door does not expire and is not crippled in any way. Updated
  60. databases my be downloaded from the T&J Software BBS free of charge!
  61. Registering this door will help us maintain it! We currently plan on
  62. updating the database on a weekly basis with the latest information from
  63. the Consumer Product Safety Commission - registration will help us
  64. maintain our links to the CPSC and updating the database to bring
  65. your users the latest information.
  66.  
  67. Additional databases will be available to download from our BBS in
  68. file area #1 as CPSC#xxx.ZIP where xxx=database update number. Updated or
  69. additional database .ZIP files must be unzipped in the order they are
  70. created. If there is a CPSC#1.ZIP and CPSC#2.ZIP first unzip the #1 file
  71. in the CPS directory and then unzip the #2 file (overwrite all files).
  72. That's all you'll have to do to add new databases - pretty easy!
  73.  
  74. TEXT COLOR:
  75. ^^^^^^^^^^^
  76. Simply edit the file COLOR.DAT, lines 1 and 2. Here's the file:
  77.  
  78. 14
  79. 3
  80.  
  81. Line 1: Foreground Color
  82. Line 2: Background Color
  83.  
  84. Foreground:   15 = Bright White     Background: 7 = Default White
  85.               14 = Bright Yellow                6 = Light Yellow
  86.               13 = Bright Purple                5 = Light Purple
  87.               12 = Bright Red                   4 = Light Red
  88.               11 = Bright Cyan                  3 = Light Cyan
  89.               10 = Bright Green                 2 = Light Green
  90.                9 = Bright Blue                  1 = Light Blue
  91.                8 = Dark Grey
  92.                7 = Default White
  93.                6 = Light Yellow
  94.                5 = Light Purple
  95.                4 = Light Red
  96.                3 = Light Cyan
  97.                2 = Light Green
  98.                1 = Light Blue
  99.  
  100. CONFIGURATION: (The CPS.CFG file)
  101. ^^^^^^^^^^^^^^
  102. Run --->  CPS UTILITY   to easily setup your CPS.CFG file!
  103.  
  104.  
  105. Example configuration file for PCBOARD.SYS
  106. ------------------------------------------
  107. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  108. T&J Software        <=-  (Change this to your BBS name)
  109. Tom                 <=-  (The Sysop's first name)
  110. Wildoner            <=-  (The Sysop's last name)
  111.  
  112. Example configuration file for USERS.SYS
  113. ----------------------------------------
  114. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  115. T&J Software        <=-  (Change this to your BBS name)
  116. Tom                 <=-  (The Sysop's first name)
  117. Wildoner            <=-  (The Sysop's last name)
  118.  
  119. Example configuration file for DOOR.SYS
  120. ---------------------------------------
  121. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  122. T&J Software        <=-  (Change this to your BBS name)
  123. Tom                 <=-  (The Sysop's first name)
  124. Wildoner            <=-  (The Sysop's last name)
  125.  
  126. Example configuration file for USERINFO.DAT
  127. -------------------------------------------
  128. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  129. T&J Software        <=-  (Change this to your BBS name)
  130. Tom                 <=-  (The Sysop's first name)
  131. Wildoner            <=-  (The Sysop's last name)
  132. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  133.  
  134. Example configuration file for CALLINFO.BBS
  135. -------------------------------------------
  136. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  137. T&J Software        <=-  (Change this to your BBS name)
  138. Tom                 <=-  (The Sysop's first name)
  139. Wildoner            <=-  (The Sysop's last name)
  140.  
  141. Example configuration file for DORINFOx.DEF
  142. -------------------------------------------
  143. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  144.                           where 'x' is the BBS Node number.
  145. T&J Software        <=-  (Change this to your BBS name)
  146. Tom                 <=-  (The Sysop's first name)
  147. Wildoner            <=-  (The Sysop's last name)
  148.  
  149. Example configuration file for SFDOORS.DAT
  150. ------------------------------------------
  151. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  152. T&J Software        <=-  (Change this to your BBS name)
  153. Tom                 <=-  (The Sysop's first name)
  154. Wildoner            <=-  (The Sysop's last name)
  155.  
  156. Example configuration file for GTUSER.BBS
  157. -----------------------------------------
  158. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  159. T&J Software        <=-  (Change this to your BBS name)
  160. Tom                 <=-  (The Sysop's first name)
  161. Wildoner            <=-  (The Sysop's last name)
  162. 1                   <=-  (COM port number - defaults to 1)
  163. 1                   <=-  (Node number - defaults to 1)
  164.  
  165.  
  166. Example Batch File
  167. ^^^^^^^^^^^^^^^^^^
  168. A sample batch file is included and is similer to the following:
  169.    ECHO OFF
  170.    CD\DOORS\CPS             <=- Switch to the door's Directory.
  171.    CPS CPS.CFG              <=- Execute the door program and pass the
  172.                                 configuration filename to the program.
  173.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  174.    BOARD                    <=- Restart BBS.
  175.  
  176.  
  177. This Door is multi-node  compatible so you may run more than 1 node from
  178. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  179. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  180. variables, (q.v.)
  181.  
  182. Normally, when running multinode, just setup different BIBLE.CFG files
  183. for each node:   CID1.CFG   CID2.CFG  etc....
  184.  
  185.  
  186. Environment Variables
  187. ^^^^^^^^^^^^^^^^^^^^^
  188. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  189. variables. Non-PCBoard systems may also use these variables by including
  190. the following in either your BBS batch or AUTOEXEC.BAT
  191.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  192.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  193. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  194. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  195. .CFG file for multi-node operation!
  196.  
  197. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  198. command line.  For example:
  199.  
  200.      CPS CPS.CFG /5
  201. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  202.      CPS CPS.CFG /%IRQ%
  203.  
  204. This tells the program to use IRQ 5 instead of the standard IRQ.
  205.  
  206.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  207.  systems. Seems Novell also uses the / character so something went screwy
  208.  somewhere. So I added the * (asterisk) which may be used instead of the /
  209.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  210.  and are interchangeable.
  211.  
  212. When specifying the location of the system file on line 1 of the doors .CFG
  213. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  214. and %wcnodeid%. Some examples:
  215.  PCBoard: 
  216.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  217.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  218.  
  219.  Wildcat!:
  220.    USERINFO.DAT in C:\WILDCAT\WCWORK\NODE1
  221.  
  222.                    C:\WILDCAT\WCWORK\NODE%wcnodeid%\USERINFO.DAT
  223.  
  224.  
  225.    DOOR.SYS in C:\WILDCAT\WCWORK\NODE1
  226.  
  227.                    C:\WILDCAT\WCWORK\NODE%wcnodeid%\DOOR.SYS
  228.  
  229. Non-PCBoard systems may use the PCB environment variables by setting them
  230. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  231.  SET PCBDRIVE=C:
  232.  SET PCBDIR=\BBSDIR
  233.  SET PCBNODE=1
  234.  
  235. Fossil Driver Support
  236. ^^^^^^^^^^^^^^^^^^^^^
  237. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  238. Fossil driver instead of the standard COM ports, just put /FD on the command
  239. line when running the door. For example:
  240.      MYDOOR MYDOOR.CFG /FD
  241. indicates that a Fossil driver is present and should be used. If no Fossil
  242. driver is detected, DoorFrame will print a message to that effect and exit
  243. the door gracefully.
  244.  
  245. Sysop Keys
  246. ^^^^^^^^^^
  247. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  248.          written to DOOR.SYS and USERS.SYS
  249. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  250.          and/or written to DOOR.SYS and USERS.SYS
  251. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  252. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  253.          and/or written to DOOR.SYS and USERS.SYS
  254. F8    -  Returns the caller involuntarily to the BBS.
  255. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  256.          and/or written to DOOR.SYS and USERS.SYS
  257. F10   -  Activates SysOp CHAT mode within the DOOR.
  258. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  259. UP    -  Give the caller extra time while in the DOOR.  
  260. DN    -  Subtract time from the caller while in the DOOR. 
  261. HOME  -  HELP key for Status Line options.
  262. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  263. ALT-X -  PCBoard will exit after current caller logs off. Value is
  264.          passed to PCBoard. Not available on non-PCBoard systems.
  265.  
  266. PROBLEMS:
  267. ^^^^^^^^^
  268. See the TJHELP.TXT file!
  269. Please feel free to contact me if you have any problems at all.
  270.  
  271. MAINTENANCE:
  272. ^^^^^^^^^^^^
  273. No nightly maintenance required.
  274.  
  275. RUNNING LOCALLY:
  276. ^^^^^^^^^^^^^^^^
  277. To run in LOCAL mode simply type CPS LOCAL
  278.  
  279. FUTURE VERSIONS:
  280. ^^^^^^^^^^^^^^^^
  281. Let me know what you would like to see added!!
  282.  
  283. VERSION HISTORY:
  284. ^^^^^^^^^^^^^^^^
  285. Version 1.00 ......... First release. 02/05/95
  286.  
  287. REGISTERING:
  288. ^^^^^^^^^^^^
  289. That's all there is to it! If you have any problems or questions
  290. please feel free to call the T&J Software BBS at (717)325-9481.
  291.  
  292. See the enclosed registration form for ordering this door and others!
  293. (REGISTER.TXT)
  294.