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