旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � 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) 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) 旼컴컴컴컴컴컴컴컴컴커 � 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.