		Ŀ
		               OCD v1.00                 
		      On-Line Checks Direct(tm) Door     
		        (C) CalypsoWare/PCCS, 1994       
		



Ŀ
  About ODD    


		 On-line Checks Direct v1.00

    Thank you for trying the On-line Checks Direct(tm) (OCD) door.  This
stand-alone module is the first in a series products from CalypsoWare(tm)
that will assist sysops in the collection of funds from users.

    OCD allows users to enter information about their checking or savings
accounts that will then be processed through American Banking Systems
Corporation (see enclosed file ABSCHECK.TXT for more details).  OCD will
work on any BBS capable of creating a DOOR.SYS drop file (either
directly or through the use of third party converters).  It provides
special features to users who log on through specially supported BBS
types (currently WILDCAT! and GAP) as well.

    OCD supports ASCII, ANSI, and RIP (Remote Image Protocal) graphics.
OCD is fully interrupt driven and supports Fossils, DigiBoard COM/Xi
boards as well as normal and non-standard com ports.  The FIFO buffers
of the 16550 UART chip are fully supported, enabling locked baud rates
of up to 115,200 baud.  OCD will monitor the carrier state and recycle
if caller drops carrier.  Other features include Sysop Chat, Sysop shell
to DOS, "Twit" key, DESQView aware, and multi-user capable.

   For more information about other products from CalypsoWare, please
call our support BBS at (714) 366-1355 or telnet to calypso.com. Voice
support is also available at (714) 366-1350.


Ŀ
  THIS IS A DEMO COPY 


   This copy of OCD is "demoware".  OCD is a commercial program, with
the full package being available upon registration.  While this
"demoware" version is being released for distribution, it is NOT being
placed into the public domain.

*** IMPORTANT NOTICE ***
   Without the registration key, you may run this program for evaluation
purposes only.  No information input by users will be saved until you
have obtained the registratio key.

   If you purchased this program from a SW distributor, you have
not registered it.  You must still pay the programmer to register it.
The money you paid to the distributor was to cover the cost of
duplicating/advertising/etc the files.

Ŀ
  Registration      


   Since this is a "demoware" release of OCD, you will be required to
register this program in order to begin processing tranasctions.  The
door will NOT save any information input by users until it is
registered.

   Please use the enclosed ORDER.FRM for information on how to register
your copy of this program.

Ŀ
  Requirements      


	1) OCD will only run on a BBS system that is capable of
		creating a DOOR.SYS file when a user opens a door.
		If your BBS will not create a DOOR.SYS file, there are
		conversion programs around to create a DOOR.SYS file
		from whatever your system creates.  I strongly suggest
		that you ask your BBS software's author to support the
		DOOR.SYS standard!

	2) OCD is designed to be run on any computer that is running an
		operating system that can emulate MS-DOS v3.xx or greater.

	3) The COLLECT utility assumes that you have:
		a) PKZIP must exist on your path
		b) You will need a telcom program (preferably with a scripting
		   language) so COLLECT can send your collected information
		   out to ABS for processing.

Ŀ
  Installation      


	To install OCD, simply copy all the files included in the original
distribution disk (or archive file) into a single directory.
The only files absolutely necessary to the operation of OCD are:
	OCD.EXE                  The door executable
	a configuration file     used by OCD and COLLECT
	COLLECT.EXE              The utility executable
	WELCOME.SCR              The welcome screen file
	THANKS.SCR               The thank you screen file
	GOODBYE.SCR              The goodbye screen file

	You will want to use a text editor to open OCD.CNF or create a new
.CNF file.  The Configuration format is as follows:

D:\WILDCAT\WCWORK\NODE1
Your BBS Name Here
0
0
STANDARD
0
0
0
00000.0000000000
WILDCAT!
XXXXX
Your Name Here
Donation
GETABS.BAT

Each line will be explained below:

1)      This is the directory where OCD will find the DOOR.SYS file
	created by your BBS software when a user opens a door. If you
	wish to use environmental variables in place of a fixed directory
	name, then use the following formats:
	       %VARIABLE% or \%VAR1%\%VAR2% or \WCWORK\NODE%WCNODEID%
	where the term between % signs is a valid environmental variable.

2)      This is the name of your BBS.  This is string that your registration
	number is keyed to.  It is also the string that will be displayed
	at the top of each screen in the module.

