318 lines
12 KiB
Plaintext
318 lines
12 KiB
Plaintext
|
|
============================
|
|
The ANSI Voting Booth
|
|
============================
|
|
COPYRIGHT 1991,94 T&J Software
|
|
|
|
One of the T&J Software Collection of multi-BBS door programs.
|
|
Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
|
|
UltraBBS, Telegard, TriBBS, and Remote Access.
|
|
|
|
|
|
VERSION 2.60 01/01/94
|
|
|
|
By
|
|
|
|
Tom Wildoner
|
|
397 West Broadway
|
|
Jim Thorpe, PA
|
|
18229
|
|
VOICE (717)325-9480
|
|
|
|
From
|
|
|
|
The T&J BBS
|
|
(717)325-9481
|
|
2 NODES
|
|
1200/2400/9600/19200/38400
|
|
24 Hours/Day
|
|
|
|
|
|
LATEST VERSION:
|
|
Please call the T&J BBS for the latest version of this program.
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
Benefits:
|
|
-- Support for COM1-15 and non-standard port definitions
|
|
-- Online CHAT
|
|
-- Multinode support (DesqView aware)
|
|
-- Colorful ANSI screens
|
|
-- Product support BBS available
|
|
-- Sysop Functions
|
|
-- Easy SETUP!
|
|
|
|
PROGRAM DESCRIPTION:
|
|
===================
|
|
|
|
This is a fairly simple door program -- it allows you, the SysOp, to
|
|
setup up to 10 different ANSI screens for your users to vote on. It's
|
|
great for online competition between your users! Let your users prepare
|
|
ANSI screens, upload them to you, then let the other users vote on their
|
|
favorite ANSI screens! Shoot, offer a prize to the winner!
|
|
|
|
NOTE: Some ANSI screens will show better than others. The screens are first
|
|
shown on the local screen and then sent to the COM PORT -- so be patient if
|
|
the door seems to be hanging (odds are the user is still receiving the
|
|
screen, especially for longer animation sequences).
|
|
|
|
Try saving your screens without using a clear screen command. AVB will
|
|
automatically clear the screen prior to showing the ANSI screen. If
|
|
you use TheDraw, simply save the file using the HOME CURSOR option as
|
|
opposed to CLEAR SCREEN.
|
|
|
|
|
|
NOTE: The voting function is disabled until registered.
|
|
|
|
|
|
INSTALLATION:
|
|
============
|
|
|
|
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 USERINFO.DAT
|
|
-------------------------------------------
|
|
|
|
C:\BBS\USERINFO.DAT <=- (Full pathname of your USERINFO.DAT file)
|
|
T&J Software <=- (Change this to your BBS name)
|
|
Tom <=- (The Sysop's first name)
|
|
Wildoner <=- (The Sysop's last name)
|
|
NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
|
|
|
|
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 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
|
|
==================
|
|
|
|
A sample batch file is included and is similer to the following:
|
|
ECHO OFF
|
|
CD\DOORS\AVB <=- Switch to the door's Directory.
|
|
AVB AVB.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:
|
|
|
|
AVB AVB.CFG /5
|
|
or using the PCBDRIVE procedure: SET IRQ=5 and use
|
|
AVB AVB.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.
|
|
|
|
Now, add your own screens following the format listed below. Enter all
|
|
this information in the SYSOP.CFG file, see the sample one that came with
|
|
the door. It would be much easier running AVB using the following
|
|
command: AVB UTILITY
|
|
|
|
This will bring up the utility program and you are offered four choices:
|
|
|
|
1. Reset the door.
|
|
2. Make your AVB.CFG file
|
|
3. Make your SYSOP.CFG file
|
|
4. QUIT
|
|
|
|
Here is what is contained in the SYSOP.CFG file for those of you who want
|
|
to use a text editor:
|
|
|
|
|
|
10 'Number of screens you have.
|
|
screen1.scr 'DOS filename for first screen.
|
|
screen2.scr
|
|
screen3.scr 'All screens must reside in your
|
|
screen4.scr AVB directory!
|
|
screen5.scr
|
|
screen6.scr
|
|
screen7.scr
|
|
screen8.scr
|
|
screen9.scr
|
|
screen10.scr
|
|
Add for Galactic Warzone! 'Description for the first ANSI screen.
|
|
Add for T&J Software Support BBS '40 characters maximum!
|
|
Bombing of IRAQ!
|
|
Add for US Robotics
|
|
What is it like being a SysOp?
|
|
Add for Mustang Software BBS
|
|
Add for Prize Vault Door game
|
|
Add for Lemonade Door game
|
|
T&J Software -- most popular files
|
|
Eric Erway ANSI screen
|
|
|
|
NOTE: If you do not have 10 ANSI screens to show, you must include blank
|
|
spaces for the rest of the entries. Lines 2-11 are the DOS filenames of the
|
|
ANSI screens and lines 12-21 are the descriptions. This file must contain
|
|
21 lines.
|
|
|
|
|
|
To run in LOCAL mode simply run: AVB LOCAL
|
|
|
|
WHEN YOU CHANGE SCREENS:
|
|
==== === ====== =======
|
|
When you switch screens (after you think all the users have had a chance
|
|
to vote for the current screens), you can reset the LOG file, the voter
|
|
registration file, and the vote total file by running AVB using the
|
|
following command: AVB UTILITY
|
|
|
|
Then select option 1 to reset the records.
|
|
|
|
UPGRADING:
|
|
|
|
From v2.4/2.6 to v2.6 just replace the main .EXE file and the
|
|
AVB1/2/3/4.DAT files!
|
|
|
|
FUTURE VERSIONS:
|
|
--->> Let me know what you would like to see!
|
|
|
|
VERSION HISTORY:
|
|
See the enclosed HISTORY.TXT file.
|
|
|
|
REGISTERING:
|
|
That's all there is to it! If you have any problems or questions
|
|
please feel free to call the T&J BBS at (717)325-9481 and join the
|
|
T&J Software Conference.
|
|
|
|
See the REGISTER.TXT file for information on registering.
|