Monster Media 1994 #1

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

/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / EAGLE103.ZIP / EA103.ZIP / EAGLE.DOC < prev next >

Wrap

Text File | 1994-03-20 | 24KB | 507 lines

Eagle Enterprises BBS Subscription Service License to Use Agreement ─────────────────────────────────────────────────────────────────────── Eagle Enterprises (herein referred to as EE), 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 EE. 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. EE 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 EE and that EE 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. EE 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. EE 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 EE, 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 EE or an authorized agent of such has been advised of the possibility of such damages - or for any claim by any other party. EE 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. EE 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. EE 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 EE 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. Eagle is copyrighted by Computer Profiles (C) 1993 EAGLE ────────────────────────────────────────────────────────────────────────── EAGLE 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 EAGLE properly the first time with minimum work and time. For those of you who are experienced please bear with us. Creating a EAGLE 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\EAGLE 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 EAGLE Copy the You now must copy the files from your distribution disk or files shareware zip file to the newly created directory. Example. Copy EAGLExx.ZIP C:\PCB\DOORS\EAGLE Your EAGLExx.zip file will now be located in the directory in which you created for EAGLE. Unpacking If you received your version of EAGLE from a Bulletin the files Board you will have to have a copy of PKUNZIP in your path. Once you are in your EAGLE directory type the following (Where xx is the version number of the copy you received). Example. PKUNZIP EAGLExx.ZIP Construct To run EAGLE 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 EAGLE program. If you are running multinodes of EAGLE you will want to make use of environment variables provided by your software. EAGLE ────────────────────────────────────────────────────────────────────────── By creating this batch file you are configuring it so EAGLE 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) EAGLE - (PCBoard Version) Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\EAGLE Line 3 EAGLE EAGLE.CNF C:\PCB\PCBOARD.SYS C:\PCB\MAIN\USERS Line 4 CD C:\PCB Line 5 BOARD EAGLE - (PCBoard Multinode Version) Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\EAGLE Line 3 EAGLE.EXE EAGLE.CNF %PCBDRIVE%PCBDIR%\PCBOARD.SYS C:\PCB\USERS Line 4 CD %PCBDIR% Line 5 BOARD EAGLE - (Other BBS Version) Line 1 @ECHO OFF Line 2 CD C:\BBS\DOORS\EAGLE Line 3 EAGLE EAGLE.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 EAGLE is stored Line 3 (1) EAGLE 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 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 BBS directory Line 5 Calls the BBS program NOTE: Your EAGLE 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. EAGLE ────────────────────────────────────────────────────────────────────────── Adding to The next step to setup EAGLE 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. (DO NOT SHELL OUT TO THE EAGLE DOOR!) 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 EAGLE. Please read further to configure EAGLE to run with your database and software. You are now ready to utilize the configuration program (CONFIG.EXE). This program will assist you in setting up your configuration file (EAGLE.CNF). The CONFIG file must be run in the home directory where the EAGLE program is found. If not you will recreate the EAGLE.CNF file that runs EAGLE. To begin type CONFIG 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 CONFIG you will see the default entries. Change these to suit your system. 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 EAGLE ENTERPRISES for new registration information). 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. PCBOARD WILDCAT OTHER EAGLE ────────────────────────────────────────────────────────────────────────── Registration Number - Place the registration number you received from EE or the support board on this line. If you have not registered your version of EAGLE, Place 00000 on this line or leave the default. Account Number - This is the account number assigned to you from EAGLE ENTERPRISES. Without this account number your purchases cannot be tracked. Contact Eagle Enterprises for your personal account number. Auto Registration - If you run a PCBoard or WILDCAT 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. (WILDCAT only updates SECURITY LEVEL at this time) NOTE: ALL OTHER BBS TYPES place a "N" here since there is currently no support for auto registration of other board types. Show Shareware Menu - If you will be creating and using a database of shareware items to sell, enter a "Y" here and the users will be allowed to view that database. Entering a "N" will not show the item on the main menu. PRESS F10 to save the configuration ESC to abort... FINANCIAL Highlight this option and press enter. This is where the INFORMATION financial information is edited from. If you have not run CONFIG you will see the default entries. Change these to suit your system. 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 and is applied to SHAREWARE ONLY...SERVICES ARE NOT TAXABLE) 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. (This is a calculated percentage and is applied to SHAREWARE ONLY.) 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. NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING 'F10' WILL SAVE THE ENTRIES TO DISK. PATHS AND FILE Highlight and press enter. This is the area that you will NAMES define the paths and file names required for proper operation. PATH WHERE ENCRYPTED INVOICES SHOULD BE LOCATED - Eagle creates a encrypted invoice that is passed to Eagle enterprises. Enter the FULL PATH to the location that you want EAGLE to write these files. LOGOFF PATH/FILE NAME - This is the FULL PATH/NAME of the file that should be shown to users when logging off from the EAGLE door. PATH/NAME OF DOWNLOADABLE REGISTRATION FILE - This is the FULL PATH/NAME of your Text/ZIP registration file. EAGLE allows your users to download your registration text file in the event they do not want to register via credit card. PATH TO USERINFO.DAT FILE - WILDCAT! USERS ONLY! - This is the PATH minus the node number where WILDCAT! writes the userinfo.dat file. Normally this is C:\WC30\WCWORK\ NODE (Remember do not put the node number here, EAGLE will append the number when the door is run). NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING 'F10' WILL SAVE THE ENTRIES TO DISK. SUBSCRIPTION Eagle maintains TWO databases. One for Subscriptions and MAINTENANCE one for Shareware items. Highlight this option to edit the subscription database. Security Level - Enter the Security level for this subscription. Expired Security Level - Enter this subscriptions expired security level. This is the level that is assigned after the users registration date has passed. (Each subscription level may have a different expired level). Number of Days - Enter the number of days that this level is good for. (ie..1 year would be 365 days, 6 months would be 183 etc...) Entering a 0 here will set the users expire date to 00/00/00 which means the user has no expiration date. (Good for lifetime memberships etc..) Time Per Session - Minutes - Enter the time in minutes that the user receives for this level. (WILDCAT ONLY) In order to upgrade the users time instantly online you need to put the amount of time the user will receive for this level here. Upon exiting the door, Wildcat will assign the user this amount of time. (NOTE: PCBoard takes care of this automatically once the security level has been changed. Subscription Cost - Enter the amount in dollars (Excluding the $ sign) that the subscription/software cost is. (This is UNIT cost and does not contain Tax / Handling costs.) Update Expire by (0, 1, 2) - The ways the days are applied to the user is discussed below: Enter a; 0) Enter a 0 will add the number of days for this subscription to TODAYS date. 1) Entering a 1 will add the number of days for this subscription to the users current expiration date. 2) Enter a 2 will apply dates in accordance with the users REGISTERED field in the users information. If the user was previously registered and a "Y" is found in the users REGISTERED field then the number of days for this subscription will be added to the users Expiration date. If there is a "N" or blank found then the number of days will be added to todays date. (NOTE: If any other number besides a 0,1,or 2 is found, the default is 0) 1) 2) 3) 4) - The next four lines are for the description of the subscription level. NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING 'F10' WILL SAVE THE ENTRIES TO DISK. USE F1 FOR HELP SHAREWARE Press and edit these items if you will be offering MAINTENANCE shareware to your users. Item Name - Enter the items name here, This is only used for indexing purposes by EAGLE, however it is mandatory that you enter a name. Item Cost - Enter the cost of the item. 1) 2) 3) 4) - The next four lines are for the description of the shareware / software. NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING 'F10' WILL SAVE THE ENTRIES TO DISK. USE F1 FOR HELP TRANSFER EAGLE allows you to define the protocols that users will PROTOCOLS use to download thier invoices or your registration file with. Highlight and press enter to edit these options. (NOTE YOU MUST ALSO ENTER THE BATCH FILES) Eagle allows you to enter protocol names and letters that are configurable by you. You are allowed up to five seperate protocols. Each protocol MUST have a different letter assigned. Eagle will look for that Protocols batch file by appending the letter to E, so if you entered ZMODEM for the protocol name and Z for the protocol letter, Eagle would search for a batch file name EZ.BAT. USER Eagle keeps a database of all users that have entered the MAINTENANCE EAGLE door. This information may be edited by the sysop. Full Name (BBS User) - This is the FULL NAME that the user has logged on to the BBS with. (PCBoard/WC identifies the user by this name) Credit Card Name - This is name that appears on the users credit card. (For validation purposes) Street Address - Address to where the users credit card statements are sent. (Or users home) City/Province - Users city of residence. State/Country - Users state or country code. (Must be 2 characters to work with TAX information). Zipcode/Postal Code - Users zip or postal code. Home phone number - Home phone number of user. Work phone number - Work phone number of user. Is user registered - If the user is a registered member a "Y" should be entered here. Eagle uses this field if you selected to update by number 2 in the subscriptions section. EXIT This item will exit the config program. PROGRAM 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 in the default directory. 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 EAGLE will default to standard addresses and irqs if it not used based on the port number read from the BBS file. EAGLE 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. EAGLE will also support the use of FOSSIL drivers. The syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells EAGLE 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 EAGLE 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 EAGLE 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: EAGLE EAGLE.CNF door.sys ;Using standard ports EAGLE EAGLE.CNF door.sys PORT:03E8:5 ;Using non-standard port EAGLE EAGLE.CNF door.sys PORT:D:5 ;Using Digiboard channel 5 EAGLE also supports IRQ's 8-15. END OF DOCUMENTATION.