Hello Everyone,
I got really bored with the quotes that were on my BBS out-of-the box and
decided to look into several of the add-a-quote doors that were out.

I didn't like any of 'em!

Plus, I wanted my users to be able to have a say in what hits you in the eye
when you log on! They use it. Might as well be able to add something to it!

Anyway, to make a long story short, I wrote my own. You can have this thing
free of charge (no kidding!). SysOp's pay enough money out as it is just to
get their boards up and running, so here is a *freebie* that you can use at
no cost. This is just a small way of thanking all of you for allowing me on
your boards!

Only one thing that I request: let me know if you are using this thing! I like
to keep a mailing list of all of the BBS's out there (I like to call them when
my wife isn't pounding me over the head about the phone bill!) so please fill
out the registration form and mail it to me. It'll cost you a stamp and a
few seconds time, but that is all! Another thing I do with the info you
provide me from the registration form: I enter you into my BBS database that
is a bulletin displayable to my users! It might get you a few users from my
area!

If you have any ideas for improving this thing, drop me a line or call up
my board. I'll update it if you have a need!

You may use the 2 Cents Worth door for 30 days as an evaluation period. At the
end of that time, you must either fill out and return the registration form
or stop using it.

Thanks, SysOp's for the great boards!

Howard Blake
Green Acres! BBS
(505)763-5129
Over 1.4 Gigs on-line!
300 - 9600 Baud
A WildCat 3 BBS!

DIRECTLY SUPPORTS THE FOLLOWING BBS INTERFACE FILES:

DOOR.SYS, PCBOARD.SYS/PCBOARD.DAT/USERS, SFDOORS.DAT, CALLINFO.BBS,
DORINFO1.DEF, DORINFO2.DEF, and CHAIN.TXT.

If your BBS interface file is not listed here, no problem! Use a conversion
utility (best -> QKDOOR utility!) to convert your interface file to one of
the supported formats.


HOW TO SET UP 2 CENT'S WORTH!

Two environment variables must be set in your AUTOEXEC.BAT file:

SET LIB= Note: ONLY the PATH!

Example: SET LIB=C:\MYLIB

The DORPCH38.EXE run-time library and DOORPCH.CFG files must then
be placed in this directory. I'd suggest a separate directory as
I do on my system and include it in your PATH statement.

SET DOORPCH=PCB (for compatibility with prior versions of DORPCH)

(NOTE: The 2CENTS.CFG file can be created using any text editor, or use the
setup program that I have provided - SETUP.EXE)

2CENTS.CFG - An Example:

C:\WC30\WCWORK\NODE1\DOOR.SYS ;Path to DOOR.SYS file
Green Acres! BBS ;BBS Name
Howard ;SysOp's First Name
Blake ;SysOp's Last Name
Howard Blake ;Who Sponsored This Door!
C:\WC30\DISP\QUOTES.BBS ;Path\Filename of QUOTES file
WC3 ;Use WildCat 3.x Color Macros

Line 1: Enter the path to your particular BBS software's door interface file
and the door interface file name (i.e., DOOR.SYS, PCBOARD.SYS, etc.).
Line 2: Your BBS Name
Line 3: Your First Name
Line 4: Your Last Name
Line 5: Door's Sponsor (adopted by). SysOp- Put your name in here!
Line 6: Enter the path and the name of the file you want the 2 Cent's Worth
quotes to be stored in. Name can be any valid DOS file name.
Line 7: You can have the quotes stored in either:
A) WildCat color mode using WildCat 3.x color macros. Enter WC3.
B) ANSI color using ANSI color codes. Enter ANSI on this line.
C) No color at all. Enter NONE on this line.


SAMPLE BATCH FILE TO RUN 2 Cent's!

WildCat 3.x SysOp's:
@ECHO 2 Cent's Worth>>C:\WC30\ACTIVITY.001
REM This will enter the name of the door that is running in your activity
REM log! Not just the DOOR Number!
CD\C:\WC30\DOORS\2CENTS ;Change to DOOR directory
2CENTS 2CENTS.CFG ;Execute 2 Cent's Worth
CD\C:\WC30 ;Change back to the GEN directory
EXIT ;Just to be safe!


Other BBS Systems SysOp's:
@ECHO OFF
CD\DOORS\2CENTS
2CENTS 2CENTS.CFG
CD\
RBBS -or- PCB -or- Whatever your batch file for running your BBS is called.

