
                             Quarter*Slots

                 Copyright (c) 1995-96, PAROLE Software
                          All rights reserved.

                            PAROLE Software
                           9411 Buffalo Road
                           Clayton, NC  27520

                         Voice:  (919) 965-3600

                         dmaidon@mindspring.com


======================================
DESCRIPTION:

     A slot machine simulation door for multiple-BBS systems and
     softwares.  This program is compiled utilizing 80286 specific code
     and WILL NOT run on an 8088/8086 CPU.

     You may test this software locally by installing the door and
     typing "QSLOTS LOCAL" from the DOS prompt.

======================================
SUPPORT:

     Support for Q*Slots is available via several avenues.  Please read
     the enclosed SUPPORT.DOC for more details.

     InterNet: Dmaidon@mindspring.com
               I check this several times a day.

     Voice   : (919) 965-3600
               If you wish to utilize the voice method, please make all
               calls before 8:00 pm EST.  Remember you folks on the West
               Coast, I am in North Carolina.  Please use this when all
               other avenues fail.

Note:     If you do not know how to set up a door on your BBS, DO NOT
          call me to help you set it up.  Read your BBS documentation
          and setup any sample doors that are included.  I do not have
          the time to teach you how to set up doors.

          I also have a LOT of sysops that have no earthly idea how to
          install an ANSI driver or even edit the AUTOEXEC.BAT. <sigh>
          This is basic computer knowledge that you should acquire
          before operating a BBS.  Read your DOS manual and learn.  I do
          not teach DOS or basic BBS.

======================================
UPDATES:

     Updates to Q*Slots/Dos are free as long as I own the rights to the
     code.

======================================
INSTALLATION:

     1) Create a directory to hold the files contained in the
        QSLOTxx.ZIP archive.

     2) Unzip the archive into this directory.  If the "AV" for The
        Parole Board BBS does not appear, please call the BBS and
        download the latest version.  Support is not available for
        archives that have been altered.

     3) [IMPORTANT!] Run the INSTALL.BAT.  If you do not run this BAT
        file, DO NOT call me for support.  This file is included for a
        reason, use it.

     4) Edit the QSLOTS.CFG file to match your particular BBS software.
        Make sure that line #1 of the CFG file points to the directory
        where the user's drop file is created.  If you BBS software
        creates a DOOR.SYS file, I recommend that you use it.

     5) Edit the QSLOTS.SYS file.  DO NOT rename this file.

     6) Edit the DOOR.BAT for your particular BBS software.  I have no
        earthly idea what all the different formats but, since you are
        running the software, you should know how to setup a door.  If
        you do not know how to setup a door, do not call me for support.

     7) Logon to your BBS locally and test run the door.  If it does not
        run, check the Cfg file and make sure that ALL paths are correct
        and that they do exist.  If there is a DFRAME.ERR file in the
        door directory, look for the error number and compare it with
        the list in the ERROR.QB file.    The ERROR.QB file also has
        some notes concerning certain problems that you may encounter.
        You may save several LD phone calls by reading this file.  If
        you call and your problem is covered in this file, I will only
        refer you to the file.


NOTE:  *PLEASE* check your file name and paths very carefully.  Ninety
percent of the calls I get, are due to an incorrect path or CFG file
setup.  Read the following instructions carefully before calling.  You
should also read the QSLOTS.HIS file as it contains information that is
not included in this file.
-----------
QSLOTS.CFG

     This file need only contain the four lines listed below.  You may
     add any comments that you wish below these lines.  Q*Slots ONLY
     reads in the first four lines.

-----------
C:\WC4\WCWORK\NODE%WCNODEID%\DOOR.SYS
The Parole Board BBS
Dennis
Maidon

Line 1  Path to user drop file

     C:\WC30\WCWORK\NODE1\USERINFO.DATĿ
     C:\PCB\USERS.SYS                   <- Path to User file.  I recommend
     C:\SF\SFDOORS.DAT                     using DOOR.SYS if your particular
     C:\BBS\DORINFOx.DEF                   BBS software supports it!
     C:\BBS\CALLINFO.BBS               
     C:\BBS\GTUSER.DAT                 
     C:\BBS\DOOR.SYS                   
     C:\BBS\PCBOARD.SYS                
     C:\BBS\TRIBBS.SYS                

Line 2  BBS name
Line 3  Sysops first name
Line 4  Sysop's last name

NOTE:  You may now use one (1) CFG file for multi-node by using the
environment variables.

When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
 PCBoard:
   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS

 Wildcat!:
   USERINFO.DAT in C:\WC30\WCWORK\NODE1   - C:\WC30\WCWORK\NODE%WCNODEID%

Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
 SET PCBDRIVE=C:
 SET PCBDIR=\BBSDIR
 SET PCBNODE=1

                             --------------
Create the CFG file(s) for you particular BBS.  You will also need a DOORx.BAT
to run the door.  This one is simple.

