home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
DOOR
/
CDSUB50.ZIP
/
CDSUB.DOC
< prev
next >
Wrap
Text File
|
1993-12-10
|
18KB
|
364 lines
CD SUB
==========
One of the Livewire Collection of multi-BBS Doorware programs.
Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
UltraBBS, Telegard, TriTel, TriBBS, Remote Access, and WWIV
Written By
Richard Paquette
PO Box 416
Mt. Laurel, NJ 08054
(C)Copyright 1990/93
All Rights Reserved
DOOR DESCRIPTION!
CD Sub is a very simple door... it allows players to guess two numbers, we
randomly spin for two numbers, if they match the players guessed numbers,
then the player wins a SIX MONTH (6 issues) subscription FREE to the only
BBS Magazine available for Callers... The BBS Callers Digest.
If the player doesn't match the two numbers, then he/she is asked if they
would like to subscribe to the magazine using their Visa/MasterCard.
Please upload your ORDER.DAT file as often as there are entries.. so that
we can process the orders.. when you register this door.. you get a free
listing in the authorized CDSUB BBS List which will appear in the print
BBS Callers Digest each month along with the electronic version.
Please name the zip file with order.dat according to your registration
number.. for example if your reg number is 123456, then please name the
zip 123456.zip... "pkzip 123456 order.dat" would be the command to use.
When you upload the 123456.ZIP file to The Livewire BBS, please mark the
file PRIVATE with a forward slash / in front of the description.
If the player decides to download the order form to send in with his
check or money order.. he MUST include the name of the BBS he/she got
the order form from in order for us to remit your commissions to you.
If you have already registered a door program from "Livewire Doors" then
you have access already to all node numbers, if not then you can call
609-235-5297 to register CD Sub... because if the door isn't registered
NO ORDER.DAT file will be created. Any FREE subscription winners WILL NOT
be supported...
*** SPECIAL NOTICE TO ALL REGISTERED SYSOPS! ***
When this door is registered, your BBS name and access number will be
listed in BBS Callers Digest as an authorized BBS to order subscriptions
online. This "FREE" listing will be appended in each monthly copy of the
BBS Callers Digest Magazine.
FILES
The following files are packaged with CD SUB
cdsub.exe <--- executable program must be in directory at all times
cdsub.cfg <--- sample configuration file, must have one for each node
cdsub <--- Sample batch file to call up door program
cdsub.doc <--- What you are reading right now (includes order form)
history.doc <--- History of door versions
order.dat <--- Created if not there.. To be uploaded to us often
bbscd.log <--- Created if not there.. shows who downloaded order form
bbscd.frm <--- Order form that is downloadable from within the door
PLEASE DO NOT delete this file.. the door WILL NOT
operate correctly. PLEASE DO NOT EDIT THIS FILE EITHER!
doordesc.txt <--- Description of all Livewire Doors
order.frm <--- Order form for all Livewire Doors
PLEASE remember to upload us the ORDER.DAT file, it may contain names of any
winners in the door or credit card subscriptions... we cannot remit to you
unless we have the order.dat file!
Example Configuration for CD Sub
c:\pcb\users.sys <=- Full name of your systems file (see below)
The Livewire BBS <=- Full name of your BBS
Richard <=- Full first name of Sysop
Paquette <=- Full last name of Sysop
123456 <=- Your reg number (Something must be here!)
3 <=- Number of times caller can use door today
IMPORTANT NOTE!! (Please Read Me!)
We have tested the routine that controls how many times the door can be
used in any 24 hour period, but it will sometimes NOT allow the player
in on the next day.. if that should occur... just delete the CDSUB.USR
file, the program will create a new one.
As a matter of fact, we suggest that you delete the file each night in
your nightly event with a command similiar to the following:
--> if exist c:\cdsub\cdsub.usr del c:\cdsub\cdsub.usr <--
You can now take advantage of the PCBoard set variables in Board.bat.. if you
want to use them.. this door will read them..
NOTE: You must have DSZ in the your path somewhere for callers to be able to
download the order form.
GENERAL CONFIGURATION EXAMPLES
EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
------------------------------------------
C:\PCB\PCBOARD.SYS <=- (Full pathname of your PCBOARD.SYS file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
EXAMPLE CONFIGURATION FILE FOR USERS.SYS
------------------------------------------
C:\PCB\USERS.SYS <=- (Full pathname of your USERS.SYS file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
---------------------------------------
C:\BBS\DOOR.SYS <=- (Full pathname of your DOOR.SYS file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
-------------------------------------------
C:\BBS\CALLINFO.BBS <=- (Full pathname of your CALLINFO.BBS file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (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.
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
------------------------------------------
C:\BBS\SFDOORS.DAT <=- (Full pathname of your SFDOORS.DAT file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
----------------------------------------
C:\BBS\CHAIN.TXT <=- (Full pathname of your CHAIN.TXT file)
The Livewire BBSS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
Example configuration file for GTUSER.BBS
----------------------------------------
C:\BBS\GTUSER.BBS <=- (Full pathname of your GTUSER.BBS file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
1 <=- (COM port number - defaults to 1)
1 <=- (Node number - defaults to 1)
123123 <=- (Registration Number)
Example configuration file for TRIBBS.SYS
----------------------------------------
C:\BBS\TRIBBS.SYS <=- (Full pathname of your TRIBBS.SYS file)
The Livewire BBS <=- (Change this to your BBS name)
Richard <=- (The Sysop's first name)
Paquette <=- (The Sysop's last name)
==============
CD Sub BATCH FILE
This is the batch file whose name is entered in PCBSETUP. It should reside in
your default PCB directory. Leave this as is except for changing the paths.
ECHO OFF
C:
CD\CDSUB
CDSUB CDSUB.CFG <--- Please read NOTE below
C:
CD\PCB
IF EXIST EVENT.BAT EVENT
BOARD
NOTE: This door is multi-node capable and the requirement is to have a
different CD Sub.cfg passed on the batch file command line, such as:
CDSub CDSub1.cfg * CDSub CDSub2.cfg * CDSub CDSub3.cfg!
IMPORTANT NOTE FOR FOSSIL DRIVERS:
CdSub now includes support for FOSSIL drivers!!! This means your Doors
will work with multi-ports (e.g. PCBoard's/M version) and other multi-port
boards. To activate the Fossil driver support, just include /FD on the
command line when running the Door. For example:
cdsub cdsub.cfg /fd
If no Fossil driver is available, CdSub will display a message to that
effect and exit gracefully.
------------------------------------
Example Batch File
-------------------
A sample batch file is included and is similar to the following:
ECHO OFF
CD\DOORS <=- Switch to the door's Directory.
DOOR DOOR.CNF <=- 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 .CNF 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 .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CNF file for multi-node operation!
To specify a non-standard IRQ, put the IRQ number after the .CNF on the
command line. For example:
DOOR DOOR.CNF /5
or using the PCBDRIVE procedure: SET IRQ=5 and use
DOOR DOOR.CNF /%IRQ%
This tells the program to use IRQ 5 instead of the standard IRQ.
Top Ten Bulletin
----------------
The first time you run this door online it will create 3 files called
****.BUL, ****.BLT and ****.BLT. If you wish to change the path
or filename of the Bulletin, you must edit ****.BUL and change the
first line to whatever path/filename you desire, assuming that this door
requires or has a bulletin to display.. these docs are generic for all
The Livewire Doors and some of them DO NOT create a bulletin.
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.
Distribution
------------
This program is being distributed via the SHAREWARE concept and as such,
may be copied freely with the following restrictions:
* The program must be supplied in it's original unmodified
form, including documentation.
* This program may not be distributed as part of any commercial
application or service without the express, written consent
of the author.
* Vendors of Shareware/Public Domain software may not
distribute this program without the express, written
consent of the author even if Vendor has been approved
by the Association of Shareware Professionals (ASP).
Registration
------------
This door represents many hours of programming and the author deserves
just compensation for his time, efforts and expertise. If you find this
program to be of some value and you continue to use it on your system,
you must return the order form provided along with the registration fee.
Registration entitles you to free upgrades via modem from The Livewire
BBS Support Conference. Payments should be made in the form of a check or
money order. Foreign orders must be in U.S. funds drawn on a U.S. bank.
Online registration with Visa or Mastercard is available via our Credit
Card Door at the following system:
The Livewire BBS: (609) 235-5297 HST
NOTE: If you register by mail, your registration number will be posted
in a private message on The Livewire BBS.
Copyright
---------
This door is Copyrighted(c) 1989-93 by Richard Paquette, and is distributed
as Shareware. Under this concept you may use the SHAREWARE (unregistered)
version for a reasonable period of time for evaluation after which you
must either register your copy or discontinue usage.
Warranty
--------
This product is provided as is without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Futhermore, the author does not warrant, guarantee, or make any other
representations regarding the use of, or the results of the use of the
program, and you rely on the program and results solely at your own
risk. The author cannot and will not accept responsibility for system
damage, loss of profit or any other special, consequential or incidental
damages resulting from the use of or inability to use this product.
Com-Ports
---------
DoorFrame now supports COM 0 thru 15.
Fossil Drivers
--------------
This door may be used with Fossil drivers such as X00 & BNU. This makes
it compatible with most multi-port boards. To use the Fossil driver
instead of the standard COM ports, include /FD on the command line when
running the door. For example: DOOR DOOR.CNF /FD
WATCHDOG/CTTY
-------------
CTTY and WATCHDOG are not required and should not be used with this program.
CD Sub contains its own communication routines which monitor the COM port.
If carrier is lost, it will return to the BBS and log the user off the system.