home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / AGECHK11.ZIP / AGECHK.DOC < prev    next >
Text File  |  1993-12-29  |  9KB  |  222 lines
  1.  
  2.  
  3.                                 AgeCheck!
  4.                                 ~~~~~~~~~
  5.                        COPYRIGHT 1993 T&J Software
  6.  
  7.              For BBS's supporting the DOOR.SYS file format
  8.                       and using callers BIRTHDATES!
  9.  
  10.  
  11.  
  12.                        VERSION 1.10     01/01/94
  13.  
  14.                                    By
  15.  
  16.                             Tom & Jane Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30. LATEST VERSION:
  31. ~~~~~~~~~~~~~~~
  32. Please call the T&J BBS for the latest version of this program.
  33.  
  34. LEGALITIES:
  35. ~~~~~~~~~~~
  36. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  37. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  38. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  39. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  40. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  41. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  42.  
  43. DISTRIBUTION:
  44. ~~~~~~~~~~~~~
  45. You may make this file available for downloading from your BBS or you may
  46. upload it to any BBS of your choice, provided that you do not make any
  47. changes to the contents of the archive (ZIP file). The archive and its
  48. individual contents may not be used by any service that charges any money
  49. whatsoever, without the written permission of the author.
  50.  
  51. PROGRAM DESCRIPTION:
  52. ~~~~~~~~~~~~~~~~~~~~
  53. AgeCheck is a simple door which checks the users age vs. your age
  54. limitation for the door in question. It will only run on BBS's that
  55. support the DOOR.SYS file format and also contains the users date of
  56. birth (such as Wildcat! BBS's).
  57.  
  58. Modify the AGECHK.CFG for your system, put you age constraint in the
  59. AGE.DAT file and then modify your batch file. You are then ready to
  60. run the program.
  61.  
  62. You may also create an ANSI and ASCII display file of your choosing
  63. called AGECHK.ANS and AGECHK.ASC. If the user doesn't meet your age
  64. requirements and these files are found in the AgeCheck directory, they
  65. will be sent instead of the internal display message.
  66.  
  67. You may now bypass the age checking by security levels by adding the
  68. security levels to the SECURE.DAT file. Enter the security levels like
  69. this:
  70.  
  71. 100
  72. 120
  73.  
  74. Example configuration file for DOOR.SYS
  75. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  76. Edit the AGECHK.CFG file to hold the proper information!
  77.  
  78. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  79. T&J Software        <=-  (Change this to your BBS name)
  80. Tom                 <=-  (The Sysop's first name)
  81. Wildoner            <=-  (The Sysop's last name)
  82.  
  83. Next, put your age limitation in the file called AGE.DAT. Just use
  84. your favorite text editor for this! The example AGE.DAT has the age of
  85. 21 inside. The user must be at least 21 to gain access to the door.
  86.  
  87. Example Batch File
  88. ~~~~~~~~~~~~~~~~~~
  89. A sample batch file is included and is similer to the following:
  90.  
  91. LINE 1-   ECHO OFF
  92. LINE 2-   CD\DOORS\AGECHK
  93. LINE 3-   IF EXIST BAD.BAD DEL BAD.BAD
  94. LINE 4-   AGECHK AGECHK.CFG
  95. LINE 5-   IF EXIST BAD.BAD GOTO BAD
  96. LINE 6-   CD\DOORS\LEMON
  97. LINE 7-   LEMON LEMON.CFG
  98. LINE 8-   GOTO QUIT
  99. LINE 9-   :QUIT
  100. LINE 10-  CD\PCB
  101. LINE 11-  BOARD
  102. LINE 12-  :BAD
  103. LINE 13-  IF EXIST BAD.BAD DEL BAD.BAD
  104. LINE 14-  GOTO QUIT
  105.  
  106. Line 2, switch to the door directory and run AgeCheck! If the person
  107. doesn't meet your age limits a file called BAD.BAD will be created.
  108. You then check for this files existence (Line 5) and if it exists,
  109. branch to the :BAD portion of the batch file (Line 12) where it
  110. deletes BAD.BAD and heads back to the BBS. If BAD.BAD is not found, it
  111. continues to the normal door.
  112.  
  113. Batch files will vary from BBS to BBS, please check your BBS doc's
  114. for proper batch file setup!
  115.  
  116. This Door is multi-node  compatible so you may run more than 1 node from
  117. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  118. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  119. variables, (q.v.)
  120.  
  121. Environment Variables
  122. ~~~~~~~~~~~~~~~~~~~~~
  123. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  124. variables. Non-PCBoard systems may also use these variables by including
  125. the following in either your BBS batch or AUTOEXEC.BAT
  126.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  127.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  128. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  129. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  130. .CFG file for multi-node operation!
  131.  
  132. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  133. command line.  For example:
  134.  
  135.      AGECHK AGECHK.CFG /5
  136. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  137.      AGECHK AGECHK.CFG /%IRQ%
  138.  
  139. This tells the program to use IRQ 5 instead of the standard IRQ.
  140.  
  141.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  142.  systems. Seems Novell also uses the / character so something went screwy
  143.  somewhere. So I added the * (asterisk) which may be used instead of the /
  144.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  145.  and are interchangeable.
  146.  
  147. When specifying the location of the system file on line 1 of the doors .CFG
  148. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  149. and %wcnodeid%. Some examples:
  150.  PCBoard: 
  151.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  152.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  153.  
  154.  Wildcat!:
  155.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  156.  
  157. Non-PCBoard systems may use the PCB environment variables by setting them
  158. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  159.  SET PCBDRIVE=C:
  160.  SET PCBDIR=\BBSDIR
  161.  SET PCBNODE=1
  162.  
  163. Fossil Driver Support
  164. ~~~~~~~~~~~~~~~~~~~~~
  165. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  166. Fossil driver instead of the standard COM ports, just put /FD on the command
  167. line when running the door. For example:
  168.      MYDOOR MYDOOR.CFG /FD
  169. indicates that a Fossil driver is present and should be used. If no Fossil
  170. driver is detected, DoorFrame will print a message to that effect and exit
  171. the door gracefully.
  172.  
  173. Sysop Keys
  174. ~~~~~~~~~~
  175. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  176.          written to DOOR.SYS and USERS.SYS
  177. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  178.          and/or written to DOOR.SYS and USERS.SYS
  179. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  180. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  181.          and/or written to DOOR.SYS and USERS.SYS
  182. F8    -  Returns the caller involuntarily to the BBS.
  183. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  184.          and/or written to DOOR.SYS and USERS.SYS
  185. F10   -  Activates SysOp CHAT mode within the DOOR.
  186. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  187. UP    -  Give the caller extra time while in the DOOR.  
  188. DN    -  Subtract time from the caller while in the DOOR. 
  189. HOME  -  HELP key for Status Line options.
  190. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  191. ALT-X -  PCBoard will exit after current caller logs off. Value is
  192.          passed to PCBoard. Not available on non-PCBoard systems.
  193.  
  194. MAINTENANCE!:
  195. ~~~~~~~~~~~~~
  196. None required.
  197.  
  198. FUTURE VERSIONS:
  199. ~~~~~~~~~~~~~~~~
  200. Let me know what you would like to see!
  201.  
  202. VERSION HISTORY:
  203. ~~~~~~~~~~~~~~~~
  204. Version 1.00 ......... First release. 10/21/93
  205. Version 1.10 ......... Updated routines to use DoorFrameX v3.1, you
  206.                        may now use your own display files (AGECHK.ANS
  207.                        and AGECHK.ASC) instead of the internal
  208.                        display, and you may now set security levels to
  209.                        bypass the age checking door by adding the
  210.                        security levels to the SECURE.DAT file.
  211.                        01/01/94
  212.  
  213. REGISTERING:
  214. ~~~~~~~~~~~~
  215. None required.
  216.  
  217. That's all there is to it! If you have any problems or questions
  218. please feel free to call the T&J BBS at (717)325-9481 and join the
  219. T&J Software Conference.
  220.  
  221. See the enclosed registration form for ordering!  (REGISTER.TXT)
  222.