3)      This is the IRQ that should be used for the com port that you
	are using UNLESS you are using COM1 or COM2 in which case you
	will put a 0 here. A single environmental variable may be used
	here. (ex.: %wcnodeirq%)

4)      This is the Base Port Address for the com port that you are
	using UNLESS you are using COM1 or COM2 in which case you will
	put a 0 here. A single environmental variable me be used here.
	(ex.: %wcnodeaddr%) Note, address will be a hexidecimal number.

5)      This line is where you would indicate if you are running a
	STANDARD comm port or a DigiBoard. Your choices here are:
		STANDARD        DIGIBOARD       INT14/EBIOS     FOSSIL
	The STANDARD interface is the one that will normally be used. 
	If a sysop is using a DigiBoard, then either the DigiBoard or
	INT14/EBIOS interface  may be  selected. Most sysops will use the
	Int14/EBIOS interface.  All  input/output  to  the  DigiBoard  is
	performed via  Interrupt 14  calls and a Device Driver (available
	from DigiBoard) handles the interface between the program and the
	board. 
	The  DIGIBOARD interface uses Direct  Programming. OCD
	talks to the board directly without the need for a Device Driver.
	In order  to use  this interface,  a program  called RESETDIG.EXE
	must be used in the AUTOEXEC.BAT file to reset the DigiBoard once
	when the  computer is first booted. If you do not have this program
	(it is a part of the GAP Communications BBS package) then the
	Int14/EBIOS interface must be used.
	The FOSSIL interface has been tested and confirmed to work with
	BNU and X00 fossil drivers. 
	**IMPORTANT NOTE ABOUT FOSSILS*** (taken from the GAPCDR docs)
		    Note that due to the limitations of the Fossil's Interrupt 14
		interface, the highest baud rate that can be set is 38400 bps.
		It is possible to configure the Fossil Driver to lock the
		baud rate (BNU supports up to 38400 bps and X00 supports up to
		115200 bps). When the port is locked, the Fossil Drivers are
		supposed to ignore any requests for a change in port speed (we
		have not confirmed if they actually do this). However, the
		GAPCDR Communications routines will reject any baud rate higher
		than 38400 bps and will return an error if you attempt to
		initialize the port at a higher speed. The BBS software must be
		configured for a port speed no higher than 38400 bps.
	

6)      This is the DigiBoard Memory Window, or the address the board
	uses as a communications area between itself and the Host
	Computer. This line is used only if the Interface is set to
	DIGIBOARD. It can be set to 0 if the Interface is STANDARD or
	INT14/EBIOS.
	Valid entries are: C000, C800, D000, and D800

7)      This is the DigiBoard I/O Port Address. This line is used only
	if the Interface is set to DIGIBOARD and can be set to 0
	otherwise.
	Valid entries are: 100, 110, 120, 200, 220, 300 and 320

8)      This is the DigiBoard Channel Number. This line is required for
	the DIGIBOARD and INT14/EBIOS Interfaces. It is normally 1-8 for
	the DIGIBOARD Interface and 4-11 for the INT14/EBIOS Interface.
	The Channel Number is similar to a Port Number. It tells the
	program which of the DigiBoard Communications ports to use.

9)      This is where you will place your registration number you
	receive from CalypsoWare upon registering OCD.

10)     This is where you will define the BBS system you are running OCD on.
	Current options are:
		WILDCAT!    For sysops running WILDCAT! systems.
		GAP         For sysops running GAP systems
		DOORSYS     For all other BBSes

11)     This is your ABS id.  You will receive this number either from
	CalypsoWare or American Banking Systems, depending on how you
	register your system.

12)     This line defines who the drafts will be made payable.  This not
	only shows up on the online check, but will also appear on the drafts
	generated by American Banking Systems(tm).

13)     This line defines what the memo line on the draft generated by American
	Banking Systems(tm) will read.

14)     This is name of the batch file that COLLECT will launch to deliver
	the payment information to American Banking Systems(tm) for processing.
	We have included a sample batch file and script (for Telemate) that
	you may be able to use with minimal modification.

Ŀ
  Operation         


   Setup
   
	To run OCD door, you will need to create a batch file that will
launch the door.  For example:
		@echo off
		d:
		cd \OCD
		OCD OCD.CNF
will work with most BBSes.  Some others require that you call the BBS
software at the end of a door batch file.   Check with your BBS
documentation.

MULTI-NODE BBS NOTE:
	OCD will run on multiple node setups, but you must either create