As soon as you have created the 2CENTS.CFG file, it is ready to run! Use the
information provided by Raymond Clements (below) for installing DORPCH38,
needed to run 2 Cent's Worth. If you don't have a copy of DORPCH38, call up
my board Green Acres! or Raymond Clements board PEGASUS, and download a copy!

PLUG:
Raymond has invested a lot of time in the DORPCHXX libraries! Please help him
to continue his work with it by registering your copy! He doesn't ask much:
only $10.00! (but he will accept more if you want to send it!).

To test 2CENTS in LOCAL MODE:
Enter the following command line for LOCAL mode operation:

2CENTS 2CENTS.CFG /LOCAL

This should do the trick for you! Hope you like it!


HOW TO USE DORPCH38! (REQUIRED FOR 2 CENT'S WORTH DOOR!)

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




DOORPCH v3.8 DOOR Operational Information for SysOps

September 15, 1991
By
Raymond Clements
2204 Carriage Dr.
Owensboro, KY 42301-5823

(C) Copyright 1987-1991
All Rights Reserved

The Pegasus BBS
Node #1 - (502)684-9855
Node #2 - (502)684-9871 HST
RIME PCRelay routable ->PEGASUS


SysOp Operation
-----------------

Please include the following information with any DOOR you write
which uses DOORPCH v3.8. The SysOp will require the information.


Preface
---------

This is NOT meant to tell you how to setup DOORs on your BBS,
just how to setup DORPCH38 doors.


Support Shareware
-------------------

Thank you for obtaining this door program. Many hours of coding
have gone into its development. Like all shareware products,
you're encouraged to register this program if it meets your needs.
Supporting Shareware helps insure the future development of such
programs and will entitle you to support from their authors.


Environment Variables
-----------------------

Two environment variables must be set in your AUTOEXEC.BAT file:

SET LIB= Note: ONLY the PATH!

Example: SET LIB=C:\MYLIB

The DORPCH38.EXE run-time library and DOORPCH.CFG files must then
be placed in this directory. I'd suggest a separate directory as
I do on my system and include it in your PATH statement.


SET DOORPCH=PCB This variable is required by prior versions
of DOORPCH, but not by DORPCH38.EXE.

For your convenience DOORPCH v3.8 also supports the following three
new variables:
%NODE% , %DRIVE% , and %DIRECTORY%

SET NODE=1 (ie. 1 , 2 , etc.)
SET DRIVE=C: (ie. C: , D: , etc.)
SET DIRECTORY=\BBS\ (ie. \PCB\ , \BBS\ , etc.)

These may be used to allow a single DOORNAME.CFG file for all nodes.
When using these variables please remember the combination of them
MUST form a valid DOS "drive:\path\" pointing to the location of the
BBS interface file.


DOORPCH.KEY
-------------

DoorPch is released as a completely UNcrippled program. Upon
registering DoorPch you'll receive a DOORPCH.KEY file. This
file should be put in the "SET LIB=" directory along with the
DORPCH38.EXE and DOORPCH.CFG files. Upon exiting, all DOORs
using DoorPch v3.8 will then say "This copy of DoorPch v3.8 is
registered to: " and your BBS name, your name and your serial
number.


DOOR Setup
------------

Make a batch file to run the DOOR as described in your BBS
documentation.


Example DOOR batch file:
--------------------------

ECHO OFF
CD\DOORS\4CARD
4CARD 4CARD.CFG <== Runs 4CARD.EXE passing
a parameter of 4CARD.CFG to it.
CD\BBS
BOARD


Example DOORNAME.CFG file:
----------------------------

You may use the environmental variables to only require one
DOORNAME.CFG file for multiple nodes.

C:\BBS\DOOR.SYS <== The drive:\path\filename
of your BBS interface file
which is the same as

%DRIVE%%DIRECTORY%DOOR.SYS

using the above variables.
The Pegasus BBS <== The name of your BBS.
Raymond <== The SysOp's FIRST name.
Clements <== The SysOp's LAST name.
John Doe & Jane Doe <== The name(s) of the DOOR's sponsors.


Command-line parameters
-------------------------

This parameter may be used when starting a DOORPCH v3.8 DOOR.

/LOCAL <== Allows local usage of the DOOR as
the SysOp.
(ie. 4CARD 4CARD.CFG /LOCAL)


DoorPch v3.8 Utility: DP38Util
--------------------------------

These parameters may be used with DP38Util to setup and maintain
each DOOR's high score file and/or challenge ladder file.

/CREATE <== Creates the high score file and/or
the challenge ladder file.
(ie. DP38UTIL 4CARD.SCR /CREATE)
/PURGE:## <== Purge names from database if they
haven't used the DOOR in ## days.
(ie. DP38UTIL 4CARD.SCR /PURGE:21)


Libraries
-----------

All DOORPCH v3.8 DOORs require the DORPCH38.EXE run-time library
and the Microsoft (R) QuickBASIC 3.0 run-time library, BRUN30.EXE,
be in your path. Your DOOR program may have come with these files
in the archive file. If they are not present, this DOOR program
WILL NOT RUN. You should contact the DOOR author if the files
are missing. You require one and only one version of these two
libraries for ALL DOORPCH v3.8 DOORware. The files are also
available in DORPCH38.ZIP available on most of the better Bulletin
Board Systems. If you wish a fully detailed explanation of how
DOORPCH operates with DOORS, then you may read the documentation
within the DORPCH38.ZIP file within which this documentation may
be found.


DOOR Operation
----------------

When this DOOR is in operation you have complete control over the
caller. This DOOR was written using DOORPCH v3.8. The logic is
safe and every precaution has been taken to insure this code works
flawlessly. If it doesn't, please let us know. Many
function/operational keys are at your disposal:

F1 - Displays the version of DOORPCH compiled and linked
into the DOOR.
F2 - Displays a caller's Alias if one is used via the DOOR.
F3 - Toggles Local Music ON/OFF.
F4 - Toggles the Bell ON/OFF.
Value is returned to BBS when DOOR completes.
F5 - DOS Shell. Allows the SysOp to exit to DOS from inside
a DOOR.
F6 - Toggles the Graphics mode of the caller ON/OFF.
Value is returned to BBS when DOOR completes.
F7 - Toggle the caller alarm ON/OFF.
Value is returned to BBS when DOOR completes.
F8 - Involuntarily returns the caller to the BBS.
F9 - Toggles the display ON/OFF.
Value is returned to BBS when DOOR completes. Some doors
may force the display ON, but the original OFF value will
be returned to the BBS if this occurs.
F10 - Activates SysOp/Caller CHAT mode within the DOOR.
ESC - Deactivates CHAT mode. DOOR is resumed.
ALT-H - HELP key for lines 24/25 capabilities.
UP - Allows the SysOp to add additional time for the caller.
Value is returned to BBS when DOOR completes.
DN - Allows the SysOp to subtract time from the caller.
Value is returned to BBS when DOOR completes.
ALT-N - Some BBSs use SysOp next on control/indicator.
Value is returned to BBS when DOOR completes.
ALT-X - Some BBSs will exit after current caller completes their
session. Value is returned to BBS when DOOR completes.


Example: DEVICE=ANSI.SYS
--------------------------

DOORPCH uses this device driver for displaying all colors and
screen positioning to the local console. ANSI Color Graphics will
always be sent to the local console if you are using a color
monitor. If a caller is in non-graphics mode you will still see
colors if you have a color monitor. The reverse is also true.
If the caller is in graphics mode and the local console is a mono
monitor then colors will NOT be displayed to the local console.


MUSIC
-------

This DOOR program may utilize ANSI/BASIC music. If it does, and you
are running in a NETWORK, DOORPCH does not send ANSI music to the
local console unless you have it configured to. We have found that
under some Multi-Tasking operating systems such as DoubleDOS that
the "partition" locks up until the music completes. If you are on
a single node system (not in a network), then music will be played
to the local screen if the local screen is active (F9 ON) and you
have DOORPCH configured that way or local music is toggled on (F3 ON).


BELL
------

DOORPCH logic will not allow a BELL to be sent to the local
console when the local screen is inactive (F9 OFF) or the caller
alarm is toggled off (F7 OFF). This, of course, assumes the
DOOR author follows the DOORPCH rules.


ERRORS
--------

All errors should recover and cause the DOOR program to exit
gracefully and return to the main system. All errors are logged
in the "DOORPCH.ERR" file found in the "SET LIB=" directory. The
error number and line number are included with the date and time.
Errors will be either caused by the main module (the authors code,
contact him/her) or the DOORPCH sub (contact Raymond Clements).
It should NEVER cause the BBS to hang. If your BBS hangs, you are
requested to contact the appropriate party and report the error and
circumstances that caused it. Because we are using Microsoft's (c)
QuickBASIC 3.0 run-time routines, it is possible that BASIC will
detect a fatal error condition. As mentioned above, we have taken
every precaution, but simply cannot code for every error condition.
If the DOOR author follows all the rules, the DOOR should run without
error.




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


LICENSE AND EVALUATION AGREEMENT


READ THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT CAREFULLY
BEFORE USING THE ACCOMPANYING PROGRAM DISKETTE, THE COMPUTER
SOFTWARE THEREIN, AND THE ACCOMPANYING USER DOCUMENTATION, IF
ANY, (THE "PROGRAM"). THIS LICENSE AGREEMENT REPRESENTS THE
ENTIRE AGREEMENT CONCERNING THE PROGRAM BETWEEN YOU AND HOWARD
BLAKE OF BLAKE SOFTWARE (TM) (REFERRED TO AS LICENSOR), AND IT
SUPERSEDES ANY PRIOR PROPOSAL, REPRESENTATION, OR UNDERSTANDING
BETWEEN THE PARTIES. BY USING THE ACCOMPANYING PROGRAM, YOU ARE
ACCEPTING AND AGREEING TO THE TERMS OF THIS LICENSE AGREEMENT.
IF YOU ARE NOT WILLING TO BE BOUND BY THE TERMS OF THIS LICENSE
AGREEMENT, YOU SHOULD NOT USE THE ACCOMPANYING SOFTWARE.

WITNESSETH:

WHEREAS, Howard Blake, (hereinafter "LICENSOR") doing
business as BLAKE SOFTWARE (TM) has developed certain programming
and software to be covered by the terms of this agreement, and

WHEREAS, the Program embodies and reflects certain Trade
Secrets and Copyrights of the LICENSOR, and

WHEREAS, you are interested in licensing computer software
and documentation having the general characteristics of the
Program and therefore desire to evaluate the Program for possible
registration; and

WHEREAS, the LICENSOR has delivered a demonstration copy of
the Program to you, for the sole purpose of your conducting such
evaluation under the terms, conditions and limitations of this
Agreement;

NOW, THEREFORE, in consideration of the premises hereof, and the
mutual promises and obligations herein, upon use of the Program,
you hereby agree to be bound as follows:

(1) LICENSE GRANT: The LICENSOR hereby grants to you, and
you accept upon first use, a non*exclusive right to use the
accompanying Program Diskette and computer software contained
therein in object-code only form, and only as authorized by this
agreement. This computer program is strictly a
non*registered, demonstration version. This non*registered
version may be freely distributed and uploaded to BBS's subject
to the herein proscribed time limitations. From the date of
first use by you of the accompanying software Program, you can
use and test the program for a single thirty (30) day time
period. Thirty (30) days after first use of the program, the
program may not thereafter be used unless it has been previously
registered with the LICENSOR.


(2) Licensor's Rights: You acknowledge and agree that the
Program consists of proprietary, unpublished products of
LICENSOR, protected under U.S. copyright law and trade secret
laws of general applicability. You further acknowledge and agree
that all right, title, and interest in and to the Program are and
shall remain with LICENSOR. This License Agreement does not
convey to you an interest in or to the Program, revocable in
accordance with the terms of this License Agreement, but only a
limited right of use.

(3) Licensed "As Is" And Limitation Of Warranties:

(a) The Program and software subject to this Agreement
are licensed to you "AS IS" and the Licensor disclaims any and
all warranties, whether disclaims any and all warranties, whether
express or implied, including without limitation any implied
warranties of merchantability or of fitness for a particular
purpose.

(b) The Licensor and any of his associates shall not
be liable or responsible for any damages resulting to you or
others from your use of the Program. You assume full
responsibility for determining what use(s) the Program serve(s),
if any, and whether the Program meets your requirements. The
LICENSOR makes no representations whatsoever concerning the
performance, acceptability and/or compatibility with your
equipment and operation of the Program provided.

(4) Limitation Of Damages

You agree that with respect to any claims of any nature
whatsoever that you or any other party may have against LICENSOR
resulting from use of the Program, that LICENSOR shall be
notified in writing by you of the claim within 30 days of the
incident or occurrence giving rise to the claim, mailed, by
certified letter to:

Howard Blake
512 W. 17th Street
Clovis, NM 88101

You agree that in no event shall LICENSOR be liable for any
indirect, incidental, consequential, special, or exemplary
damages or lost profits, even if LICENSOR has been advised of the
possibility of such damages. You further agree that if for any
reason the LICENSOR is found to be liable to you as a result of
your use of the program and software, that as partial
consideration of the LICENSOR granting you this license, you
agree that LICENSOR'S sole and exclusive cumulative liability to
you or others shall be no greater than the amount of any
registration fee paid by you. SOME STATES DO NOT ALLOW THE
LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR
CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION MAY
NOT APPLY TO YOU.

(5) Proprietary Protection

(a) The Program is furnished to you for the sole
purpose of enabling you to determine whether to register Program
with the LICENSOR. You shall use the Program solely for such
purpose, and shall not, without the prior written approval of the
LICENSOR, either allow any third party to use, or yourself use,
the Program for any other purpose or for the benefit of any third
party.

(b) This Agreement conveys to you only a limited right
of use, fully revocable in accordance with the provisions of this
Agreement. Except for such right of use, you shall not assert
any right, title, or interest in or to the Program or any
pertinent documentation.

(c) The LICENSOR hereby represents, and you hereby
acknowledge, that the program and software contain substantial
Trade Secrets of the LICENSOR; such Trade Secrets have been
entrusted to you for use only as expressly authorized under this
Agreement. Under no circumstances may you decompile, reverse
engineer, or "unlock" as the term is generally used in the
industry, the program and software.

(d) LICENSOR claims and reserves to itself all rights
and benefits afforded under U.S. copyright law and all
international copyright conventions in the Program and any
pertinent documentation as restricted, unpublished works, or as
copyrighted material, as the case may be.

(e) You shall devote your best efforts, consistent
with the practices and procedures under which you protect your
own most valuable proprietary information and materials, to
protect the Program and any pertinent documentation against any
unauthorized or unlawful use or copying.

(f)
You shall make no hard copies of the Program, and may store in
memory only so much programming as authorized by the terms of
this agreement. Upon expiration of 30 days after your first use
of the program and software, you shall permanently cease use of
the program and software, unless it has been registered pursuant
to provisions of this agreement.

(6) Registration: You agree that after using the program
and software provided for thirty (30) days from first use, you
will not use or test the program and software, unless it has been
registered with the LICENSOR in one of the two following manners:

(a) You can register by filling out coupon located at
the end of this book and send with $5.00 to:

Howard Blake
512 W. 17th Street
Clovis, NM 88101

(b) After completing registration you will be
registered in the SYSOP conference on Green Acres! BBS. The
registration number permits you to make your demo*version a
fully*operational, registered version. You agree not to defeat
the registration, or to distribute a registered version of
this software to anyone. If you have any questions or comments,
feel free to contact the home board:

Green Acres! BBS (505)-763-5129

(d) Registration of the Program shall be exclusive to
the person registering said program and software, and you may not
transfer the registered program and software to or provide copies
of the registered program and software to third parties. The
registered program and software shall be subject to all
provisions and conditions of this agreement.

(e) The specifications of this product and the terms
and conditions of its registration are subject to change at any
time upon the sole and exclusive discretion of LICENSOR without
prior or future notification to you.

(7)Trademark: BLAKE SOFTWARE and the title of this program are
registered trademark of the Licensor. No right, or interest to
such trademarks are granted hereunder, and you agree that no such
right, license, or interest shall be asserted by you with respect
to such trademarks.

(8) Governing Law: This Agreement shall be construed and
governed in accordance with the laws of the State of New Mexico.

(9) Ambiguity: As partial consideration for this agreement
and use of the Program, you hereby agree that any ambiguity
contained in this agreement shall be construed most favorably to
the LICENSOR.

(10) Severability: Should any term of this License
Agreement be declared void or unenforceable by any court of
competent jurisdiction, such declaration shall have no effect on
the remaining terms hereof.

(11) No Waiver: The failure of either party to enforce any
rights granted hereunder or to take action against the other
party in the event of any breach hereunder shall not be deemed a
waiver by that party as to subsequent enforcement of rights or
subsequent actions in the event of future breaches.

(12) Venue and Jurisdiction: You hereby agree by virtue of
this agreement that any and all actions brought by you against
LICENSOR shall be brought before a Court of competent
jurisdiction in Curry County, New Mexico, and that as between you
and the LICENSOR, that this License Agreement shall be deemed to
have been entered into in Curry County, New Mexico.

(13) Acceptance: You agree to all the terms, conditions
and limitations of this agreement upon your first use of the
program and software covered hereby.

THIS PROGRAM IS THE CONFIDENTIAL AND PROPRIETARY PRODUCT OF
LICENSOR. ANY UNAUTHORIZED USE, REPRODUCTION OR TRANSFER OF THIS
PROGRAM IS STRICTLY PROHIBITED. COPYRIGHT 1991 BY BLAKE
SOFTWARE. SUBJECT TO LIMITED DISTRIBUTION AND RESTRICTED DISCLOSURE
ONLY. ALL RIGHTS RESERVED.