Adopt - A - Door
v5.0
December 12, 1993
PCBoard 14.x and GAP 4.x
WILDCAT!, Spitfire
QBBS, RBBS, RA
by
Dennis Maidon
PAROLE TECHNOLOGIES
9411 Buffalo Rd
Clayton, NC 27520
(919) 965-3600 -> Voice
The Parole Board BBS
FIDO: 1:151/185
(919) 965-4696 -> US Robotics Dual Standard
(919) 965-9885 -> US Robotics Dual Standard
Free Advice BBS
(919) 934-1002 -> US Robotics Dual Standard
OVERVIEW
________
Adopt-A-Door runs just before you regular door program and displays
the name(s) of your users that have donated funds to purchase a door
program for your BBS. What better way to solicit funds that to
advertise the name of a very generous user.
FILES
---------
ADOPT.EXE <- The EXEcutable file
ADOPT.CFG <- Sample of the CFG file for ADOPT
ADOPT.DOC <- This file you are reading now.
DOOR.BAT <- Sample of Batch file to run ADOPT
PAROLE.COM <- I need to advertise just a bit.
READ.ME <- Last minute thoughts and ideas
ADCNF.EXE <- Create the ADOPT.CNF file
This ZIP file was created using the -AV function of PKZIP. If
my AV is missing then this file may not be complete of 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.
INSTALLATION
____________
Installation is fairly easy and straight-forward. The following steps and
examples should have you up and running in a very short period of time.
It is assumed that you are familiar with setting up DOORS on your system.
To this end, only examples of the configuration file and Door batch file
are described.
1) Create a directory to hold all ADOPT files
2) Unzip ADOPT.ZIP into the the above directory
3) Create a configuration file, with a name of your choice, or
modify the ADOPT.CFG file that is enclosed.
A description follows:
C:\WILDCAT\CALLINFO.BBS ──┐ <- For Wildcat!
C:\WC30\USERINFO.DAT │ <- For Wildcat! 3.0 (NODEx dir)
C:\PCB\PCBOARD.SYS │ <- For PCBoard using PCBOARD.SYS only
C:\PCB\USERS │ <- For PCBoard using USERS only
C:\BBS\DOOR.SYS │ <- For Systems that support DOOR.SYS
C:\BBS\DORINFOx.DEF │ <- For QBBS/RBB/RA. Replace x with Node #.
C:\BBS\SFDOORS.DAT │ <- For Spitfire
C:\BBS\TRIBBS.SYS ──┘ <- For TriBBS
The Parole Board BBS <- Your BBS Name
Dennis <- SysOp's First Name
Maidon <- SysOp's Last Name
Jim Smith <- Name of the donor(s)
ESP! <- Adopted door's name
YES <- Create .DNR Log
00000 <- Registration Number
C:\WILDCAT\ <- Path to create the .DNR log
YES <- YES = SUPER Screen NO = Standard Screen
NO <- Turn off Prompt
Edit this .CFG file to suit your individual BBS. All 11 lines MUST
be present.
Line 1: This line points to where ADOPT.EXE will find the callers
information file. Just include the line that your particular
BBS uses. DO NOT put all of them in the CFG file.
Line 2: Place the name of your BBS on this line.
Line 3: SysOp's first name goes here.
Line 4: SysOp's last name goes here.
Line 5: Place the donor(s) name(s) on this line. If there are more
than one it will look better to separate them by a "&" as in
Bob Smith & Johnny House.
Line 6: Place the name of the adopted door on this line.
Line 7: YES to create .DNR log or leave blank
Line 8: Your Registration Number goes here if registered
Line 9: Path and directory to place .DNR log. Be sure to add the
trailing backslash. "\"
Line 10: YES = Super Screen or NO for regular screen. The SUPER
screen is configurable.
Line 11: (Y/N) Turn off prompt line if need be
If you use the above CFG file be sure to remove all remarks and use
a pure ASCII editor such as EDLIN or QEDIT. Hidden control codes could
cause the program to depart for worlds unknown.
4) Create a batch file or modify the ADOPT file supplied. A
description of this file follows:
ECHO off
CD \DOORS\ESP Location of ADOPT files
ADOPT ADOPT.CFG EXE filename and CFG filename (Name
used in creating file in #3 above)
ESP! ESP!.CFG The Adopted Door Program
CD\WCAT
CAT.BAT
5) When running in more than one node, be sure to supply a
different configuration name for each node (your choice of name).
Adopt has been tested under LIVECAT! and performs very well.
NOTE: When using Wildcat! 3.x, Line 1 of the CFG file *MUST* point to
your NODE directory, not the HOME directory.
NOTE: ADOPT 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
FOOBAR FOOBAR.CFG *5
The /5 tells ADOPT to use IRQ5 rather than the standard IRQ4 that
is normally used with COM1. No /x parameter is needed for the standard
IRQ's.
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
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.
If you select the super Screen option ("Y" on line 10 of the CFG
file), you will need to run ADCNF.EXE which will create a file named
ADOPT.CNF. This file MUST be in each door directory in which you run
Adopt. Each individual door directory must contain it's own CFG and CNF
files.
The ADCNF.EXE program allows you to set the colors and text that
you like on the Super screen. The regular screen is already locked into
it's text and colors. I use this one for doors that have already been
'adopted' and the Super Screen when I am advertising for a donor. The
file created is a binary file so do not try to alter or edit it with an
ascii editor. It just won't work.
ADOPT-A-DOOR
____________
The concept, ADOPT-A-DOOR, allows a caller to register (ADOPT) a door. It
would be the same as sending in a donation, only this way it is earmarked
for registering a particular door. In a way, the user feels he/she is
"getting something in return".
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.
REGISTRATION
____________
I am not a subscriber to the "Crippleware" concept, and this program
reflects that philosophy. This is a full-featured program, whose
functionality is not hampered in any way, whether you register it or
not. It is only $15 to register this door. that's not too much to
ask for a program that could save you big bucks.
Remember, should you have any problems, questions or suggestions, be sure
to drop me a message on either of the aforementioned BBS or via FIDO
DOORWARE conference or NETMAIL. (1:151/185)
THANKS
--------------
Special thanks goes out for my wife who is definitely a
"Computer Widow".
Ted Freeman the author of DOORFRAME, a first class BBS Doors
Development Library. Ted still lives on in the fantastic software
he wrote.
My BBS users who have had to endure constant badgering to help me
test the programs that I have written.
Mark Tetrault and Rick Emmick, SysOps of of two fantastic WILDCAT!
BBSs, without whom, this program would never have worked.
Mustang! Software - Home of the best Damn BBS software available
today.
ADOPT - A - DOOR is written using MicroSoft's Visual Basic for DOS
(Professional Version)