home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / GOODU16.ZIP / GOODUSER.DOC < prev    next >
Text File  |  1993-12-30  |  11KB  |  276 lines
  1.  
  2.                        ============================
  3.                                  GoodUser!
  4.                        ============================
  5.  
  6.         One of the T&J Software Collection of multi-BBS door programs.
  7.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  8.                UltraBBS, Telegard, TriBBS, and Remote Access.
  9.  
  10.  
  11.                      COPYRIGHT 1992,94 T&J Software
  12.  
  13.                        VERSION 1.6      01/01/94
  14.  
  15.                                     By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.  
  23.                                    From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                                  2 NODES
  28.                         1200/2400/9600/19200/38400
  29.                                24 Hours/Day
  30.  
  31.  
  32. LATEST VERSION:
  33. ===============
  34. Please call the T&J BBS for the latest version of this program.
  35.  
  36. DISTRIBUTION:
  37. =============
  38. You may make this file available for downloading from your BBS or you may
  39. upload it to any BBS of your choice, provided that you do not make any
  40. changes to the contents of the archive (ZIP file). The archive and its
  41. individual contents may not be used by any service that charges any money
  42. whatsoever, without the written permission of the author.
  43.  
  44. LEGALITIES:
  45. ===========
  46.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  47.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  48.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  49.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  50.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  51.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  52.       OR BREACH OF ANY WARRANTY.
  53.  
  54. PROGRAM DESCRIPTION:
  55. ====================
  56. Special thanks to Robert Cole from Mustang Software for this idea!
  57.  
  58. This door works exactly opposite of BadUser (by T&J Software). By
  59. editing the GOODUSER.LST file you can allow only your good users to
  60. enter door games. Great for a tournament play between a select group
  61. of users on your board.
  62.  
  63. If a "Good User" is found, he is told that his access has been granted
  64. to the selected door. If a person is not listed in the GOODUSER.LST
  65. file, he is told that he does not have access to the door.
  66.  
  67.  
  68. CONFIGURATION:
  69. =============
  70.  
  71. Example configuration file for PCBOARD.SYS
  72. ------------------------------------------
  73.  
  74. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  75. T&J Software        <=-  (Change this to your BBS name)
  76. Tom                 <=-  (The Sysop's first name)
  77. Wildoner            <=-  (The Sysop's last name)
  78.  
  79. Example configuration file for USERS.SYS
  80. ----------------------------------------
  81.  
  82. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  83. T&J Software        <=-  (Change this to your BBS name)
  84. Tom                 <=-  (The Sysop's first name)
  85. Wildoner            <=-  (The Sysop's last name)
  86.  
  87. Example configuration file for DOOR.SYS
  88. ---------------------------------------
  89.  
  90. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  91. T&J Software        <=-  (Change this to your BBS name)
  92. Tom                 <=-  (The Sysop's first name)
  93. Wildoner            <=-  (The Sysop's last name)
  94.  
  95. Example configuration file for USERINFO.DAT
  96. -------------------------------------------
  97.  
  98. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  99. T&J Software        <=-  (Change this to your BBS name)
  100. Tom                 <=-  (The Sysop's first name)
  101. Wildoner            <=-  (The Sysop's last name)
  102. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  103.  
  104. Example configuration file for CALLINFO.BBS
  105. -------------------------------------------
  106.  
  107. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS 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 DORINFOx.DEF
  113. -------------------------------------------
  114.  
  115. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  116.                           where 'x' is the BBS Node number.
  117. T&J Software        <=-  (Change this to your BBS name)
  118. Tom                 <=-  (The Sysop's first name)
  119. Wildoner            <=-  (The Sysop's last name)
  120.  
  121. Example configuration file for SFDOORS.DAT
  122. ------------------------------------------
  123.  
  124. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  125. T&J Software        <=-  (Change this to your BBS name)
  126. Tom                 <=-  (The Sysop's first name)
  127. Wildoner            <=-  (The Sysop's last name)
  128.  
  129. Example configuration file for GTUSER.BBS
  130. -----------------------------------------
  131.  
  132. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  133. T&J Software        <=-  (Change this to your BBS name)
  134. Tom                 <=-  (The Sysop's first name)
  135. Wildoner            <=-  (The Sysop's last name)
  136. 1                   <=-  (COM port number - defaults to 1)
  137. 1                   <=-  (Node number - defaults to 1)
  138.  
  139. This Door is multi-node  compatible so you may run more than 1 node from
  140. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  141. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  142. variables, (q.v.)
  143.  
  144. Environment Variables
  145. =====================
  146.  
  147. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  148. variables. Non-PCBoard systems may also use these variables by including
  149. the following in either your BBS batch or AUTOEXEC.BAT
  150.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  151.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  152. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  153. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  154. .CFG file for multi-node operation!
  155.  
  156. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  157. command line.  For example:
  158.  
  159.      LEMON30 LEMON.CFG /5
  160. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  161.      LEMON30 LEMON.CFG /%IRQ%
  162.  
  163. This tells the program to use IRQ 5 instead of the standard IRQ.
  164.  
  165.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  166.  systems. Seems Novell also uses the / character so something went screwy
  167.  somewhere. So I added the * (asterisk) which may be used instead of the /
  168.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  169.  and are interchangeable.
  170.  
  171. When specifying the location of the system file on line 1 of the doors .CFG
  172. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  173. and %wcnodeid%. Some examples:
  174.  PCBoard: 
  175.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  176.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  177.  
  178.  Wildcat!:
  179.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  180.  
  181. Non-PCBoard systems may use the PCB environment variables by setting them
  182. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  183.  SET PCBDRIVE=C:
  184.  SET PCBDIR=\BBSDIR
  185.  SET PCBNODE=1
  186.  
  187. Fossil Driver Support
  188. ---------------------
  189. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  190. Fossil driver instead of the standard COM ports, just put /FD on the command
  191. line when running the door. For example:
  192.      MYDOOR MYDOOR.CFG /FD
  193. indicates that a Fossil driver is present and should be used. If no Fossil
  194. driver is detected, DoorFrame will print a message to that effect and exit
  195. the door gracefully.
  196.  
  197. Sysop Keys
  198. ==========
  199.  
  200. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  201.          written to DOOR.SYS and USERS.SYS
  202. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  203.          and/or written to DOOR.SYS and USERS.SYS
  204. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  205. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  206.          and/or written to DOOR.SYS and USERS.SYS
  207. F8    -  Returns the caller involuntarily to the BBS.
  208. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  209.          and/or written to DOOR.SYS and USERS.SYS
  210. F10   -  Activates SysOp CHAT mode within the DOOR.
  211. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  212. UP    -  Give the caller extra time while in the DOOR.  
  213. DN    -  Subtract time from the caller while in the DOOR. 
  214. HOME  -  HELP key for Status Line options.
  215. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  216. ALT-X -  PCBoard will exit after current caller logs off. Value is
  217.          passed to PCBoard. Not available on non-PCBoard systems.
  218.  
  219. SAMPLE DOOR BATCH FILE:
  220. ======================
  221.  
  222. ECHO OFF
  223. CD\WC30\DOOR\LEMON
  224. GOODUSER GOODUSER.CFG
  225. IF EXIST BAD.BAD GOTO QUIT
  226. LEMON LEMON.CFG
  227. :QUIT
  228. IF EXIST BAD.BAD DEL BAD.BAD
  229.  
  230. 1: Turn ECHO OFF -- not needed
  231. 2: Change to your door directory.
  232. 3: Run GoodUser -- if an unlisted user is found the program will create a
  233.    small file called BAD.BAD.
  234. 4: Checks to see if BAD.BAD was created -- if it was it will skip to
  235.    QUIT and bypass the real door. If the BAD.BAD file is not found
  236.    your real door will operate as normal.
  237. 5: Your actual door program (however many lines it takes).
  238. 6: Batch file branch if an unlisted user was found.
  239. 7: Delete the BAD.BAD file if it is there.
  240.  
  241. To run in LOCAL mode simply enter: GOODUSER LOCAL
  242.  
  243. EDITING THE GOODUSER.LST FILE:
  244. =============================
  245. Simply add one name per line. This is your list of users who have access
  246. to the door.
  247.  
  248. FUTURE VERSIONS:
  249. ================
  250. --->> Let me know what you would like to see!
  251.  
  252. VERSION HISTORY:
  253. ================
  254. Version 1.00 ......... First release. 03/14/92
  255. Version 1.10 ......... Updated routines. 05-17-1992
  256. Version 1.20 ......... Updated routines. 10-12-1992
  257. Version 1.30 ......... Updated routines. 11-27-1992
  258. Version 1.40 ......... Added support for COM 1-15. 06-05-1993
  259. Version 1.50 ......... Added better support for Wildcat IM and
  260.                        PCBoard/M versions, dropped support for
  261.                        CHAIN.TXT, and added better internal error
  262.                        checking routines. 08-11-93
  263. Version 1.60 ......... Updated to DoorFrameX v3.1 routines. 01-01-94
  264.  
  265. REGISTERING:
  266. ============
  267. None required. If you would like to send me a program you have written,
  268. that would be payment enough.
  269.  
  270.  
  271. That's all there is to it! If you have any problems or questions
  272. please feel free to call the T&J BBS at (717)325-9481 and join the
  273. T&J Software Conference.
  274.  
  275. See the registration form for other products from T&J Software.
  276.