a seperate configuration file for each node or use environmental variables
(as described above) to define the directory where the OCD door can find
the DOOR.SYS file.

Ŀ
  Support           


	OCD is fully supported by CalypsoWare.  We can be reached in the
following manners:
	1) Internet: ocd.support@calypso.com

	2) Calypso Online Systems BBS (714) 366-1355

	3) Voice Support (714) 366-1350

	4) Fax (714) 366-1390
Ŀ
  Legal Disclaimer  

(small print on<g>)
	As with any program, every attempt is made by the programmer to
kill all the bugs in the software before it is release to the public.
Since this is all but impossible, it is recommended that new software
should only be run (for the first time at least) when a current backup
of your hard disk is available.  When shareware is released for public
evaluation, there is little that can be done on the programmer's end to
prevent others from infecting the program with viruses or making
unauthorized changes to the program.  AS SUCH, user agrees to hold
harmless BRETT W. MARTIN, LARRY HOOPER, MICHAEL J. GIBBS, PCCS, INC., 
CALYPSO ONLINE SERVICES, CALYPSOWARE and AMERICAN BANKING SYSTEMS(tm) in
regards to any personal, physical, emotion, financial, sexual or other
damage that may occur to hardware, software or the user that may arise
from the use of this program.  Use of this program is considered to be
acceptance of these conditions.
	This program remains the copyrighted work of CalypsoWare.  When
you register the program, you are granted a license to use this program
on one (1) BBS system, regardless of how many nodes are active.  You may
sell your registered number to another if the following conditions are met:
	1) All copies of the software and any documentation are
		transferred to the new owner.
	2) You must discontinue use of the program following the sale.
	3) The new owner must contact CalypsoWare to update our user records.

	This program may not be sold in it's unregistered form.  It is
intended to be distributed freely.  Pay BBS systems are exempt from this
requirement provided they are not charging specifically for access to
this one program.  Shareware distributors/User Groups may charge a nominal
copying/library fee not to exceed $7.00.
(small print off<g>)

Ŀ
  Special Thanks    


	Special thanks go out to:
		My (Mike's) wife Lori , my sons Bobby and Adam for tolerating
		      my weird ways.
		Brett Martin, for seeing, and believing in the vision that
		      this concept can (and will) work!
		
        My (Brett's) wife, ... ya, ya, ya, same as Mike said.
		Mike Gibbs, for his tireless efforts in seeing this inital
		release to market.
		Larry Hooper, for the money.

Ŀ
  Appendix          



   Appendix A
   
			Ŀ
			 HISTORY:  OCD 
			
Version         Date            Fixes, Changes, etc.
                 
1.0             12/07/94        First public release of door!


   Appendix B
   
	The Care, Feeding and Formatting of OCD Display Files

   OCD uses three sysop-configurable display files: WELCOME.SCR, THANKS.SCR
and GOODBYE.SCR.  These text files may be of any length, but are limited to
a line length of 66 characters.  Any characters beyond the 66 character
limit will be truncated.  The WELCOME.SCR file is shown to all users as
they enter the OCD door.  The THANKS.SCR file is shown to all users who
successfully complete the door, leaving a valid, non-zero dollar amount.
The GOODBYE.SCR is shown to any users that decide not to donate any
money within the door.


   Appendix C
   

			Running COLLECT

   The COLLECT utility is provided to facilitate the transfer of billing
information created by the OCD door.  COLLECT can be set up to run in an event
daily, weekly, monthly, or whenever.  To launch COLLECT, you would use the
following command line:
		  COLLECT OCD.CNF
where OCD.CNF is the same configuration file used by the OCD door.

   The command should be issued from the same directory that the COLLECT
and the USERS.DBF file (created by OCD) are in.

   COLLECT will pull new additions to the USERS.DBF file and add them to the
data file that will be transmitted to American Banking Systems(tm) for
processing.  The batch file that will be called by COLLECT to perform this
transfer is defined in the configuration file.  Please see the included sample
batch and script (Telemate) files for more details on the transfer.


   Appendix D
   
			    LEGAL NOTICES

OCD, CalypsoWare, Calypso Online Services are the trademarks of PCCS.
On-line Checks Direct(tm) is the trademark of American Banking Systems.
MS-DOS is the trademark of Microsoft.
DESQView is the trademark of QuarterDeck Office Systems.
GAP is the trademark of GAP Development.
WILDCAT! is the trademark of Mustang Software, Inc.
