Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1993-01-17 | 36.6 KB | 774 lines

┌┬┬┬┬┬┬┬┬┬┬┬─┐ ││││││││││││ │ ││││││││││││ │ ││││││││││││ │ ┌───────────┐ ││││││││││││ │ │ ┌────────┘ ├┴┴┴┴┴┴┴┴┴┴┤ │ │ │ ┌─────────────┐ └┬─────────┴┬┘ │ │ │ ┌───────┐ │ ┌──┴──────────┴────────┐ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └─────────┘ └───────┘ │ └──────────────────────┘ └────────────┐ ┌──────────┘ │ │ │ │ │ │ │ │ └──┘ C O M P U T E R P R O F I L E S 5012 OLDE MILL DRIVE, MARIETTA, GA, 30066 AutoScribe V 2.6 Release Version 2.6 Copyright (c) 1991-93 Gary R. Smith All Rights Reserved License to Use Agreement ─────────────────────────────────────────────────────────────────────── Computer Profiles, (herein referred to as CP), grants to the purchaser and purchaser accepts a non-transferable and nonexclusive license to use, on a single computer, the software products and accompanying materials provided to the purchaser by CP. Purchaser is hereby licensed only to read the program from its medium into the memory of a single computer solely for the purpose of executing the program. CP shall have the right to terminate this license if purchaser violates any of its provisions. Purchaser agrees that the software products and accompanying materials are the property of CP and that CP shall maintain title to and ownership of the software products at all times. Purchaser agrees to make no more than one (1) additional working copy and one (1) backup copy of the software products for their personal use only. CP makes no warranties of any kind, expressed or implied, with respect to the quality, performance, accuracy, or fitness of the software products for any particular purpose. CP assumes no responsibility for any decisions make or actions taken on the part of the purchaser because of the use of the software products. In no event shall CP, or any of its representatives, be liable for any loss of profit or any other damages, arising out of the use or inability to use this product - even if CP or an authorized agent of such has been advised of the possibility of such damages - or for any claim by any other party. CP reserves the right to make changes, enhancements and improvements to the software products at any time without notice. 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. CP shall not be liable for any damages, whether direct, indirect, special or sequential arising from a failure of this program to operate in the manner desired by the user. CP shall not be liable for any damage to data or property which may be caused directly or indirectly by the user of this program. IN NO EVENT WILL CP 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. AutoScribe is a Trademark of Computer Profiles Borland C++ is a Registered Trademark of Borland International CKIT is a Trademark of Data-Comp Information Systems PCBoard is a Registered Trademark of Clark Development Company AutoScribe 2.6 INTRODUCTION ────────────────────────────────────────────────────────────────────────── ORDERING INSTRUCTIONS may be found in the register.doc file. Features of AutoScribe: o User friendly interfaces for both the SYSOP and the USER! o Auto-Registration (Instantly!) for PCBoard 14.5+ systems! (Other BBS Systems may use the Credit Card Features!) o Supports up to 50 different subscription levels o Configurable to accept Visa! MasterCard! or American Express! and many more popular credit cards! o Instantly verifies different card types! o Sysop defined registration levels, costs, tax, and handling charges (Percentage or Fixed rate for handling)! 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 Written completely in Borland C++! o NEW ASM (AutoScribe System Manager) program to facilitate writing the configuraton file. o NEW @CODE Support. Now you can truely create your own receipts and invoices! o NEW toggle to turn on dots to hide the credit card number from onlookers. o NEW Code added to format the credit card numbers when written to the file. o NEW improved credit card verification routines! o NEW PURCHASE.(Node Number) file written to disk for sysop to inform them of a completed purchase. AutoScribe 2.6 INTRODUCTION ────────────────────────────────────────────────────────────────────────── Upgrading Information When you purchase AutoScribe you will receive a registration number that will remove all restrictions from the version you are using. There are no time restrictions placed on a particular version of AutoScribe.(ie. No yearly fees. You own this version) Bug fixes and ammendments are free and may be downloaded from the support bbs. (Upgrades may be charged a reasonable fee. The author of the software will reserve the right to charge for any upgrades that he feels necessary to cover the extra hours included in new versions. (This does not include bug fixes...New Versions only) AutoScribe 2.6 GETTING STARTED ────────────────────────────────────────────────────────────────────────── AutoScribe Setting Up For those of you who have never setup doorware for Bulletin Board Systems before, you will be walked through some of the most basic procedures to ensure that you setup your copy of AutoScribe properly the first time with minimum work and time. For those of you who are experienced please bear with us. Creating a AutoScribe must have its own directory to run from. directory Create a directory from which you wish to run the program from. This name may be any name as long as it conforms to DOS standards. We suggest running it from a sub directory like the following example. C:\PCB\DOORS\ASCRIBE We will use the above example for the remainder of this setup session. Create the directory by moving to your bbs directory PCB\DOORS and type MD ASCRIBE Copy the You now must copy the files from your distribution disk or files shareware zip file to the newly created directory. Example. Copy ASxx.ZIP C:\PCB\DOORS\ASCRIBE Your ASxx.zip file will now be located in the directory in which you created for AutoScribe (tm). Unpacking If you received your version of AutoScribe from a Bulletin the files Board you will have to have a copy of PKUNZIP in your path. Once you are in your AutoScribe directory type the following (Where xx is the version number of the copy you received). Example. PKUNZIP ASxx.ZIP Construct To run AutoScribe from most bulletin boards you will a batch file need to construct a batch file that your Bulletin Board Software will use to call the AutoScribe program. If you are running multinodes of AutoScribe you will want to make use of environment variables provided by your software. AutoScribe 2.6 GETTING STARTED ────────────────────────────────────────────────────────────────────────── By creating this batch file you are configuring it so AutoScribe will run for that node. Each batch file you create should be like the following example. (Assuming we are configuring for a single Node) (The Users file in line 3 is only for PCBoard 14.5+ systems) AS - (PCBoard Version) Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\AS Line 3 AS AS.CNF C:\PCB\PCBOARD.SYS C:\PCB\MAIN\USERS Line 4 CD C:\PCB Line 5 BOARD AS - (PCBoard Multinode Version) Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\AS Line 3 AS.EXE AS.CNF %PCBDRIVE%PCBDIR%\PCBOARD.SYS C:\PCB\USERS Line 4 CD %PCBDIR% Line 5 BOARD AS - (Other BBS Version) Line 1 @ECHO OFF Line 2 CD C:\BBS\DOORS\AS Line 3 AS AS.CNF DOOR.SYS Line 4 CD C:\BBS Line 5 BBS COMMAND Meanings: Line 1 Turns off the Local Screen Echo (DOS 3.3 and up) Line 2 Changes the directory to where AutoScribe is stored Line 3 (1) AutoScribe Executable Statement (2) The complete path to that nodes PCBoard.sys, DOOR.sys, Generic.sys file (3) If you are using a PCBoard 14.5 system and you have AutoRegistration turned on in the config file, you must put the path to your users file here. (ALL other type bbs's leave blank) Line 4 Changes the directory back to the PCB directory Line 5 Calls the PCBoard program / or your bbs program NOTE: Your AutoScribe 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. This file is to be placed in the PCBoard or BBS directory. AutoScribe 2.6 GETTING STARTED ────────────────────────────────────────────────────────────────────────── Adding to The next step to setup AutoScribe is to add it to your BBS Doors Bulletin Boards Doors file. If you use PCBoard this is file done through the PCBoard SETUP program. All that needs to be done once you are in 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. If you prefer to use the door.sys information make sure you select to create a door.sys file. You should use PCBOARD.SYS if you intend to use instant registration. This completes the basic setup of AutoScribe. Please read further to configure AutoScribe to run with your database and software. EDITING/ The AS.DAT file contains the data about your registration CREATING THE process. The data in this file MUST conform to the AS.DAT FILE standards setforth in this document. Each subscription level in the file consists of TWO lines of Data Line 1 is a 50 character limited line that is a description of the registration level the user will purchase such as the following example. (Design your own if you like!) ex. "60 Mins a Day 4 Months 1000K Daily D/L Limit" |----------------- 50 Characters---------------| Line 2 consists of three (3) parts ex. 20.00,120,35 (This example depicts a $20.00 charge for 4 months and the user receives a security level of 35) Part 1 - Price, The cost of the subscription is placed here followed by a comma. Part 2 - Days, The length of the subscription is placed here, such as 120 = 4 months, 60 = two months etc. If a zero (0) is placed here the users expire date will be set to indefinte. (Useful for lifetime memberships.) Part 3 - Security Level, The security level the user will receive is placed here. ENSURE that any security level you put here is also noted by PCBoard. If Not you will get the error "NO SECURITY LEVEL MATCH IN PASSWRD FILE". AutoScribe 2.6 GETTING STARTED ────────────────────────────────────────────────────────────────────────── Your final lines should resemble the following: 60 Mins a Day 4 Months 1000K Daily D/L Limit 20.00,120,35 Without skipping a line you can place your next line of descriptions up to 15. (Unregistered versions will only utilize the first line). ex. 60 Mins a Day 4 Months 1000K Daily D/L Limit 20.00,120,35 120 Mins a Day 12 Months 2000K Daily D/L Limit 60.00,365,55 This file is located in the AutoScribe directory. * if you are using the option to display your own subscription data, ensure that your dat file matches your subscription file! * EDITING Before beginning your session you should edit your versions INVOICES of the INVOICES.TXT and RECEIPT.TXT files provided. (Or you RECEIPT can rename this files) The Receipt.txt file is the file that is read in and then written back out as the receipt that is displayed to the user. The same happens for the invoice.txt file except that it is actually written to the disk and maintained as the sysops invoice. (If you selected to combine the invoices these invoices will be contained in INVOICES. @@@). The @ Codes at the end of this documentation can be used to tailor the invoices and receipts exactly as you would like them. Ours are only provided as examples. DETAILED If you intend to use the detail subscrition file you will need SUBSCRIPT to create or edit the SUBDAT file. This filename can be any LISTING valid filename and is placed in the block labeled "Data File Name" under the Configuration File Information area. This file is a detailed listing of your subscription levels. If you have a graphics version append a "G" to the filename. For a detailed example look at the files SUBDAT AND SUBDATG that came along with your AS ZIP file. AutoScribe 2.6 AUTOSCRIBE SYSTEM MANAGER ────────────────────────────────────────────────────────────────────────── You are now ready to utilize the configuration program (ASM.EXE). This program will assist you in setting up your configuration file (AS.CNF). It is advised that you use the configuration program to edit the AS.CNF file to avoid any problems with incorrect configu- rations. NOTE: IF YOU ARE USING MORE THAN ONE CONFIGURATION FILE FOR DIFFERENT TYPES OF REGISTRATION, RENAME THAT CONFIG FILE TO AS.CNF AND USE THE ASM PROGRAM TO EDIT IT. (ASM WILL ONLY EDIT AS.CNF) The ASM file must be run in the home directory where the AutoScribe program is found. If not you will recreate the AS.CNF file that runs AutoScribe. To begin type ASM from the command line. MAIN MENU (Type F1 for context sensitive help) CONFIGURATION Highlight this option and press enter. This is the first INFORMATION part of the configuration file. If you have not run ASM you will see the default entries. Change these to suit your system. BBS Software Type - Place the code for the type of BBS software you are running in this place. A listing of the codes follows and may also be reviewed by pressing F1 when this item is highlighted. PCB145 RBBS SPITFIRE TRITEL PCBOARD QBBS GAP OTHER WILDCAT TBBS RA If you run PCBoard 14.5+ enter PCB145 else enter PCBOARD BBS Name - Place the name of your Bulletin Board System on this line. You have a maximum of 50 characters. (This should match your registration Bulletin Board Name exactly, If not, contact the support board for new registration information). AutoScribe 2.6 AUTOSCRIBE SYSTEM MANAGER ────────────────────────────────────────────────────────────────────────── Registration Number - Place the registration number you received from CP or the support board on this line. If you have not registered your version of AutoScribe, Place 00000 on this line or leave the default. Warning File Name - This line contains either a "Y" to utilize the built in warning file, a "N" to show no warning file or a filename of the warning file you may have designed for use with your system. If you have an ansi version of the warning file append a "G" to the filename. (DO NOT add this "G" on this line. This line is for the non-color version only.) Logoff File Name - This line will contain an "N" if you do not wish to show a logoff screen, or the filename of a logoff screen you wish to display to the user prior to sending that user back to the board. Data File Name - If you would like to show the user a more detailed listing of your subscription levels, you should create a file which describes your levels and place its filename in this block. (SUBDAT is provided as an example file). If you do not desire to show detailed listings then Autoscribe will show the short listings only if you place a "N" on this line. Append a "G" to the graphic version filename. Auto Registration - If you run a PCBoard 14.5+ system and want auto registration done then place a "Y" in this block. If you do not wish for auto registration (Security Level and Adjusted Expire Date) then place a "N" in this block. NOTE: ALL OTHER BBS TYPES place a "N" here since there is currently no support for auto registration of other board types. Update by - This line indicates whether you want AS to use the current Expiration Date/Todays Date/or to ASK the user to calculate the new expiration date. If the you use the EXPIRE date it is calculated as follows. If the Ex date is less than todays date, Todays date is used, If the Ex date is later than todays date then the EX date is used. Place one of the following codes in this block: TODAY - Use todays date EXPIRE - Use current expiration date based on todays date ASK - Ask the user if this is a new subscription (If so then the date is calculated from todays date, else the expire date is used) AutoScribe 2.6 AUTOSCRIBE SYSTEM MANAGER ────────────────────────────────────────────────────────────────────────── FINANCIAL Highlight this option and press enter. This is where the INFORMATION financial information is edited from. If you have not run ASM you will see the default entries. Change these to suit your system. Credit Cards - The first 7 blocks must contain a "Y" or "N" to indicate whether or not you support those types of credit cards. The defaults are all "N" By indicating here that you accept the cards, The users will be displayed this listing once inside the purchasing portion of AutoScribe. Using the arrow keys move up and down the listing of credit cards that may be automatically verified by AutoScribe. Place a "Y" or "N" on each line to designate valid cards. Once you have entered either yes or no for each card press F10 to save your entries. There is extensive card checking incorporated within AutoScribe to validate credit cards. We cannot however guarantee that the user is not using a card that is over the credit limit/stolen etc. All cards are checked using a modulus math routine, length and validation numbers. NOTE: PRESSING 'ESC' WILL ABORT ANY ENTRY. PRESSING 'F10' WILL SAVE THE EDITED ENTRIES. Card Processor - Place the name of your card processor on this line. (This is the name of the company's name that appears on the users credit card statement) Tax Percentage - Place the percentage of tax that your State/Province charges. If no tax is ever to be charged for the products you offer then place .00 (Default) in this field, else place the appropriate amount here. (This is a calculated percentage) Handling Percentage - If you are using a percentage for handling your value must be less than 1, example: if you want to charge 2 percent you would place a .02 on this line. If you want to charge a set rate your value will be over 1. example: to charge 2 dollars each time place a 2.0 here. AutoScribe 2.6 AUTOSCRIBE SYSTEM MANAGER ────────────────────────────────────────────────────────────────────────── State to Charge Tax - The two (2) letter state designator for your state should be placed on this line if your state requires that you charge sales tax. The following other codes may be substituted to personalize your system regardless of what country you are in. ALL - Charge all users tax regardless of state/ province. By placing the word ALL on this line, everyone that subscribes will be charged tax. This could be used if the country charges a luxury tax on all services and does not charge different provinces different amounts. No - Charge no user regardless of state/ province any tax. This will cause all users regardless of where they are from to be charged no tax. Two character state - If AutoScribe finds a two letter state code here and it matches with the users indicated home state then that user alone will be charged tax. If the two states do not match then that user is not charged tax. In most cases you will place your state letter designator here since most states charge sales tax. NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING 'F10' WILL SAVE THE ENTRIES TO DISK. MISCELLANEOUS Highlight this option and press enter. This section is DATA where you will edit all miscellaneous data items required to run AutoScribe. Receipt filename (Input) - This is the name of the file that will be presented to your users as a receipt. Using the all new @CODES@ you can produce your very own personalized receipts for your users. The @CODES available are listed later in this document. (RECEIPT.TXT is an example file). Invoice filename (Input) - Like the receipt file, this file also uses the @CODES. You can design your own invoices with any information/logos etc that you desire. (INVOICE. TXT is an example invoice file). Combine invoices - Placing a "Y" will allow all invoices to be appended to each other thus producing one file with the filename of INVOICES.@@@. AutoScribe 2.6 AUTOSCRIBE SYSTEM MANAGER ────────────────────────────────────────────────────────────────────────── If you elect to have seperate files for each invoice, Your invoice files are created with the title of # and a suffix of .INV, for example, your 21st order will be labeled "21.INV" and will be in your AutoScribe directory. These files are written in a numerical sequence. If you wish to start with a higher number, edit the AS.CNT file with an ascii editor and place the number you wish to begin with inside of this file. (It must be a numeric input) To begin either file over, you can delete the INVOICES.TXT file or the AS.CNT file. Both files if not found are recreated. It is not within the scope of this document to describe procedures for processing your invoices. Your credit card merchant should provide this information for you. Enter Card number twice - NOT IMPLEMENTED Turn dots on (Card Input) - When the user enters their credit card number you may either show them dots only by placing a "Y" on this line, or show thier numbers as they type them in by placing a "N" on this line. Zero out up/dn loads - NOT IMPLEMENTED IMPORTANT ITEMS FOR SYSOPS TRASHCAN FILE The trashcan file is a listing of ALL credit card numbers that you do not wish to have access to your products. If a credit card number is placed in this file then the user of that card will be informed that their information is invalid and it will be reported. This file has a format of one number per line. There should be NO spaces or other characters between the numbers. ex. 1234567812345678 The file name of this file is TRASHCAN and cannot be changed. It is a text file, so you may use your favorite text editor to edit the file. the file MUST exist. BADCARD.DAT FILE To help you track all bad card usage, any cards that are not accepted will be written to the BADCARD.DAT file. This is a log file that if not found will be created. It is a listing of Times:Dates:Persons Name and Card Number Attempted to be used. PURCHASE FILE A file by the name of PURCHASE.(NODE NUMBER) is produced and placed in the AS directory each time a user conducts a purchase. This file may be used by the sysop in conjunction with TXT-TO-MSG to leave a message to the sysop that a purchase has occured. It is up to the sysop to delete this file when completed with it. COMMUNICATION PARAMETERS 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 fourth parameter as long as it is the LAST parameter passed. PORT is optional, and AutoScribe will default to standard addresses and irqs if it not used based on the port number read from the BBS file. AutoScribe 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. AutoScribe will also support the use of FOSSIL drivers. The syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells AutoScribe 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 AutoScribe to use a fossil driver for port 1. Digiboard Intelligent Async boards are supported thru the Universal DOS driver for Digiboard. The syntax is the same as the Fossil driver except you replace the F with D and give the channel number to use. Example - PORT:D:6 tells AutoScribe that it is connected to a Digiboard and to use channel 6 on the Digiboard. Your program's cmd line for the above could be any one of the following: AS AS.CNF door.sys ;Using standard ports AS AS.CNF door.sys PORT:03E8:5 ;Using non-standard port AS AS.CNF door.sys PORT:D:5 ;Using Digiboard channel 5 AutoScribe also supports IRQ's 8-15. RUNNING AutoScribe When you first run AutoScribe a 2 functions occur. 1. Your AutoScribe Users file will be created. This is the database file that holds your users information. CREDIT CARD information is NOT stored within any AutoScribe file with the exception of your invoice file. (XX.INV/INVOICES.@@@) 2. The Invoice Counter file is created. Each time a user agree's to purchase a subscription an invoice file is created. 3. Next the door begins . First is the opening screen. Then the warning screen, then on to the first look at your subscriptions you have available. (Unregistered Versions will only show 1 subscription available) 4. The user is then asked to enter thier credit card number if they decide to continue. They may abort at any time. Note: If a user has previously filled in the data this information will be re-displayed to the user. A database of user information is kept in the file AS.USR. 5. The Credit Card is checked for validity. If it is valid and you indicated in the config file that you support the card the user will be asked to fill in each of the questions for the database. (If the card is not supported the user is shown a screen informing him of the error) Cards that are supported are listed above the line where the user types in the number. All numbers are redisplayed as dots and are NEVER visible to the screen. (This is for user protection, and a confidence check) 6. Once the user passes the validity check they are once again presented with the options screen. The user selects by number the subscription level they wish to purchase. They are asked to confirm this selection before the information is written to disk. 7. Upon confirmation the user is shown a screen (Receipt) indicating the amount of sale and the option the user selected is displayed. (This screen may be SCREEN CAPTURED for a receipt) 8. After reading the receipt the user (If you have selected auto-registration and your running PCB14.5+) will be automatically upgraded. The only upgrades available at the present time are Security Level and Expiration Date. 9. The user is then presented with the exiting screen and are passed back to the Main Board or BBS system. @CODES AVAILABLE FOR RECEIPTS AND INVOICES @BBSFNAME@ USER BBS FULL NAME @BOARD@ BOARD NAME @DATE@ DATE IN MMDDYY FORMAT @TIME@ TIME IN HHMMSS FORMAT @SUBTXT@ SUBSCRIPTION TEXT (1 LINE) @SUBPRICE@ SUBSCRIPTION PRICE @HANDLING@ HANDLING CHARGE @TAX@ TAX CHARGE @TOTAL@ TOTAL CHARGE (SUBPRICE + HANDLING + TAX) @CARDTYPE@ TYPE OF CREDIT CARD (VERBOSE) @NEWEXPIRE@ USERS NEW EXPIRATION DATE (YYMMDD FORMAT) @CCNAME@ CREDIT CARD OWNERS NAME @STREET@ CREDIT CARD MAILING ADDRESS @CITY@ CREDIT CARD MAILING CITY @STATE@ CREDIT CARD MAILING STATE @ZIP@ CREDIT CARD MAILING ZIPCODE @HPHONE@ CREDIT CARD OWNERS HOME PHONE @WPHONE@ CREDIT CARD OWNERS WORK PHONE @PROCESSOR@ CREDIT CARD BILLING NAME @CARDNUMBER@ CREDIT CARD NUMBER @CCEXPIRE@ CREDIT CARD EXPIRATION DATE @TAXSTATE@ STATE TO CHARGE TAX @SECURITYLV@ USERS NEW SECURITY LEVEL @INV_NUM@ INVOICE NUMBER