home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / bbsutils / damv100.arj / DAM.DOC < prev    next >
Text File  |  1993-07-03  |  10KB  |  209 lines
  1.  
  2.                            Door Access Manager
  3.                                   by 
  4.                               Steve Miller
  5.  
  6.                      Copyright (c) 1993, SDM Software
  7.                       All Right Reserved, World Wide
  8.  
  9.  
  10. ------------------------------------------------------------------------------
  11.  
  12.                              ----------------------
  13.                              DISCLAIMER OF WARRANTY
  14.                              ----------------------
  15.  
  16.      THIS SOFTWARE PROGRAM AND DOCUMENTATION ("DAM") IS BEING OFFERED
  17.      FOR EVALUATION PURPOSES "AS IS" AND WITHOUT WARRANTIES AS TO
  18.      PERFORMANCE OR MERCHANT-ABILITY. BY USING DAM, YOU ARE EXPRESSLY
  19.      RELEASING STEVE MILLER FROM ANY LIABILITY RESULTING FROM THE USE OF
  20.      THIS SOFTWARE AND DOCUMENTATION. THE USER MUST ASSUME THE ENTIRE RISK
  21.      OF USING DAM. BECAUSE OF THE DIVERSITY OF CONDITIONS, HARDWARE AND 
  22.      OPERATING ENVIRONMENTS UNDER WHICH DAM MAY BE USED, NO WARRANTY OF 
  23.      FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS ADVISED 
  24.      TO TEST AND SUPERVISE DAM THOROUGHLY BEFORE RELYING ON IT.
  25.  
  26. ------------------------------------------------------------------------------
  27.  
  28.                                LICENSE AGREEMENT
  29.  
  30.      1)DAM is being distributed as Shareware.  This program is not
  31.        free. You are granted a limited license to evaluate DAM for a
  32.        period not to exceed 30 days.  After 30 days, you must either pay
  33.        for and register your copy of DAM, or immediately discontinue
  34.        its use and remove it from your computer.
  35.  
  36.      2)You may keep as many backup copies of DAM as you wish, but you
  37.        may not run DAM simultaneously on more than one computer.
  38.        Additionally, you are granted the right to share DAM with
  39.        others, as long as you distribute the DAM archive exactly as
  40.        you received it, with all associated files included.  
  41.  
  42.      3)Under no circumstances may you charge a fee or receive any other
  43.        form of consideration for distributing the DAM files without
  44.        express written consent from the copyright holder.
  45.  
  46. ------------------------------------------------------------------------------
  47.  
  48.       Now that the legal stuff is out of the way. What can DAM do for  
  49. you? DAM was born out of neccessity. I needed a program that would only
  50. let certain users into a door at certian times. I could not find one that 
  51. did not require a 'Twit' file. As I have over 150 users and only wanted to 
  52. allow 25 into the door I would have had to make a 125 name 'Twit' file.
  53. No thanks. So DAM was written.
  54.  
  55.         DAM will allows you, through DAM.nam, to decide who may use the
  56. door. (more on this later) It will also check the access level and if it
  57. is below the one in DAM.nam will not let that user into the door. DAM also  
  58. allows you to specify two seperate time blocks where no one can get into the
  59. door. This is helpfull in shutting down the door before events or limiting 
  60. the time of day your users can use the door. I use it to shut my game doors 
  61. down in the evenings to allow others to use the board for mail. It will 
  62. display one of three files. One if the door is closed, name not found, or
  63. name found but access to low. I use these to direct my users to a bulletin
  64. that gives complete information about the door.
  65.  
  66.         Installation and use of DAM has been made a easy as possible.
  67. First put the six DAM files in a directory all their own. Then edit DAM.cnf
  68. to reflect your system. There are eight and only eight lines in DAM.cnf and
  69. each must end with a carrage return and a line feed. This is not real 
  70. important as most editors will automatically place them there for you.
  71. I use DOS's edit to do mine. The eight lines are as follows 
  72.  
  73. 1) Your BBS name. This is limited to 30 charaters. Anything more than this
  74.    and the name will be trunciated.
  75.  
  76. 2) Sysop name. This is limited to 25 charaters. Again anything over that and
  77.    the name will be truncitated.
  78.  
  79. 3) This line is the path to your door.sys file. This line is limited to
  80.    60 charaters. Anything more and the program will not find your door.sys
  81.    Example: c:\pcb\door.sys
  82.  
  83. 4) This is the first close time. It is military time and must contain 4 
  84.    digits as in 0400 for 4:00am. This is time that DAM will stop access
  85.    to the door.
  86.  
  87. 5) This is the first open time. Again it must contain 4 digits and is
  88.    military time. This is the time DAM will let the door be used again. 
  89.  
  90. 6) This is the second close time and it follows all the rules of the first
  91.    close time.
  92.  
  93. 7) This is the second open time. Again same as above
  94.  
  95. 8) This is the number of seconds to pause after displaying one of the files.
  96.    This can be from 00-60 and must contain two digits.
  97.  
  98. You can set lines 4,5,6, and 7 all to the same time and the door will always
  99. be open. That covers DAM.cnf.
  100.  
  101. The next step is to edit the DAM.nam file. This is the file where you put the
  102. user's name and access level that you are going to allow to use the door.
  103. Each entry contains two lines. 
  104.  
  105. 1) User's name. This is limited to 25 charaters and must match their name
  106.    in the door.sys file. 
  107. 2) The minimum access that this user must have to access the door. This can
  108.    be from one to three digits allowing up to 999 access levels.
  109.  
  110. This file can have as many names as you like but each must have the two lines
  111. described above. Also the total size of this file can not exceed 2000 bytes.
  112.  
  113. You may now edit the three display files.
  114.  
  115. 1) Closed - this file is displayed when ever the door is closed.
  116.  
  117. 2) Noname - this file is displayed when the user's name is not found in
  118.             the DAM.nam file.
  119.  
  120. 3) Noaccess - this file is displayed if the user's name is found but
  121.               their access level is below that in the DAM.nam file.
  122.  
  123. The final step in getting DAM up and running is to but it in the batch file
  124. that calls your door. An example batch file would be:
  125.  
  126. @echo off
  127. c:              ;change to drive that contains the DAM subdirectory
  128. cd\dam                          ;change to the DAM subdirectory
  129. dam                             ;run the DAM program
  130. if errorlevel 1 goto end        ;jump over the door
  131. d:                              ;change to door drive
  132. cd\door                         ;change to door subdirectory
  133. door                            ;run door
  134. board                           ;return to the BBS
  135.  
  136. The only thing here that needs any explaination is the errorlevel line.
  137. DAM will return one of five errorlevels depending on what happened when
  138. it ran.
  139.  
  140. 00) Everything went fine. Let the user into the door.
  141. 01) Door is closed. The times set have the door closed at the present time.
  142. 02) The user's name was not found on the list.
  143. 03) Name was found, but the user's access was too low.
  144. 04) Some type of file error occured. This is handled internally. But would 
  145.     suggest that you have it set-up wrong.
  146.  
  147.     That pretty well does it. Be sure that PCBOARD creates a door.sys file
  148. when it calls the door you will use DAM with. As a final note I have written 
  149. DAM to be as seemless as possible. If the user is on the list, has enough 
  150. access and the door is open they will never even know that it ran. I 
  151. programmed it completely in ML so it is extremly fast. I have not crippled 
  152. the program in any way. The only thing I have done is put a UNREGISTERED 
  153. screen in that will be removed when you register the program. Everything 
  154. else works as described. DAM works with the PCBOARD door.sys file. If your 
  155. software produces a door.sys with the first 15 lines the save as PCBOARD 
  156. then DAM will work for you. Have fun and enjoy
  157.  
  158.                                                 Steve
  159.         
  160.         
  161.          For more information or assistance I can be reached at
  162.  
  163.                      The Trader's Den BBS System
  164.                           (316)442-7210
  165.                      InterNet at RN.5087@ROSE.COM
  166.                      RoseNet at SYSOP@Traders.Den
  167. ------------------------------------------------------------------------------
  168.                    
  169.                    ================================
  170.                       DAM 1.0 REGISTRATION FORM
  171.                    ================================
  172.  
  173.  
  174.                     Remit to:  SDM Software
  175.                                620 N. 'B' St.
  176.                                Ark City, KS 67005
  177.                                U.S.A.
  178.  
  179.      ------------------------------------------------------------------
  180.      | Item                          | Quantity |  Price |    Total   |
  181.      |-------------------------------|----------|--------|------------|
  182.      | DAM version 1.0               | ________ | $15.00 | __________ |
  183.      |                               |          |        |            |
  184.      | KS residents only - sales tax |          |  6.25% | __________ |
  185.      |                               |          |        |            |
  186.      | Shipping (Outside U.S. only)  | ________ |  $5.00 | __________ |
  187.      |---------------------------------------------------|------------|
  188.      |                                                   |            |
  189.      |   Total amount enclosed                           | __________ |
  190.      ------------------------------------------------------------------
  191.  
  192.      Payment by:  ( ) Check or money order (U.S. funds only)
  193.  
  194.  
  195.      Name:     ________________________________________________________
  196.  
  197.      Company:  ________________________________________________________
  198.  
  199.      Address:  ________________________________________________________
  200.  
  201.                ________________________________________________________
  202.  
  203.                ________________________________________________________
  204.  
  205.      Phone:    ________________________________________________________
  206.  
  207.  
  208.  
  209.