

  Ŀ
   >>>>>>>>>>>>>>>>>>>>>>>>>  T&J Raffle!  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<  
  Ĵ
  *                    Copyright 2004 - BBSFiles.com                       *
  *                                                                        *
  *                             original                                   *
                      COPYRIGHT 1993 T&J SOFTWARE                         
  Ĵ
                                                                          
                      VERSION 1.1      11/13/93                           
                                                                          
                                  By                                      
                                                                          
      Tom Wildoner                              The T&J Software BBS      
                                                                          
  


LEGALITIES
^^^^^^^^^^
      THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
      WITHOUT WARRANTY, EXPRESS, 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.

SUPPORT
^^^^^^^
Please feel free to email: support@bbsfiles.com

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.

Please see the SYSOP.TXT and VENDOR.TXT file for further distribution
policy.

REGISTERING
^^^^^^^^^^^
A public registration key is included

Any limitations will be removed after registration!

FEATURES
^^^^^^^^
> RIP Support!
> Return to BBS on dropped carrier.
> 4-minutes no activity will return to BBS.
> Online Chat.
> Dump user back to BBS.
> Drop to DOS function.
> Desqview Aware.
> COM0-15 support and non-standard IRQ's.
> Colorful ANSI screens.
> NO BRUN module needed for play.
> Use of HOT KEYS while in the door.
> Support BBS available.
> Easily SET and RESET the entire program.
> Self maintaining no maintenance required.
> Fossil driver support.
> Supports Wildcat IM and PCBoard/M versions.


DESCRIPTION
^^^^^^^^^^^
Raffle is an excellent door to use for GUARANTEED Prize
Give Aways! You set the total number of tickets to give away, how many
tickets each person is allowed to have, and the date that the door
locks.

After the total tickets are gone, or the date is reached, run a simple
utility program to pick the three winners! Bulletins will be created
showing the winners, and they will also be informed inside the door.


SPECIAL FEATURES
^^^^^^^^^^^^^^^^
There is a file called EXTRA.DAT that you may edit to your liking! You
may add people's names (in quotes) followed by a comma, and then enter
how many raffle tickets they are allowed. This way you may limit bad
users to fewer tickets or good users an extra amount of tickets!
Follow this format for entering names:

"Tom Wildoner",20
"Jane Wildoner",20

Another added feature is the STATUS command line. By running Raffle
with the STATUS command line, it will create a small file called
STATUS.TXT giving you the current status of the door. Follow this
example:

RAFFLE STATUS

This way, if your running Wildcat! for example, you may run a STATUS
check each evening and then use POSTMASTER '(c)Boardwalk Software'
to send the STATUS.TXT file to you.

We added a ONE TICKET PER DAY option in v1.1. Basically, if you enable
this option, it forces callers to go into the door once per day to
get their raffle tickets instead of getting them all at once.


INSTALLATION:     IMPORTANT!!!!!!!
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Run Raffle Utility Program by typing RAFFLE UTILITY

First, reset the door from scratch by selecting OPTION #4 in the
utility program.

Then, set up your SYSOP.CFG and RAFFLE.CFG file by using OPTIONS
#2 and #3.

CONFIGURATION
^^^^^^^^^^^^^
Example configuration file for PCBOARD.SYS
------------------------------------------
C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for USERS.SYS
----------------------------------------
C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for DOOR.SYS
---------------------------------------
C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for CALLINFO.BBS
-------------------------------------------
C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for DORINFOx.DEF
-------------------------------------------
C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
                          where 'x' is the BBS Node number.
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for SFDOORS.DAT
------------------------------------------
C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for CHAIN.TXT
----------------------------------------
C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for GTUSER.BBS
-----------------------------------------
C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)
1                   <=-  (COM port number - defaults to 1)
1                   <=-  (Node number - defaults to 1)


Example Batch File
^^^^^^^^^^^^^^^^^^

   ECHO OFF
   CD\DOORS\RAFFLE          <=- Switch to the door's Directory.
   RAFFLE RAFFLE.CFG        <=- Execute the door program and pass the
                                configuration filename to the program.
   CD\PCB                   <=- Go back to PCB DIR when user exits door.
   BOARD                    <=- Restart BBS.

This Door is multi-node  compatible so you may run more than 1 node from
the same .CFG file provided the path to your system file (DORINFOx.DEF,
CALLINFO.BBS, etc) is exactly the same unless you are using environment
variables, (q.v.)


Environment Variables
^^^^^^^^^^^^^^^^^^^^^
PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
variables. Non-PCBoard systems may also use these variables by including
the following in either your BBS batch or AUTOEXEC.BAT
  SET PCBDRIVE=C:               <- Drive letter of your BBS files
  SET PCBDIR=\BBSDIR            <- Path to your BBS files
Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CFG file for multi-node operation!

To specify a non-standard IRQ, put the IRQ number after the .CFG on the
command line.  For example:

     RAFFLE RAFFLE.CFG /5
or using the PCBDRIVE procedure:   SET IRQ=5   and use
     RAFFLE RAFFLE.CFG /%IRQ%

This tells the program to use IRQ 5 instead of the standard IRQ.

  Had reports of conflicts when using non-standard IRQ's on Novell/Netware
 systems. Seems Novell also uses the / character so something went screwy
 somewhere. So I added the * (asterisk) which may be used instead of the /
 in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
 and are interchangeable.

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:\WC\NODE1   - C:\WC\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


Fossil Driver Support
^^^^^^^^^^^^^^^^^^^^^
DoorFrame 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
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, DoorFrame will print a message to that effect and exit
the door gracefully.


Sysop Keys
^^^^^^^^^^
F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
         written to DOOR.SYS and USERS.SYS
F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F8    -  Returns the caller involuntarily to the BBS.
F9    -  Toggles the local display On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F10   -  Activates SysOp CHAT mode within the DOOR.
ESC   -  Deactivates CHAT mode.  DOOR is resumed.
UP    -  Give the caller extra time while in the DOOR.  
DN    -  Subtract time from the caller while in the DOOR. 
HOME  -  HELP key for Status Line options.
ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
ALT-X -  PCBoard will exit after current caller logs off. Value is
         passed to PCBoard. Not available on non-PCBoard systems.


YOUR CONFIGURATION FILE
^^^^^^^^^^^^^^^^^^^^^^^
Change the SYSOP.CFG file to meet your needs:

5000
20
C:\BULL99.SCR
C:\BULL99.BBS
06-01-1993
6
3
First prize will be $40.00 off any purchase from T&J Software!


Second prize will be $20.00 off any purchase from T&J Software!


Third prize will be $10.00 off any purchase from T&J Software!



LINE 1: Total number of tickets available.
LINE 2: Total number of tickets any ONE users may obtain.
LINE 3: Path/Filename to your color bulletin.
LINE 4: Path/Filename to your ASCII bulletin.
LINE 5: Date the door will lock FORMAT: MM-DD-YYYY
LINE 6: How many times a player may enter the door per day.
LINE 7: How many prizes you are giving away: 1, 2 or 3
LINES 8-10: First prize description.
LINES 11-13: Second prize description.
LINES 14-16: Third prize description.


LOCAL MODE
^^^^^^^^^^
To run in LOCAL mode simply run RAFFLE using the LOCAL command line:

Example: RAFFLE LOCAL



PROBLEM AND ERRORS
^^^^^^^^^^^^^^^^^^
Consult the file TIPS.TXT for error/problem information!


REGISTERING THIS PROGRAM
^^^^^^^^^^^^^^^^^^^^^^^^
visit http://BBSFiles.com to purchase a "vanity" key