home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / 4SQ23.ZIP / 4SQUARE.DOC < prev    next >
Text File  |  1993-12-11  |  12KB  |  233 lines
  1.  
  2.         One of the Livewire Collection of multi-BBS Doorware programs.
  3.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  4.           UltraBBS, Telegard, TriTel, TriBBS, Remote Access, and WWIV
  5.  
  6.                                 Richard Paquette
  7.                                    PO Box 416
  8.                               Mt. Laurel, NJ 08054
  9.  
  10.                            (c) Copyright 1989 - 1993
  11.                               All Rights Reserved
  12.  
  13.                       Additional Line(s) to the CFG file
  14.                       ----------------------------------
  15.                        
  16.                         Line 5 <=- Registration number
  17.  
  18.                   Example configuration file for PCBOARD.SYS
  19.                   ------------------------------------------
  20.                                                                              
  21. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  22. The Livewire BBS    <=-  (Change this to your BBS name)
  23. Richard             <=-  (The Sysop's first name)
  24. Paquette            <=-  (The Sysop's last name)
  25.  
  26. Example configuration file for USERS.SYS
  27. ------------------------------------------
  28.                                                                              
  29. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  30. The Livewire BBS    <=-  (Change this to your BBS name)
  31. Richard             <=-  (The Sysop's first name)
  32. Paquette            <=-  (The Sysop's last name)
  33.  
  34. Example configuration file for DOOR.SYS
  35. ---------------------------------------
  36.                                                                              
  37. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  38. The Livewire BBS    <=-  (Change this to your BBS name)
  39. Richard             <=-  (The Sysop's first name)
  40. Paquette            <=-  (The Sysop's last name)
  41.  
  42. Example configuration file for USERINFO.DAT
  43. -------------------------------------------
  44.                                                                              
  45. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  46. The Livewire BBS    <=-  (Change this to your BBS name)
  47. Richard             <=-  (The Sysop's first name)
  48. Paquette            <=-  (The Sysop's last name)
  49. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  50.  
  51. Example configuration file for CALLINFO.BBS
  52. -------------------------------------------
  53.                                                                              
  54. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  55. The Livewire BBS    <=-  (Change this to your BBS name)
  56. Richard             <=-  (The Sysop's first name)
  57. Paquette            <=-  (The Sysop's last name)
  58.  
  59. Example configuration file for DORINFOx.DEF
  60. -------------------------------------------
  61.                                                                              
  62. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  63.                           where 'x' is the BBS Node number.
  64. The Livewire BBS    <=-  (Change this to your BBS name)
  65. Richard             <=-  (The Sysop's first name)
  66. Paquette            <=-  (The Sysop's last name)
  67.  
  68. Example configuration file for SFDOORS.DAT
  69. ------------------------------------------
  70.                                                                              
  71. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  72. The Livewire BBS    <=-  (Change this to your BBS name)
  73. Richard             <=-  (The Sysop's first name)
  74. Paquette            <=-  (The Sysop's last name)
  75.  
  76. Example configuration file for GTUSER.BBS
  77. ----------------------------------------
  78.                                                                              
  79. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  80. The Livewire BBS    <=-  (Change this to your BBS name)
  81. Richard             <=-  (The Sysop's first name)
  82. Paquette            <=-  (The Sysop's last name)
  83. 1                   <=-  (COM port number - defaults to 1)
  84. 1                   <=-  (Node number - defaults to 1)
  85. 123123              <=-  (Registration Number)
  86.  
  87. Example configuration file for TRIBBS.SYS
  88. ----------------------------------------
  89.                                                                              
  90. C:\BBS\TRIBBS.SYS   <=-  (Full pathname of your TRIBBS.SYS file)
  91. The Livewire BBS    <=-  (Change this to your BBS name)
  92. Richard             <=-  (The Sysop's first name)
  93. Paquette            <=-  (The Sysop's last name)
  94.  
  95. Example Batch File 
  96. -------------------
  97. A sample batch file is included and is similar to the following:
  98.    ECHO OFF
  99.    CD\DOORS                <=- Switch to the door's Directory.
  100.    DOOR DOOR.CNF           <=- Execute the door program and pass the
  101.                                 configuration filename to the program.
  102.    CD\PCB                  <=- Go back to PCB DIR when user exits door.
  103.    BOARD                   <=- Restart BBS.
  104.                                                                              
  105. This Door is multi-node  compatible so you may run more than 1 node from
  106. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  107. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  108. variables, (q.v.)
  109.  
  110.                          Environment Variables
  111.  
  112. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  113. variables. Non-PCBoard systems may also use these variables by including
  114. the following in either your BBS batch or AUTOEXEC.BAT
  115.  
  116.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  117.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  118.  
  119. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  120. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  121. .CNF file for multi-node operation!
  122.                                                                              
  123. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  124. command line.  For example:
  125.                                                                              
  126.      DOOR DOOR.CNF /5
  127.      or using the PCBDRIVE procedure: SET IRQ=5 and use
  128.      DOOR DOOR.CNF /%IRQ%  
  129.                                                                              
  130. This tells the program to use IRQ 5 instead of the standard IRQ.
  131.  
  132.                            Top Ten Bulletin
  133.                            ----------------
  134.                                                                              
  135. The first time you run this door online it will create 3 files called
  136. ****.BUL, ****.BLT and ****.BLT. If you  wish to change the path
  137. or filename of the  Bulletin,  you must edit  ****.BUL and  change the
  138. first line to whatever path/filename you desire, assuming that this door
  139. requires or has a bulletin to display.. these docs are generic for all
  140. The Livewire Doors and some of them DO NOT create a bulletin.
  141.  
  142.                               Sysop Keys
  143.                               ----------
  144.  
  145. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  146.          written to DOOR.SYS and USERS.SYS
  147. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  148.          and/or written to DOOR.SYS and USERS.SYS
  149. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  150. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  151.          and/or written to DOOR.SYS and USERS.SYS
  152. F8    -  Returns the caller involuntarily to the BBS.
  153. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  154.          and/or written to DOOR.SYS and USERS.SYS
  155. F10   -  Activates SysOp CHAT mode within the DOOR.
  156. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  157. UP    -  Give the caller extra time while in the DOOR.  
  158. DN    -  Subtract time from the caller while in the DOOR. 
  159. HOME  -  HELP key for Status Line options.
  160. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  161. ALT-X -  PCBoard will exit after current caller logs off. Value is
  162.          passed to PCBoard. Not available on non-PCBoard systems.
  163.  
  164.                              Distribution
  165.                              ------------
  166.                                                                              
  167. This program is being distributed via the SHAREWARE concept and as such,
  168. may be copied freely with the following restrictions:
  169.                                                                              
  170.         * The program must be supplied in it's original unmodified
  171.           form, including documentation.
  172.                                                                              
  173.         * This program may not be distributed as part of any commercial
  174.           application or service without the express, written consent
  175.           of the author.
  176.                                                                              
  177.         * Vendors of Shareware/Public Domain software may not
  178.           distribute this program without the express, written
  179.           consent of the author even if Vendor has been approved
  180.           by the Association of Shareware Professionals (ASP).
  181.  
  182.                              Registration
  183.                              ------------
  184.                                                                              
  185. This door represents  many hours of  programming and the author deserves
  186. just compensation for his time, efforts and expertise.  If you find this
  187. program to be of some  value and you  continue to use it on your system,
  188. you must return the order form provided along with the registration fee.
  189. Registration  entitles you to  free upgrades via  modem from  The Livewire
  190. BBS Support Conference.  Payments should be  made in the  form of a check or
  191. money order. Foreign orders must be in U.S. funds drawn on a U.S. bank.
  192.  
  193. Online registration with Visa or Mastercard is available via our Credit
  194. Card Door at the following system:
  195.                                                                              
  196.                   The Livewire BBS: (609) 235-5297 HST
  197.                                                                              
  198. NOTE: If you register by mail,  your registration number will be posted
  199.       in a private message on The Livewire BBS. 
  200.  
  201.                                Copyright
  202.                                ---------
  203.                                                                              
  204. This door is Copyrighted(c) 1989-93 by Richard Paquette, and is distributed
  205. as Shareware. Under this concept you may use the SHAREWARE (unregistered)
  206. version for a  reasonable period of  time for evaluation  after which you
  207. must either register your copy or discontinue  usage.
  208.  
  209.                                Warranty
  210.                                --------
  211.                                                                              
  212. This product is provided as is without warranty of any kind.  The entire
  213. risk as to the results and performance of the program is assumed by you.
  214. Futhermore, the  author does not warrant, guarantee, or  make any  other
  215. representations regarding the use of,  or the  results of the use of the
  216. program,  and you rely on the  program and  results  solely at  your own
  217. risk.  The author  cannot and will not accept  responsibility for system
  218. damage, loss of profit or any other special, consequential or incidental 
  219. damages  resulting  from  the use of or inability to  use this  product.
  220.  
  221.                                Com-Ports
  222.                                ---------
  223.  
  224.                    DoorFrame now supports COM 0 thru 15.
  225.  
  226.                              Fossil Drivers
  227.                              --------------
  228.                                                                              
  229. This door may be used with Fossil drivers such as X00 & BNU.  This makes
  230. it compatible  with most  multi-port  boards.  To use the Fossil  driver
  231. instead of the standard COM ports, include  /FD on the command line when
  232. running the door. For example: DOOR DOOR.CNF /FD
  233.