Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / USA11.ZIP / USA.DOC < prev next >

Wrap

Text File | 1992-01-05 | 10.5 KB | 272 lines

USA DOOR V.1.0 Release Version 1.0 Copyright (c) 1991 Gary R. Smith All Rights Reserved DISCLAIMER There is made no warranty of any kind, express or implied, including without limitation, any warranties of merchantability and/or fitness for a particular purpose. I shall not be liable for any damages, whether direct, indirect, special or on sequential arising from a failure of this program to operate in the manner desired by the user. I shall not be liable for any damage to data or property which may be caused directly or indirectly by the use of this program. IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. If you would like to keep the latest version of the USA DOOR on your system, you can download the latest version from one of our Support Boards or your favorite Quality BBS System. Random Access, (Computer Profile's Support Board) Marietta, Georgia (404) 516-7150 (14.4 HST) What it does - The USA door will allow your users to view the USA TODAY news online. This door breaks the newspaper down into a systematic way so that it easier to get to each section of the paper. The USA DOOR gives your board a look and feel of excellence and sophistication. Give it a try and see it doesnt make your reading of the morning paper that much easier and enjoyable. ------- Required for operation (USATODAY.ZIP) Features of USA Door: o Works with most door formats including PCBoard.sys, Door.sys sfdoors.dat etc... o Displays in color / non - color modes! o Detects Loss of carrier! o Can operate at speeds in excess of 115000 Baud! o Will automatically log user off after 3 minutes of no keyboard activity! o Can be operated on a Multi-Networked Board! o Written completely in Borland C++! Getting Started: Setting up USA is a very simple process. If you have set up other doors then you will have no problems. Computer Profile doors follow the system standards as setforth by PCBoard. STEP BY STEP ------------ SETTING IT UP - (This example sets up a Single Node PCBoard 14.5 setup. If you are running a different type of BBS software, set the door up according to your BBS specifications. It should be very similiar to this example) /*------------------------------------------------------------------------ Step 1: (Creating a directory) Create a directory from which USA will run from. This Directory can be called anything you wish that is within the DOS 8 character limit. (This document will assume you have selected C:\PCB\DOORS\USA for the remainder of the examples). /*------------------------------------------------------------------------ Step 2: (Copy the files) Copy or UNZIP all the USA files into the directory you just created above. ex. COPY USA1.ZIP C:\PCB\DOORS\USA PKUNZIP USA1.ZIP /*------------------------------------------------------------------------ Step 3: (Create the Configuration file, USA.CNF) Create the USA configuration file. This file will contain all the external data that USA will use. Using your ascii editor you will create a text file called "USA.CNF". The name cannot be changed and it MUST be placed in your USA Directory. If this file is not found a message is written to the screen and the program is exited. The below is a Description of each line required Example - (USA.CNF) Line 1 Random Access ( Bulletin Board Name) Line 2 99999 ( Registration Number) /*------------------------------------------------------------------------- STEP 4: (Construct the batch file) You now need to construct the batch file that PCBoard will use to call the USA program. If your running multi-node you may want to use the PCBoard enviornment variables provided by pcboard 14.5+. By creating this batch file you are configuring it so USA will run for that node. Each batch file you create should be like the following example. (Assuming we are configuring for a single Node) USA - (PCBoard Version) Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\USA Line 3 USA C:\PCB\PCBOARD.SYS Line 4 CD C:\PCB Line 5 BOARD USA - (PCBoard Multinode Version) Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\USA Line 3 USA.EXE %PCBDRIVE%PCBDIR%\PCBOARD.SYS Line 4 CD %PCBDIR% Line 5 BOARD USA - (Other BBS Version) Line 1 @ECHO OFF Line 2 CD C:\BBSDIR\DOORS\USA Line 3 USA C:\BBSDIR\DOOR.SYS Line 4 CD C:\BBSDIR Line 5 BBS COMMAND Line 1 Turns off the Local Screen Echo (DOS 3.3 and up) Line 2 Changes the directory to where USA is stored Line 3 (1) USA Executable Statement (2) The complete path to that nodes PCBoard.sys, DOOR.sys, Generic.sys file Line 4 Changes the directory back to the BBS directory Line 5 Calls the PCBoard program / or your bbs program NOTE: Your USA batch file should be similar to the example above, Line 3 however, Must contain the path to the pcboard.sys or door.sys type file. * IMPORTANT * This file is to be placed in the PCBoard or BBS directory. /*------------------------------------------------------------------------ STEP 6: (Adding USA to the Doors File) The next step to setting up is to add USA to your PCBoard Doors file. This is done through the PCBoard setup program. All you need to do once you are in the PCBSETUP editor for doors is place the name of the batch file you just created above in a slot for a door, give it a minimum security level and your all done. /*------------------------------------------------------------------------ STEP 7: (Utilizing the USA Today Zip files) In order for USA to run properly it must be able to find the USA Today files. You should do something like the following...This is a part of an automated batch file. cd c:\uploads pkunzip -o USATODAY.ZIP C:\PCB\DOORS\USA del usatoday.zip . . continue with batch files. You should always use the -O option of pkunzip. This will over write all the old USA Today files already in your USA directory. ** ALL USATODAY FILES MUST BE IN YOUR USA DIRECTORY IN ORDER FOR USA TO WORK PROPERLY. /*------------------------------------------------------------------------ RUNNING USA Just type USA from the command line and your off and running. There is nothing hard about this door, and it will run with all bbs types. /*------------------------------------------------------------------------ For those of you that understand Ports and IRQ settings! NOTE: If you need to specify a non-standard port address and IRQ, then the syntax is PORT:AAAA:X where AAAA is the base address and X is the IRQ. It doesn't matter whether PORT:AAAA:X is the third or foruth parameter as long as it is the LAST parameter passed. PORT is optional, and USA will default to standard addresses and irqs if it not used based on the port number read from the BBS file. USA will assume COM1 = 03F8 IRQ 4, COM2 = 02E8 IRQ3, COM3 = 03E8 IRQ4 and COM4 = 02E8 IRQ 3. If you have a different non-standard port address and irq, you could then use the PORT cmd to change the defaults. USA will also support the use of FOSSIL drivers. The syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells USA to use a Fossil driver for it's communications. The 'P' following it tells it which port to use for the Fossil. Example - PORT:F:1, tells USA to use a fossil driver for port 1. ----------------------------------------------------------------------------- The USA DOOR is Shareware. You are granted a TWO week trial period in which you may evaluate USA. If you continue to utilize this product you are required to register it with the author. If you do not register USA within the required time frame allowed, You are REQUIRED to remove it from your board in accordance with the United States Copyright Laws governing the use of Pirated Software. If you register your copy of USA, you will receive a registration Number to place in your USA.CNF FILE. This number can be mailed to you, or for faster use you can call our support board and download it. (See the registration file for more information.) We accept MasterCard/Visa Registrations. See the REGISTER.DOC file for mail in's or call our Support BBS and register online for immediate satisfaction. To register your copy of USA, Fill out the form Register.doc and mail it along with $12.00 (U.S. FUNDS) to : Gary R. Smith 5012 Olde Mill Drive Marietta, Georgia, 30066 Make all checks payable to "Gary R. Smith" All checks must be drawn from U.S. Banks...No foreign currency will be accepted. (This includes Canadian) Please include in the Registration form, exactly how you would like your BBS name to appear on the Closing Screen.