home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_GAME / PUTT161.ZIP / SYSOP.DOC < prev   
Text File  |  1994-03-07  |  16KB  |  366 lines
  1.  
  2.                           B B S   P U T T   P U T T
  3.  
  4.                              W r i t t e n    b y
  5.  
  6.                     W i l l i a m    H.    R o u n t r e e
  7.  
  8.                          I l l u s t r a t e d   b y
  9.  
  10.                                J e f   C a r d
  11.  
  12.                        C o p y r i g h t  (c)   1 9 9 3
  13.  
  14. BBS Putt Putt, (code) Copyright (c) 1993 by William H. Rountree,
  15.                (ansi) Copyright (c) 1993 by Jef Card,
  16. is being distributed as Shareware. Under this concept you may use the
  17. SHAREWARE (unregistered) version for a reasonable period of time for
  18. evaluation after which you must either register your copy or discontinue
  19. usage.
  20.                      
  21. Disclaimer:
  22.  
  23.      This program and other files associated with it are not 
  24.      guaranteed to be bug free or virus free.  We are not
  25.      responsible for any damages of any kind, including
  26.      profit loses and dta loss, that relate directly or
  27.      indirectly to these programs and files.  You may
  28.      distribute this program, as long as it is in unmodified 
  29.      for with all the files originally included.
  30.  
  31. Warranty:
  32.  
  33.     This product is provided "as is" without warranty of any kind. The entire
  34.     risk as to the results and  performance of the program is assumed by you.
  35.     Futhermore, the  author does  not warrant, guarantee, or  make any  other
  36.     representations regarding  the use of,  or the  results of the use of the
  37.     program,  and you  rely on the  program and  results  solely at  your own
  38.     risk.  The author  cannot and  will not accept  responsibility for system
  39.     damage, loss of profit, or any other special, consequential or incidental
  40.     damages  resulting  from  the  use  or  inability  to  use this  product.
  41.  
  42. Credits:
  43.  
  44.      Quick Basic (R) is a registered trade mark of Microsoft Corporation
  45.  
  46.      PCBoard (R) is a registered trade mark of Clark Development
  47.                  Corporation
  48.  
  49.      DoorFrame is copyrighted Ted Freeman 1990-3
  50.                   copyright (c) July-93 by Richard Paquette
  51.  
  52.  
  53. Overview:
  54.  
  55.           * * * * * * * This Door Requires ANSI  * * * * * * *
  56.  
  57.      BBS Putt Putt is a competitive type door game.  This door does not
  58.      contain any time limit except that of the user's existing time left
  59.      online.  This door will almost all BBS software. This door does NOT
  60.      require any daily maintance.  This door code is written using Visual
  61.      Basic 1.0 for Dos and DoorFrame 1.6 runtime library.
  62.  
  63. Configuration File:
  64.  
  65. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  66.  
  67. When using PCBOARD.SYS, DoorFrame also accesses the USERS file.
  68.  
  69. When using USERS.SYS, DoorFrame also accesses PCBOARD.SYS, PCBOARD.DAT and the 
  70. USERS file.
  71.  
  72. The DOOR.SYS used by DoorFrame is the standard 52 line GAP (tm) file.
  73.  
  74. The CALLINFO.BBS used by DoorFrame currently contains 36 lines.
  75.  
  76. If ANY Basic error is encountered, it will branch to ERR.ROUTINE and call
  77. the ERRORS subroutine. The error will be printed to the screen and written
  78. to DFRAME.ERR. Your Door will then exit back to the BBS.
  79.  
  80. Fossil Driver Support:
  81.  
  82. BBS Putt Putt supports the use of Fossil drivers.  I have recieved 1 report
  83. that it operates properly, and one that it does not process the ANSI
  84. correctly.
  85.  
  86. Environment Variables:
  87.  
  88. BBS Putt Putt supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  89. COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  90. number after the configuration filename. 
  91.     PUTT PUTT.CFG /5  or
  92.     PUTT PUTT.CFG /%IRQ%  for the environment variable.
  93. The /5 tells BBS Putt Putt to use IRQ5 rather than the standard IRQ4 that
  94. is normally used with COM1. No /x parameter is needed for the standard IRQ's.
  95.  
  96. When specifying the location of the system file on line 1 of the doors .CFG
  97. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  98. and %wcnodeid%. Some examples:
  99.  PCBoard: 
  100.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  101.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  102.  
  103.  Wildcat!:
  104.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  105.  
  106. Non-PCBoard systems may use the PCB environment variables by setting them
  107. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  108.  SET PCBDRIVE=C:
  109.  SET PCBDIR=\BBSDIR
  110.  SET PCBNODE=1
  111.  
  112.  
  113.                                 Example Batch File
  114.                                 ------------------
  115. A sample batch file is included and is similar to the following:
  116.  
  117.    ECHO OFF
  118.    CD\DOORS\PUTT           <=- Switch to the door's Directory.
  119.    PUTT PUTT.CFG           <=- Execute the door program and pass the
  120.                                 configuration filename to the program.
  121.    CD\PCB                  <=- Go back to PCB DIR when user exits door.
  122.    BOARD                   <=- Restart BBS.
  123.  
  124.  
  125.                           Configuration Files 
  126.                           -------------------
  127.  
  128. Example configuration file for PCBOARD.SYS 
  129. ------------------------------------------
  130.  
  131. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  132. Prime Base          <=-  (Change this to your BBS name)
  133. William             <=-  (The Sysop's first name)
  134. Rountree            <=-  (The Sysop's last name)
  135. 00000               <=-  (Your BBS Registration Number)
  136. William Rountree    <=-  (Person who paid to register the door)
  137. 9                   <=-  (# of holes in a round - 9 or 18)
  138.  
  139. Example configuration file for USERS.SYS 
  140. ------------------------------------------
  141.  
  142. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  143. Prime Base          <=-  (Change this to your BBS name)
  144. William             <=-  (The Sysop's first name)
  145. Rountree            <=-  (The Sysop's last name)
  146. 00000               <=-  (Your BBS Registration Number)
  147. William Rountree    <=-  (Person who paid to register the door)
  148. 9                   <=-  (# of holes in a round - 9 or 18)
  149.  
  150. Example configuration file for DOOR.SYS 
  151. ---------------------------------------
  152.  
  153. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  154. Prime Base          <=-  (Change this to your BBS name)
  155. William             <=-  (The Sysop's first name)
  156. Rountree            <=-  (The Sysop's last name)
  157. 00000               <=-  (Your BBS Registration Number)
  158. William Rountree    <=-  (Person who paid to register the door)
  159. 9                   <=-  (# of holes in a round - 9 or 18)
  160.  
  161. Example configuration file for USERINFO.DAT 
  162. -------------------------------------------
  163.  
  164. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  165. Prime Base          <=-  (Change this to your BBS name)
  166. William             <=-  (The Sysop's first name)
  167. Rountree            <=-  (The Sysop's last name)
  168. 00000               <=-  (Your BBS Registration Number)
  169. William Rountree    <=-  (Person who paid to register the door)
  170. 9                   <=-  (# of holes in a round - 9 or 18)
  171.  
  172. Example configuration file for CALLINFO.BBS 
  173. -------------------------------------------
  174.  
  175. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  176. Prime Base          <=-  (Change this to your BBS name)
  177. William             <=-  (The Sysop's first name)
  178. Rountree            <=-  (The Sysop's last name)
  179. 00000               <=-  (Your BBS Registration Number)
  180. William Rountree    <=-  (Person who paid to register the door)
  181. 9                   <=-  (# of holes in a round - 9 or 18)
  182.  
  183. Example configuration file for DORINFOx.DEF 
  184. -------------------------------------------
  185.  
  186. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  187.                           where 'x' is the BBS Node number.
  188. Prime Base          <=-  (Change this to your BBS name)
  189. William             <=-  (The Sysop's first name)
  190. Rountree            <=-  (The Sysop's last name)
  191. 00000               <=-  (Your BBS Registration Number)
  192. William Rountree    <=-  (Person who paid to register the door)
  193. 9                   <=-  (# of holes in a round - 9 or 18)
  194.  
  195. Example configuration file for SFDOORS.DAT 
  196. ------------------------------------------
  197.  
  198. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  199. Prime Base          <=-  (Change this to your BBS name)
  200. William             <=-  (The Sysop's first name)
  201. Rountree            <=-  (The Sysop's last name)
  202. 00000               <=-  (Your BBS Registration Number)
  203. William Rountree    <=-  (Person who paid to register the door)
  204. 9                   <=-  (# of holes in a round - 9 or 18)
  205.  
  206. Example configuration file for GTUSER.BBS 
  207. ----------------------------------------
  208.  
  209. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  210. Prime Base          <=-  (Change this to your BBS name)
  211. William             <=-  (The Sysop's first name)
  212. Rountree            <=-  (The Sysop's last name)
  213. 1                   <=-  (COM port number - defaults to 1)
  214. 1                   <=-  (Node number - defaults to 1)
  215. 00000               <=-  (Your BBS Registration Number)
  216. William Rountree    <=-  (Person who paid to register the door)
  217. 9                   <=-  (# of holes in a round - 9 or 18)
  218.  
  219. Example configuration file for TRIBBS.SYS 
  220. ----------------------------------------
  221.  
  222. C:\BBS\TRIBBS.BBS   <=-  (Full pathname of your TRIBBS.SYS file)
  223. Prime Base          <=-  (Change this to your BBS name)
  224. William             <=-  (The Sysop's first name)
  225. Rountree            <=-  (The Sysop's last name)
  226. 00000               <=-  (Your BBS Registration Number)
  227. William Rountree    <=-  (Person who paid to register the door)
  228. 9                   <=-  (# of holes in a round - 9 or 18)
  229.  
  230. NOTE: At present it is unclear which BBS systems read their BBS drop files
  231.       back in and make updates to the system files upon termination of a door.
  232.       If your BBS performs this function then your files will be updated, 
  233.       otherwise nothing will change and the updates will have to be performed
  234.       manually. It is left to the individual Sysop to know if his BBS
  235.       software does indeed perform the updates or not.
  236.  
  237.                          Example: Putt Putt.cfg /FD
  238.  
  239.                             Environment Variables
  240.                             ---------------------
  241.  
  242. PCBoard automatically creates the %PCBDRIVE%, %PCBDIR%, and %PCBNODE% 
  243. environment variables.
  244.  
  245. Wildcat boards use the %WCNODEID% environment variable.
  246.  
  247. Non-PCBoard or Wildcat systems may also use these variables by including
  248. the following in either your BBS batch or AUTOEXEC.BAT
  249.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  250.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  251.   SET PCBNODE=1                 <- Node Directory of your BBS (PCBOARD)
  252.   SET WCNODEID=1                <- Node Directory of your BBS (WILDCAT)
  253.  
  254. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  255. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. Or for Wildcat Board you could
  256. use C:\WC\WCWORK\NODE%WCNODEID%\ This allows you to use just one
  257. .CFG file for multi-node operation!
  258.  
  259.  
  260. Daily Maintance:
  261.  
  262.      No modification of your daily maintance is required since BBS Putt
  263.      Putt performs it's Daily Maintance on the first caller that day.
  264.      This maintance is very short and should not delay the play by that
  265.      call very much.
  266.  
  267. Limitations:
  268.  
  269.      This door will continue to operate in it's original condition until
  270.      it is registered.  A 5 second delay and message will be displayed upon
  271.      it start.  Rounds are limited to 9 holes.  Sysop has the option of
  272.      either 9 or 18 in the registered version.  After a player has completed
  273.      10 rounds of 9 holes in one month, the user will not be able to play
  274.      again until the next month.  All of these limitations will be removed
  275.      upon it's registration.
  276.  
  277. Sysop Keys
  278. ==========
  279.  
  280. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  281.          written to DOOR.SYS and USERS.SYS
  282. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  283.          and/or written to DOOR.SYS and USERS.SYS
  284. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  285. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  286.          and/or written to DOOR.SYS and USERS.SYS
  287. F8    -  Returns the caller involuntarily to the BBS.
  288. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  289.          and/or written to DOOR.SYS and USERS.SYS
  290. F10   -  Activates SysOp CHAT mode within the DOOR.
  291. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  292. UP    -  Give the caller extra time while in the DOOR.
  293. DN    -  Subtract time from the caller while in the DOOR.
  294. HOME  -  HELP key for Status Line options.
  295. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  296. ALT-X -  PCBoard will exit after current caller logs off. Value is
  297.          passed to PCBoard. Not available on non-PCBoard systems.
  298.  
  299.  
  300. Beta Testing:
  301.  
  302.      This door was extensively tested on these BBS's, including my own.
  303.  
  304.      Connect One BBS, Elko Nv. (702) 753-7574 AT&T Dataport 14.4k modem
  305.      50,000 files online plus (over 5 geg), 40 plus registered doors,
  306.      Mail Hub for the following nets: Wildnet, Rushnet, S&Snet, PEnet.
  307.      SYSOP: William Graham, Beta Testers: John Riddle
  308.  
  309.      The Island Exchange - Free Access - 2 Nodes, both operating at
  310.      300 through 14.400 baud - (616)428-5014 & (616)428-2081.
  311.      Running many registered door games - Files & Teleconferencing.
  312.      Sysop: Nola Savickas Beta Testers: Ryan Witt, Millie Rogers,
  313.      and Gib Salisbury.
  314.  
  315. Registration:
  316.  
  317.      BBS Putt Putt costs $15.00 US currency to register.  I will post a
  318.      message on Prime Base in the Door Support Conference with your
  319.      individual registration number.  If you have any problems or questions,
  320.      please leave all messages in this area for:
  321.  
  322.           William Rountree or Sysop at:
  323.  
  324.           Prime Base Node #1: (804) 587-4289   14,400 V32Bis, V42Bis
  325.                           #2: (804) 587-4382   16,800 USR Dual Standard
  326.           Voice:              (804) 587-3082
  327.           FidoNet: 1:275/58
  328.  
  329.      Bill McPhail is also an authorized distribution and registration site.
  330.      Please, if you use this site, make your check or money order out to Bill
  331.      McPhail instead of myself.
  332.  
  333.           Bill McPhail at:
  334.  
  335.           The BoardRoom BBS #1: (206) 837-1763   14,400 V32Bis, V42Bis
  336.                             #2: (206) 846-0755   14,400 V32Bis, V42Bis
  337.           FidoNet: 1:138/138
  338.                    1:138/237
  339.  
  340.     Elizabeth Bachman is also the authorized East Coast distribution site.
  341.  
  342.           Elizabeth Bachman at:
  343.   
  344.           The Midnight Special BBS #1: (207) 439-7919 14,400 V32Bis, V42Bis
  345.                               #2: (207) 439-9318 2400
  346.           FidoNet: 1:326/105
  347.  
  348.     Rick Barrowclough is also an authorized CANADIAN distribution site.
  349.  
  350.           Rick Barrowclough at:
  351.  
  352.           The WYRM'S LAIR #1: (604) 542-5641    14,400 V32Bis, V42Bis
  353.                           #2: (604) 558-1979     2,400 (Soon Terbo)
  354.           FidoNet: 1:353/320
  355.  
  356.  
  357.    Werner Sepultur is also an authorized EUROPEAN distribution site.
  358.  
  359.           Werner Sepultur at:
  360.  
  361.           Sepultura-BBS Verden #1: +49 (0)4231-68618   14,400 USR Dual
  362.                                #2: +49 (0)4231-68619   19,200 ZyXel
  363.                                #3: +49 (0)4231-68951   16,800 ZyXel
  364.                                #4: +49 (0)4231-962040  64,000 ISDN
  365.           FidoNet:
  366.