home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DAWN100.ZIP / DAWN1.DOC < prev    next >
Encoding:
Text File  |  1993-08-05  |  11.3 KB  |  269 lines
  1.  
  2.                                      Dawn
  3.  
  4.                              A semi-intelligent Door
  5.  
  6.                                   Version 1.00
  7.  
  8.                                    
  9.                              
  10.                                 Copyright (c) 1993
  11.                                 by Peter Mikalajunas
  12.                                 All rights reserved.
  13.  
  14.  
  15.                                  Support board is:
  16.  
  17.                                 The Ham Shack BBS
  18.                                    708-369-0730
  19.  
  20.  
  21.  
  22.                                 C O N T E N T S
  23.                                =================
  24.  
  25.                         WARRANTY 
  26.                         COPYRIGHT NOTICE 
  27.                         DISTRIBUTION 
  28.                         DESCRIPTION 
  29.                         FILES IN THIS ARCHIVE
  30.                         SUPPORTED DROP FILES
  31.                         DAWN1.CFG
  32.                         DAWNxx.DAT
  33.                         DAWN1.EXE
  34.                         FOSSIL SUPPORT
  35.                         SYSOP CONTROL
  36.                         CARRIER LOSS
  37.                         ENVIRONMENT VARIABLES
  38.  
  39.  
  40.                                    Warranty
  41.  
  42.   This product is provided "as is" without warranty of any kind. The entire
  43.   risk as to the results and  performance of the program is assumed by you.
  44.   Furthermore, the  author does  not warrant, guarantee, or  make any  other
  45.   representations regarding  the use of,  or the  results of the use of the
  46.   program,  and you  rely on the  program and  results  solely at  your own
  47.   risk.  The author  cannot and  will not accept  responsibility for system
  48.   damage, loss of profit, or any other special, consequential or incidental 
  49.   damages  resulting  from  the  use  or  inability  to  use this  product.
  50.  
  51.                                    Copyright
  52.  
  53.   Dawn Copyright (c) 1993 by  Peter Mikalajunas  is being distributed as
  54.   Shareware. Under this concept you may use the  SHAREWARE  (unregistered)
  55.   version for thirty (30) days for evaluation  after which you must either 
  56.   register your copy or discontinue  usage.
  57.  
  58.  
  59.                                  Distribution
  60.  
  61.     You  are encouraged to distribute Dawn provided that all files
  62.     contained in the archive are distributed in their original and
  63.     unmodified state.
  64.    
  65.  
  66.                                   Description
  67.                                   ===========
  68.  
  69.     Dawn is a BBS Door that provides a simple expert system or 
  70.     artificial intelligence for BBS Users.  Dawn makes no claim 
  71.     or pretense to be a substitute for a qualified human expert.
  72.     
  73.  
  74.                                Files in this Archive
  75.                                ====================
  76.    
  77.    You should have the following eight (8) files in this archive.
  78.    
  79.   DAWN1.EXE            the program, supports 10 drop files, various com & IRQ
  80.   DAWN1.CFG            provides the configuration information to Dawn1.exe
  81.   DAWN01.DAT           necessary for Dawn1.exe to work - Dawn personna
  82.   DAWN02.DAT           necessary for Dawn1.exe to work - Betty personna
  83.   DAWN03.DAT           necessary for Dawn1.exe to work - Carla personna
  84.   DAWN04.DAT           necessary for Dawn1.exe to work - Inez personna
  85.   DAWN05.DAT           necessary for Dawn1.exe to work - Selma personna
  86.   DAWN06.DAT           necessary for Dawn1.exe to work - Otto personna
  87.   DAWN1.ANS            ansi help file 
  88.   DAWN1.DOC            this file
  89.   DORINFO1.DEF         a sample drop file
  90.   FILE_ID.DIZ          a short description for bbs database files
  91.   REGISTER.TXT         descriptions of cost and registration options
  92.   VIEWIT.EXE           a utility program for viewing this document
  93.                                
  94.                                
  95.                                Supported Drop files
  96.                                ====================
  97.               This door supports the following drop files.
  98.  
  99.                 CALLINFO.BBS                       
  100.                 CHAIN.TXT                          
  101.                 DOOR.SYS                           
  102.                 DORINFOx.DEF
  103.                 GTUSER.BBS
  104.                 PCBOARD.SYS                        
  105.                 SFDOORS.DAT                    
  106.                 TRIBBS.SYS                          
  107.                 USERINFO.DAT
  108.                 USERS.SYS                          
  109.             
  110.  
  111.  
  112.  
  113.                               CONFIGURATION FILE
  114.                               ==================
  115.  
  116.      The format of Dawn1.cfg as used by Dawn is:
  117.  
  118. C:\BBS\CALLINFO.BBS             < For Wildcat! systems (prior to v3.0)
  119. C:\BBS\CHAIN.TXT                < For WWIV systems
  120. C:\BBS\DOOR.SYS                 < For systems that support DOOR.SYS
  121. C:\BBS\DORINFOx.DEF             < For QBBS/RBBS/RA. Replace x with Node #.
  122. C:\BBS\GTUSER.BBS               < For GT Power systems
  123. C:\PCB\PCBOARD.SYS              < For PCBoard systems using PCBOARD.SYS only
  124. C:\BBS\SFDOORS.DAT              < For Spitfire systems.
  125. C:\BBS\TRIBBS.SYS               < For TriBBS systems.
  126. C:\PCB\USERS.SYS                < For PCBoard systems using USERS.SYS
  127. C:\BBS\USERINFO.DAT             < For Wildcat! 3.x+ systems.
  128. Ham Shack                       < BBS name
  129. Peter                           < Sysop's first name
  130. Dalinis                         < Sysop's last name
  131.  
  132. NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
  133.       this file does not provide the Com port and Node variables, place them 
  134.       on lines 5 and 6 respectively. Both variables will default to 1, if
  135.       the sysop does not add the necessary information.
  136.  
  137.                                
  138.                                DAWNxx.DAT
  139.                                =========
  140.    If you decide to "tinker" with the program, then I suggest that you read
  141.    this section.   I ask that you only tinker with the Dawn05.dat file.  
  142.    A complete explanation follows.
  143.    
  144.    The structure of DAWN05.DAT, the Selma personna, is relatively simple.  
  145.    Key words are listed on a single line.  Groups of key words are proceeded 
  146.    by a period "." on a line.  Possible responses are then grouped after a 
  147.    single exclamation point "!" following the key words.  CAUTION before you 
  148.    alter this file, please play around with the program a bit.  You can 
  149.    cause some strange responses if you are not careful.
  150.  
  151.    Every effort has been made to recognize certain pronouns and substitute
  152.    the correct personal pronoun in the reply.
  153.  
  154.    Response phrases that end with an asterisk "*" are intended to be "joined"
  155.    to the user's input statement.
  156.  
  157.    I invite sysops to play with this file. Please keep a copy of the original
  158.    in a safe place.  I would very much like to see any key words or response
  159.    phrases that you come up with.  If I feel that they are worth including in
  160.    the next release of this program, I will give you, and your bbs, the 
  161.    appropriate credit!
  162.  
  163.    Be aware that there is a limit to the number of key words and response 
  164.    phrases that DAWN1 will recognize.  The current limits are 300 keywords 
  165.    and 200 response phrases.  This may be increased in future releases.
  166.  
  167.    WARNING                     WARNING                  WARNING                             
  168.    
  169.    If the program does not run properly after you have edited the file 
  170.    dawn05.dat, then I suggest that you delete the altered file and re-install
  171.    the original.  Every thing will run normally then.
  172.                                 
  173.                                 
  174.                                 DAWN1.EXE
  175.                                 =========
  176.     Quick Start ---------
  177.     
  178.     To just test the program with out bothering to set up for your bbs.
  179.     Make sure that Dawn1.exe, DawnXX.dat, Dawn1.cfg and Dorinfo1.def are in
  180.     the same directory.  From the "C" prompt type the following:
  181.     DAWN1 DAWN1.CFG
  182.  
  183.     Installation for your bbs -------
  184.  
  185.     Read through this documentation concerning the file DAWN1.CFG and make
  186.     the appropriate changes.  Use what ever batch file magic you need to 
  187.     make sure that the appropriate drop file exists in the directory 
  188.     indicated in Dawn1.cfg.  Also be sure that Dawn1.exe, DawnXX.dat and 
  189.     Dawn1.cfg are all located in the same directory.
  190.  
  191.     If you are using a fossil driver see the section that follows on their
  192.     use with this door.
  193.  
  194.     Those pesky delays ------
  195.  
  196.     There is a 15 second delay built into each side of DAWN.  Your users
  197.     are forced to wait 15 seconds to enter the door and 15 seconds to exit
  198.     the door.  This is the only limitation of the shareware version.  
  199.     Registered users have no delays.
  200.  
  201.  
  202.  
  203.                         Fossil Driver Support
  204.                         ---------------------
  205.  
  206.    Dawn supports the use of Fossil drivers.  To tell Dawn to use the
  207.    Fossil driver instead of the standard COM ports, just put /FD on the 
  208.    command line when running the door. For example:
  209.        DAWN1 DAWN1.CFG /FD
  210.    indicates that a Fossil driver is present and should be used. If no Fossil
  211.    driver is detected, Dawn will print a message to that effect and exit
  212.    the door gracefully.
  213.  
  214.  
  215.  
  216.                                 Sysop Control
  217.                                 --------------
  218.   The sysop can monitor the activity of the user at any time.  To suspend
  219.   the door and enter chat mode simply press the F10 key at any time.
  220.   The sysop has the option of increasing or decreasing the users time in the
  221.   door.  For the local sysop to get help at any time simply press the 
  222.   "HOME" key.
  223.  
  224.   If it becomes necessary to force the user out simply press F7. 
  225.  
  226.  
  227.  
  228.                 Returning control to the bbs upon carrier loss
  229.                 -------------------------------------------------
  230.  
  231.    There may be instances where the user drops the phone line or is 
  232.    disconnected while using the door.  Error handling has been provided 
  233.    that should allow the door to close all necessary files and return 
  234.    control to the bbs.  Also, on exiting normally from the door, the user 
  235.    is returned to the bbs and can not exit the bbs from the door.
  236.  
  237.  
  238.  
  239.                         Environment Variables
  240.                         ---------------------
  241.   Dawn supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  242.   COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  243.   number after the configuration file name. Let's assume 
  244.   you want to use COM1 and IRQ5. The command line
  245.   passed to your Door would be:
  246.      DAWN1 DAWN1.CFG /5  or
  247.      DAWN1 DAWN1.CFG /%IRQ%  for the environment variable.
  248.   The /5 tells Dawn to use IRQ5 rather than the standard IRQ4 that
  249.   is normally used with COM1. No /x parameter is needed for the 
  250.   standard IRQ's.
  251.  
  252.   When specifying the location of the system file on line 1 of the DAWN1.CFG
  253.   file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  254.   and %wcnodeid%. Some examples:
  255.      PCBoard: 
  256.   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  257.   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  258.  
  259.   Wildcat!:
  260.     USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  261.  
  262.  Non-PCBoard systems may use the PCB environment variables by setting them
  263.  in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  264.    SET PCBDRIVE=C:
  265.    SET PCBDIR=\BBSDIR
  266.    SET PCBNODE=1
  267.  
  268.                                 THE END
  269.