@ECHO OFF
CD \DOOR\QSLOTS
QSLOTS QSLOTS.CFG /5  or QSLOTS QSLOTS.CFG /%WCIRQID%
              
 
  If you are running non-Standard Com ports on your BBS, you will need to pass
 the proper IRQ to the door.  It doesn't hurt to pass the IRQ even if they are
 standard.  If a user enters the door and it just sits there acting sort of
 stupid, it's probably looking for the correct IRQ.  Always pass it on the
 command line and there will be no question.  Some networks have a problem
 using the "/" symbol.  Q*Slots will now accept an asterisk "*" in place of
 the "/".  You may also use the environment variable in the DOORx.BAT file to
 pass info to the door.

QSLOTS QSLOTS%WCNODEID%.CFG /%WCIRQID%

Make sure you DO have the variables set if you use this method.

NOTE: Q*Slots supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
      COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
      number after the configuration filename. Let's assume your Door is
      called FOOBAR and you want to use COM1 and IRQ5. The command line
      passed to your Door would be:

        FOOBAR FOOBAR.CFG /5

      The /5 tells Q*Slots to use IRQ5 rather than the standard IRQ4 that
      is normally used with COM1. No /x parameter is needed for the standard
      IRQ's. Q*Slots supports IRQs 1 - 15.

-----------
QSLOTS.SYS

     DO NOT RENAME THIS FILE!
-----------
1234567
C:\WC4\BULL\BULL99.BBS

WC
100000
125
Y
45
5
10
1.25
250000

=======================
All lines must be present.  DO NOT rename this file.

Line 1    Registration Number (if Registered)
Line 2    path and name of color bulletin
Line 3    Path and name of ASCii bulletin
Line 4    Bulletin type
          WC  = WC! 3.x/4.x color codes
          PCB = PCBoard special color codes.
          N   = ANSI/ASCii bulletins.

          If you specify "WC" or "PCB" on line #4, you may leave line #3
          blank.
Line 5    Player's initial start-up bank.
Line 6    Total amount of Wagers that player may place in one day.  This
          is in dollars. ($)
Line 7    Y|N  Add 10% of winnings to Daily Wagers
          Y = This allows the players to wager 10% of their winnings on
              a given day.  Depending on a players luck, they could be
              in the door for their entire logon time.

          N = Player only has the initial amount in Line #6 to wager.
Line 8    Number of days for inactive users to remain in database
Line 9    Number of times a user may enter the door per day.  This will
          not override the Daily Wagers.  Should a player run out of
          funds, he will not be allowed to play any more for that
          specific day.
Line 10 Number of days to keep listings in Winner's Log
Line 11 Coin value (Keep this realistic).  Players may bet up to 5 coins
        per play so figure this in the equation.  For instance, if you
        give a player $50 in startup funds, set the coin value at $.25.
        This means that they will be able to play $1.25 per pull.  If
        you set the coin value at $5 per coin, they would only get 2
        pulls as they could play $25 per pull.
Line 12 Initial Jack Pot

Fossil Driver Support
---------------------
Q*Slots supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:

     MYDOOR MYDOOR.CFG /FD
     MYDOOR MYDOOR.CFG *FD

indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, Q*Slots will print a message to that effect and exit
the door gracefully.

    If you have WC! set up to TERMINATE on Doors, you will need to add a
    line to reload the BBS.  I'm not sure about the exact way this is
    set up since I do not use this method.  Check your WC! Manual.

     Wildcat! will pick up the [G]oodbye from the door as a normal
     logoff.  It is possible that Livecat! will see this as a Drop
     Carrier and not pass it to WC! as a normal logoff.  No damage is
     done.

NOTE:  You may edit any of the screens included in this archive for your
       personal use.  DO NOT distribute them in the QSLOTSxx.ZIP archive.
       You may distribute them separately.  I recommend using TheDraw to
       edit the screens.  They should remain the same physical size as
       the originals.  Be sure to delete any trailing blank lines at the
       bottom of the screens.  All copyright information must remain.
======================================
FILES:

  DONOR.CL     [REGISTERED]  This is a text file containing One (1)
               line.  This is used to display the name of the user that
               donated the door for your BBS.  Create the file and place
               it in the door directory.

 QSLOTS.CHK    This file is created and maintained by Q*Slots.  DO NOT
               edit it manually.

======================================
DISTRIBUTION:

   You may make this file available for downloading from your BBS or you may
   upload it to any BBS of your choice, provided that you do not make any
   changes to the contents of the archive (ZIP file). The archive and its
   individual contents may not be used by any service that charges any money
   whatsoever, without the written permission of the author.

        This ZIP file was created using the -AV function of PKZIP.  If
        my AV is missing then this file may not be complete or has been
        tampered with.  Complete and current editions of this program
        are always available for D/L on The Parole Board BBS.  If the -AV
        is missing please complain to your sysop to stop the practice of
        removing AV's as this is your assurance from the programmer that
        the file is complete and virus free.

        With version 4.2, I am utilizing the VENDINFO.DIZ program.
        Please DO NOT make any changes to this file that will invalidate
        the security of the files in this archive.  You may rearchive
        the files in the original archive as long as you DO NOT
        add/remove or change any existing files.

======================================

WARRANTY:

                              LEGALITIES
                              __________

      THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
      WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT
      LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
      FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
      THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
      SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
      OR BREACH OF ANY WARRANTY.


======================================
KUDOS:

     Thanks to those SysOps that took their time and money to help bring
     you this product.

     All products mentioned in this document are trademarks or
     copyrighted by their respective companies.

