Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1993-03-09 | 44KB | 1,065 lines

C B V ┌──────────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· Call Back Verification ·▌▌▌▌▌▌▌▌▌▌│ └──────────────────────────────────────────────┘ ---=== Release 0.97 ===--- Renegade Version Copyright 1992 Chris Holko. All Rights Reserved Worldwide. (CBV100) ┌─────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· Table of Contents ·▌▌▌▌▌▌▌▌▌▌│ └─────────────────────────────────────────┘ WARRANTY 1 ACKNOWLEDGEMENTS 1 SHAREWARE DISTRIBUTION 2 DISTRIBUTION FILE CONTENTS 3 CBV ├ Description 4 ├─ Requirements . ├── . │ ├ Support Files 5 │ ├ CBVCFG.DAT . │ ├─ CBVTRASH.DAT . │ ├── CBVAREAC.DAT 6 │ ├─── CBVCALLS.DAT . │ └──── CBVTOLLS.DAT . │ └ User Message Files 7 ├ WELCOME.CBV . ├─ PREPARE.CBV . ├── PASSWORD.CBV . ├─── NOLONGD.CBV . ├──── LOCKOUT.CBV . ├───── NOTOLLS.CBV . ├────── CANTCALL.CBV . └─────── VERIFIED.CBV . CBV INSTALLATION ├─ Files 8 ├── Command Line . └─── MENUEDIT . CBV CONFIGURATION ├ Main Menu 9 ├─ Security Validation Menu 11 ├── Modem Menu 12 ├─── Long Distance Menu 13 └──── Miscellaneous Menu 14 APPENDICES ├ A. Error Messages 16 ├─ B. Session Control 19 ├── C. Contacting the author 20 ├─── D. User Restrictions 21 ├──── E. CBVCFG.DAT layout 22 └───── F. WWIV-ANSI Colors 23 (CBV100) 1 ┌────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· WARRANTY ·▌▌▌▌▌▌▌▌▌▌│ └────────────────────────────────┘ CBV (Call-Back Verification) has NO WARRANTY. Use of CBV, and any accompanying programs/files IS AT YOUR OWN RISK. By your use of CBV you agree to hold the author and parties directly or indirectly related to the author faultless from the non-use, use, and/or misuse of CBV. CBV (CALL-BACK VERIFICATION) IS PROVIDED "AS-IS" AND WITHOUT WARRANTY, IMPLIED OR OTHERWISE. ┌────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· ACKNOWLEDGEMENTS ·▌▌▌▌▌▌▌▌▌▌│ └────────────────────────────────────────┘ References not otherwise documented. WWIV refers to World War Four Bulletin Board System CBV, RBV refers to Call Back Verification Program DOS refers to MS-DOS and/or PC-DOS Copyright, Trademark, and Servicemark notices. Renegade Copyright (c) 1991-1992 by Cott Lang WWIV Copyright (c) 1987-1992 by Wayne Bell. Turbo Pascal Copyright (c) 1982-1992 by Borland Int. (CBV100) 2 ┌──────────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· SHAREWARE DISTRIBUTION ·▌▌▌▌▌▌▌▌▌▌│ └──────────────────────────────────────────────┘ Shareware is a unique method for the marketing of computer software. Most of all the products are easily obtained from larger Bulletin Board Systems worldwide. The basis behind the workings of the Shareware system is the HONOR system. This means that the end user is free to use the product for a limited trial period to see if suits their needs. If the user continues to use the product after the trial period it is expected of them to register the product with its author with any stated fees, this is to reimburse the author for both his time spent in developing the product and to provide incentive to maintain and update the product. You are free to test and use this program, CBV, to determine if it suits your needs. If you continue to use this program beyond thirty (30) days complete the registration form (REGISTER.TXT) and mail it with the registration fee to the address listed on the form. Upon the receipt of the completed registration form and fees you will be kept advised on the status and availability of CBV, granted use of the registered version, get timely support when needed, and possible use of beta and specialized versions of CBV. (CBV100) 3 ┌──────────────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· DISTRIBUTION FILE CONTENTS ·▌▌▌▌▌▌▌▌▌▌│ └──────────────────────────────────────────────────┘ CBV is distributed as a complete package compressed into one archive file. The archive file of the UNREGISTERED version may be freely distributed so long as no charge is required to obtain the package and no modification to the distribution package is made. The naming convention the archive file is CBV?MMRT.AAA AAA = Archiving method used. MM = Major version number ie. 14 R = Revision number ie. 0 ? = BBS Package Supported W = WWIV R = Renegade T = Release Type Specifier U = UNREGISTERED R = REGISTERED DISTRIBUTION OF REGISTERED, ALPHA, OR BETA VERSIONS IS PROHIBITED. Take time to examine the contents of the archive file, you will find the following files with possibly a late text file addition. [ ] CBV .EXE - The CBV program executable [ ] CBVCFG .EXE - The CBVCFG program executable CBVCFG .DAT - Sample CBV configuration file CBVTRASH.DAT - Sample CBV phone number trash file CBVAREAC.DAT - Sample Local Area Code(s) file CBVCALLS.DAT - Sample Call-Only file CBVTOLLS.DAT - Sample TOLL number file RBV100 .DOC - This documentation HISTORY!.DOC - List of revisions made to CBV READ .ME - Last minute updates / notices - READ IT! WELCOME .CBV - Sample user welcome message LOCKOUT .CBV - Sample invalid/locked phone number message NOLONGD .CBV - Sample no long distance calls message NOTOLLS .CBV - Sample cannot call TOLL numbers message PREPARE .CBV - Sample prepare for call back message PASSWORD.CBV - Sample enter password message VERIFIED.CBV - Sample account upgraded message REGISTER.TXT - REGISTRATION FORM FOR CBV. (CBV100) 4 ┌───────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· CBV ·▌▌▌▌▌▌▌▌▌▌│ └───────────────────────────┘ ▐ Description CBV is a call back verification system designed for use with Renegade Bulletin Board Systems. It is intended to provide an easy way for Renegade users to self validate themselves without direct System Operator intervention. CBV also enhances system security by recording the complete phone numbers used for verification. It can also be configured to lockout troublesome users, lockout specific area codes and prefixes, and prevent users from gaining multiple accounts. CBV can also be configured to offer long distance callers a customized access level different from local callers. CBV has its own built in communication routines, which auto-sense the speed of the communication port, and can be used with high speed modems. CBV also has built in safeguards to prevent accidental corruption of system files. If for any reason CBV should abort because of internal errors it will provide and explanation of said reason both on the local screen and the system log. CBV uses direct DTR control to disconnect callers and has an optional fall back option to use a modem control string. CBV was coded entirely in Turbo Pascal, features built in ANSI interpetation, WWIV-ANSI interpetation, wordwrap, and a System Operator interface based upon WWIV. CBV is comprised of approximately 3000 lines of code, the configuration program about 1000 lines. ▐▐ Requirements Basically if you can use Renegade on your system the you should be able to run CBV. All support files must be in the same directory with the CBV executable. ▐▐▐ Restrictions SHARE.SYS/.EXE must be loaded an running if CBV is to be used in a multinode environment. Avoid running CBVCFG while CBV is running or editing any support files for CBV. (CBV100) 5 ▐▐▐▐ Support Files. CBV requires the following four data files to be present at all times. (CBVCFG.DAT) CBVCFG.DAT is the name of the CBV configuration file. It is produced by the program CBVCFG.EXE . This file cannot be edited by a word processor or standard editor as it is NOT ASCII. No other program but CBVCFG.EXE should be used to modify this file. To generate config files for other nodes, when running Renegade in multinode form, simply enter a number from 1 to 255 after the program name. (eg. CBVCFG 1) The layout of the configuration file is detailed in APPENDIX E. (CBVTRASH.DAT) This is an ASCII file, which can be edited using a ASCII file editor. If you use a word processor to edit this file make sure it outputs as ASCII. This file contains the list of all INVALID area codes, prefixes, arecode-prefixes, and phone numbers. CBV can optionally add numbers to this file to prevent callers from gaining multiple user ids on your system. Only one entry per line is permitted, comments may be on the same line as any number provided the comment begins with a semi-color ";". All entries must start at column one. Example CBVTRASH.DAT : 1 2 123456789012345678901234567890 900 ; We don't want to allow 900 calls 976 ; Neither do we want 976 calls 555 ; Directory assistance... NOT! 911 ; Emergency, yeah, like no access 404-555 ; Lockout of specific areacode-prefix 404-555-9999 ; Locked out number <- bad user? --- Basically there are certain numbers which should not be dialed, and certain numbers which are reserved for specialized purposes. CBV also prevents to the best of its ability users from entering invalid area codes and prefixes. This means no "1"s or "0"s as the first number of an area code or prefix, and only a "1" or "0" as the middle number of the area code. Also, area codes and prefixes are supposed to unique, however this cannot be guaranteed so CBV will not enforce it. (CBV100) 6 ▐▐▐▐ Support Files - Continued (CBVAREAC.DAT) This file contain a list of the areacodes that are *LOCAL* to your BBS. Only one entry per line is permitted, and no comments are allowed. You can create or edit this file with an ASCII editor. You must modify the example file distributed with the distribution files. (CBVCALLS.DAT) This file contains the list of AREACODE-PREFIXES that you only want CBV to call. This file is only accessed if the CBVCFG.Miscellaneous option "(E) - Use CBVCALLS.DAT Call Only File" is set to "YES". Even if set to no this file must exist, the data contained within will simply be ignored. The file may be edited with an ASCII editor following the rules set forth for the file "CBVTRASH.DAT". (CBVTOLLS.DAT) This file contains a list of AREACODE-PREFIXES that are toll calls from your system. TOLL calls are treated like other long-distance calls, the call-back must be within the long-distance window, and the CBVCFG option "Allow TOLL calls" must be set on. CBV checks the number entered against this file to determine if it is a toll call. This file follows are similar format to "CBVTRASH.DAT", however the numbers entered are numbers known to be TOLL calls from the BBS. This is mainly used to screen in AREACODE toll calls that do not require a long distance access code to call. (CBV100) 7 ▐▐▐▐▐ User Message Files. CBV requires that six message files exist before it will run. These files are displayed to the user as needed. They are ASCII files and rules for editing them are similar to the CBVTRASH.DAT file. WWIV ANSI codes may be used freely within these files, however pure ANSI should be avoided. A sample of each file has been included with the archive package. (WELCOME .CBV) This file is displayed to the user before he enters any information. It purpose is to explain what call back verification is for. After this file is displayed the program will ask the user if they wish to continue. (PREPARE .CBV) This file is displayed to the user before the actual call back begins. This is done immediately after the user has entered a number CBV has judged to be valid. (PASSWORD.CBV) This file is displayed once CBV has reconnected with the user BUT before they have entered their password. (NOTOLLS .CBV) This file is displayed if the user has entered a phone number matching one listed in "CBVTOLLS.DAT" and the SysOp has configured CBV not to allow them, or if the long distance calling window is closed. (NOLONGD .CBV) This file is displayed if the user has entered a long distance phone number and the SysOp has not configured CBV to allow them. It will also be displayed if the long distance calling window is closed. (LOCKOUT .CBV) This file will be displayed if the user enters a phone number in which the area code, prefix, or whole number appears in the CBVTRASH.DAT file. (CANTCALL.CBV) This file will be displayed if the option for "Check Call Only File" is set to "Yes" and the user's AREACODE-PREFIX is not found in the CBVCALLS.DAT file. (VERIFIED.CBV) This file is displayed after the user has completed the verification process, just after correctly entering their password. This is a good method of describing what access they have, and to inform long distance callers that they will need to call back again. (CBV100) 8 ┌────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· CBV INSTALLATION ·▌▌▌▌▌▌▌▌▌▌│ └────────────────────────────────────────┘ ▐ Files Extract all files contained within the archive file into the same directory. It is suggested that CBV be placed in its on sub-directory. When running the program make sure to switch to the same directory as where these files reside. ▐▐ Command Line CBV only requires a command line parameter if you are running Renegade in multi-node form. If you are simply running Renegade in single line mode then do not pass any parameters to CBV. ▐▐▐ MENUEDITT To make the door available to your users, enter into the Menu Editing section by pressing "#" from the WFC. Select "M" to modify and enter "ONLINE" to edit the online menu section. The either "M" modify an entry of "I" to insert a new entry. Example MENUEDIT entry : 1: Long Descript : Call-Back Verification Program 2: Short Desript : (0) CBV 3: Menu Keys : 0 4: ACS Required : !s20 ( only run by users less than SL20 ) 5: Cmd Keys : DC ( CBV needs a CHAIN.TXT file ) 6: Options : CALLBACK.BAT @E ( @E only if Multiline in use ) Flags Q:Quit CBV will look for a CHAIN.TXT file where specified in your NODE?.DAT file. If it cannot find it there it will abort. "N/A" means that they have not effect on the operation of CBV. If the user does not want ANSI displays then CBV will strip ANSI as needed. The option for pause is ignored by CBV. "??" means that these values are strictly your preference. You may also pass the node number CBV is being run from by adding the MCI code @E to the #6 entry in MENUEDIT. (CBV100) 9 ┌─────────────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· CBV CONFIGURATION ·▌▌▌▌▌▌▌▌▌▌│ └─────────────────────────────────────────┘ You must run the configuration program before using CBV. There are many system dependant values which need to be altered to reflect your system's configuration. CBV has the ability to alter the user's SL, DSL, ARs, Restrictions, and filepoints. Most of the fields are self explanatory. CBV does simple error checking, and will not correct values designed to cause problems. CBVCFG is divided into four sections, main, security, modem, and long distance. The only difference between UNREGISTERED SHAREWARE versions and REGISTERED versions is a 3 second shareware notification message sent to users. ▐ MAIN MENU (A) `Goto Security Validation Menu ' (B) `Goto Modem Menu ' (C) `Goto Long Distance Menu ' (D) `Goto Miscellaneous Menu ' The above options change to their respective menus. (E) `BBS Phone Number (XXX)XXX-XXXX ' {404-426-6426} [REG] Change this number to reflect your BBSes phone number. This is used only when CBV displays the example phone number entry. It is reccommended you enter your BBS phone number into the "CBVTRASH.DAT" file too. (Well, only other restriction) (F) `Full PATH of Main BBS Dir ' Enter the <drive\path\> to your MAIN BBS Direcotry. CBV uses this entry to locate your Renegade config file "RENEGADE.DAT", if this entry is in error CBV will not run. (CBV100) 10 (S) `Save Configuration and Quit ' Choose this option to save any changes you have made to your configuration. After saving the program will exit to the previous task, usually DOS. (X) `eXit without saving ' Choose this option NOT to save any changes you have made to your configuration. This is good if you forgot something or changed something inadvertently. (CBV100) 11 ▐▐ SECURITY (A) `Validated SL ' ( 0 / 255 ) (B) `Validated DSL ' ( 0 / 255 ) These options specify the SL and DSL given to users who sucessfully complete the call back verification. (C) `Validated AR Flags ' { } These options specify the AR flags given to users who sucessfully complete the call back verification. Press the letter of the flag you wish to toggle on or off. To exit the routine without making changes press the Escape key, otherwise press the RETURN key to keep changes. Valid keys are "ABCDEFGHIJKLMNOPQRSTUVWXYZ". These values in the userfile are overwritten, so the ones listed here will be the only ones they will have. (D) `Validated User Flags ' { } This option controls the restrictions and exceptions active on callers who sucessfully complete the call back verification. Press the letter/number of the restriction or exception you wish to toggle on or off. To exit the routine without making changes press the Escape key, otherwise press the RETURN key to keep changes. Valid keys are "LCVBA*PEKM1234". These values are merged with the previous values, this means that user defined flags like color/emulation will not be overwritten. (E) `Validate FilePoints ' { } This option controls the amount of filepoints callers who sucessfully complete the call back verification get. Valid entries are from "0" to "30000". (F) - (J) 'LD Validated ...... ' These options work identically to their above counterparts but are given to callers who sucessfully complete call back verification and are long distance from the BBS. This includes both callers long distance within and outside the local calling areas. (Q) `Quit to Main Menu ' This option will return you to the main menu. (CBV100) 12 ▐▐▐▐ MODEM (A) `Seconds to delay from hangup to callback' ( 1 / 59 ) This is the time CBV will wait from sucessful disconnection before attempting to make the call back. This default value is "3" seconds, and rarely should it ever be increased beyond 10. (B) `Seconds to keep DTR lowered for hangup ' ( 1 / 59 ) This is the time CBV will keep DTR "Data Transmit Ready" lowered. This is the primary method CBV uses to disconnect a caller. This may need adjustment if your modem in unusually slow to react to changes in DTR settings. The default setting is "2" seconds. (C) `Perform CTS-RTS flow control ' ( yes / NO ) Set this to "YES" if you are using a high speed modem where you have the communications port locked to a specified speed. Normally CBV simply uses XON/XOFF checking, but high speed modems normally use this method to control when it is okay to transmit characters. (D) `Command to use for dialing ' ( ATDT ) Enter the command your modem uses to DIAL. You may use the tilde character "~" for half-second delays. (E) `Command to use to hangup ' ( +++~~~ATH0 ) Normally CBV uses direct DTR control to disconnect the user, however some modems fail to respond to DTR control. This option allows you to specify the command required to hangup your modem. You may use the tilde character "~" for half-second delays. (Q) `Quit to Main Menu ' This option will return you to the main menu. (CBV100) 13 ▐▐▐▐▐ LONG DISTANCE (A) `Perform In-AREAC LD Validation ' ( yes / {NO} ) Set this option to "YES" if you want CBV to verify callers who are long distance from the BBS but within the local area code(s). Caller will be disconnected to avoid unnecessary expense. (B) `Perform Out of AREAC LD Validation ' ( yes / {NO} ) Set this option to "YES" if you want CBV to verify caller who are long distance from the BBS and outside the local area code(s). Caller will be disconnected to avoid unnecessary expense. (C) `Perform TOLL Calls ' ( yes / {NO} ) This controls whether or not CBV will make call backs to numbers specified in "CBVTOLLS.DAT". This option is useful for either screening out or allowing in AREACODE calls that don't require a long distance access code. (D) `LD Validation WINDOW begins at ' ( 00:00 ) (E) `LD Validation WINDOW ends at ' ( 00:00 ) These two options if set control when CBV can make long distance call back verifications. They have no effect if option "A" is set to NO. The values are entered in military format, "00:00" to "24:00". To leave the value unchanged press the Escape key else press ENTER or complete the time field. (F) `Long Distance ACCESS Code ' ( "1-" ) Important, normally most long distance calls are performed by prepending a "1-" to the phone number. There are some types of long distance services that require some type of special code to use them. If you belong to one of these services then enter that code here else leave it set to "1-". (Q) `Quit to Main Menu ' This option will return you to the main menu. (CBV100) 14 ▐▐▐▐▐▐ MISCELLANEOUS (A) `Compare phone numbers (logon/entry) ' ( yes or NO ) Set this to "YES" if you want CBV to notify you in the current SysOp log if the number used by the user for verification was different from the one they entered when initially logging onto the BBS. If also using option C (below) the number placed in the note field will be preceeded by "****". The use will also be prompted for the reason for the difference, and this will be written to the current SysOp log. (B) `Place phone numbers in user's note " ' ( yes or NO ) Set this to "YES" if you want CBV to place the verification phone number into the user's note field. (C) `Auto-Update "CBVTRASH.DAT" file. ' ( yes or {NO} ) Set this to "YES" if you want CBV to place the verification phone number into the trash file. This can be used to automatically prevent users from obtaining mulitple accounts via CBV. (D) `Use "CBVCALLS.DAT" Call Only File ' ( yes or NO ) Normally CBV determines if a call is long-distance by either comparing the areacode entered by the user to the entries in the "CBVAREAC.DAT" file or by asking the user. This helps prevents incurring unnecessary expense. This option is ignored when call is determined to be out of areacode long distance. If this option is also set CBV will check to see if the AREACODE-PREFIX combination exist in the Call Only File, if not the user will be shown the "CANTCALL.CBV" message. This can be used to insure that calls are made only to certain AREACODE-PREFIX combinations. Please note, if the AREACODE-PREFIX combination does not exist in the "CBVCALLS.DAT" file and this option is turned on only those numbers matching will be called. If you wish to simply lockout AREACODE-PREFIX combinations then make the entry into the "CBVTRASH.DAT" file. (CBV100) 15 ▐▐▐▐▐▐ MISCELLANEOUS - Continued (E) `Hangup after ALL verifications ' ( yes or NO ) If set to YES after any successful verification the caller will be disconnected. You should inform the caller about this in one of the user messages, preferably in "VERIFIED.CBV". (F) `Perform DIRECT Screen Writes ' ( yes or NO ) Some multi-tasking operating systems lockup when programs write directly to the screen, leaving this option set to "NO" can alleviate this problem. Setting this option to "YES" will however greatly increase local screen updates. (G) `Operate in QUITE mode ' ( yes or NO ) If "YES" CBV will not beep on the local console UNLESS there is a fatal error or warning. CBV normally sounds a "bell" whenever the user makes invalid character entries, this option when turned on will filter the "bells" from the local console. (H) `Number of attempts to call back ' ( { 1 } / 10 ) This setting controls how many times CBV will attempt to call back the user in one session. (I) `Minimum time granted in CBV (min) ' ( 0 / 20 ) This option can be used to make sure a user has a minimum amount of time to complete the verification process. If set to 0 then the user will simply have their normal timeleft as defined by the BBS, if set to any other value other than 0 then the users time will be increased to that value but never decreased. Please note that when the user exits the verification process that this option will not change the BBS defined timeleft. (J) `Time allowed between keystrokes (sec) ' ( 180 / 600 ) This option is used to define the remote/local keyboard timeout. The minimum value is 90 seconds. This can be changed to suit the needs of your users. If a character is not received either from the modem or local keyboard within the specified number of seconds since the lastone the user will be returned to the BBS. (Q) `Quit to Main Menu ' This option will return you to the main menu. (CBV100) 16 ┌──────────────────────────────────┐ │▐▐▐▐▐▐▐▐▐▐· APPENDICES ·▌▌▌▌▌▌▌▌▌▌│ └──────────────────────────────────┘ ▐ A. ERROR MESSAGES CBV when properly setup should not error. However not everything goes right and CBV was written to take this into account. There are two types of errors, FATAL and NOTICE. FATAL errors are just what you expect, errors that in some way prevent CBV from continuing. Usually these are caused by improper installation and/or configuration of the program. NOTICEs occur when CBV encounters something which the System Operator should be made aware of. These usually involve problems with the user, like being locked out or not wishing to use the door. FATAL ERRORS : 1> CHAIN.TXT file not found. a) This will only happen, if you did not tell Renegade to create a "CHAIN.TXT" file (check your menuedit selection for CBV, the command key must be DC). The location of this file is determined by reading the appropiate "NODE?.DAT" file. 2> UNABLE TO FIND FILE "filename.ext". a) This error should only occur when CBV is executed from a batch file that specifies the path/filename to CHAIN.TXT and that specification is incorrect. 3> ERROR READING FILE "filename.ext". a) Verify that the CHAIN.TXT file is not corrupted, or that the file specified as being CHAIN.TXT really is. 4> CONFIG FILE NOT FOUND. a) If executing CBV from a batch file make sure that you switch to the proper directory. b) Run CBVCFG to create the config file. (CBV100) 17 ▐ A. ERROR MESSAGES - Continued 5> UNABLE TO READ CONFIG FILE. a) Check to see if the config file is corrupted. If it is then delete it and rerun CBVCFG. 6> CONFIG FILE NOT CORRECT FOR THIS VERSION. a) Delete the configuration file and run the configuration program included within this package. 7> FAILED TO INITIALIZE COMMUNICATIONS MODULE. a) Verify that the communications port passed in CHAIN.TXT is correct. If it is and you still receive this error then there is a hardware incompatibilty and little can be done. 8> CANNOT FIND FILE *.CBV. (where * = paticular user message file) a) If executing CBV from a batch file make sure that you switch to the proper directory. b) Recreate the proper user message file. 9> CANNOT FIND FILE CBVTRASH.DAT a) as per error #8 10> COULD NOT OPEN USER FILE. a) CBV access the user file "USERS.DAT" by first reading the Renegade config file to locate the "DATA\" direcotry. This error should not occur. 11> USER FILE ACCESS FAILED, USER NAME MISMATCH a) This will only occur should CBV not seek to the proper record number within the USERS.DAT file. Though it could happen should versions of CBV not match correctly with the Renegade version you are running. 12> USER FILE ACCESS FAILED, USER SL MISMATCH a) Same as #12 but in reference to their SL. (CBV100) 18 ▐ A. ERROR MESSAGES - Continued 13> COULD NOT LOCATE RENEGADE.DAT! a) The entry in CBVCFG for MAIN BBS Dir is incorrect. 14> COULD NOT OPEN RENEGADE.DAT! a) Either the file is corrupt, or the wrong version, or access was denied by the Operating System. 15> COULD NOT LOCATE/OPEN NODE?.DAT a) Either your version Renegade did not generate the proper Node file or the file access was denied by the operating system. ( in should be in the DATA directory ) NOTICE ERRORS : 1> COULD NOT RECONNECT, CBV FAILED. a) This is reported whenever CBV attempts call back and cannot reestablish the link. There are other notices that CBV will output, most of all will appear in the current SysOp log. Most of these notices are just for informational purposes, there is usually no corrective action needed. (CBV100) 19 ▐▐ B. SESSION CONTROL CBV has a SysOp interface loosely based upon WWIV SysOp controls. They are available through all parts of CBV EXCEPT during the actual call back attempt. During that time CBV will not update the status line nor will it respond to local key presses. The status line appears at the bottom of the local display, it is routinely updated throughout the duration of the session. It is divided into five sections. The first part displays the user's user number on the system, the second part displays their name. Section three displays the current communication parameters to include the current communications port and whether or not flow control is being used. The last to sections display time used and time left. The following keyboard commands are available during the session. F5 = Hangup. - disconnects user from BBS F7 = Decrease Time - lowers timeleft by 180 seconds F8 = Increase Time - raises timeleft by 180 seconds (CBV100) 20 ▐▐▐ C. CONTACTING THE AUTHOR Comments, suggestions, questions, and problems can be sent to the author using the following methods. U.S. Mail (the slowest) Mr. Chris Holko 1029 Franklin Road Suite 4C Marietta, GA 30067 WWIVNet/WWIVLink/ICENet E-Mail #1@4401 from any WWIVNet BBS. #1@14401 from any WWIVLink BBS. #1@4401 from any ICENet BBS. BBS Iconian Gateway WWIV (Reg #11238) (404)426-1941 (after July 1st 1-404-ICONIAN) (hopefully) PcPursuit via GAATL 300-14400/MNP5 (v32/v32bis/CSP) 670 MB Online Storage / and soon a CDROM E-Mail #1 "Chris" REGISTRATION forms must be sent via U.S. Mail. Please Note : The author runs a heavily modified WWIV BBS, I have no intention of changing to Renegade. So why did I write this CBV door for Renegade? Easy, I have already written one for WWIV, and in such a way that all I had to do was, change one UNIT to support Renegade in the actual CBV door, cut-paste together a config program, and edit the docs to reflect the use on Renegade. I have too much invested in WWIV to facilitate a change, namely being an Area Coordinator for WWIVNet. I surely hope you will not hold my not running Renegade against me, I don't believe the author of Renegade does. I do have a few people who can beta-test this software for me, so its not like you get it with tons of bugs. Lastly I wrote it because the one I saw available for Renegade was really lacking in what I thought a CBV door should be, plus two certain Sysops running Renegade asked me too. I am also a user of Digital Wasteland (Renegade Home), alias = "Chris", or under my real name of "CHRIS HOLKO". (CBV100) 21 ▐▐▐▐ D. USER RESTRICTIONS The following is a list of restrictions that can be placed on users of Renegade BBSes. This is provided so that you may accurately alter values entered in the CBVCFG Security Validation Menu. Restriction - Description L - Limited to one call a day C - No SysOp paging V - Posts are unvalidated U - Can't list users A - Can't post an auto message * - Can't post anonymously P - Can't post E - Can't send email K - Can't use voting booth M - Force email deletion 1 - No UL/DL ratio 2 - No post/call ratio 3 - No file points checking 4 - Protected from deletion (CBV100) 22 ▐▐▐▐▐ E. CBVCFG.DAT LAYOUT This structure of CBVCFG.DAT is provided for informational purposes only, it should not be modified except by the CBVCFG program. ConfigRec = RECORD header : STRING[15]; use_note_field, (* place number in user note field *) compare_fons, (* compare userrec.phone 2 entry?? *) update_trash, (* auto update trash file *) allow_ld, (* allow in-areac long-dist cbv *) allow_out_ld, (* allow out-areac long-dist cbv *) CTS_RTS, (* perform CTS/RTS checking? *) hangup_after, (* hangup after all call-backs *) use_callfile, (* CANCALL.DAT - ac-pr to only call*) direct_write, (* direct screen writes? *) quite_mode, (* stifle bells on local console *) allow_toll : BOOLEAN; retry_attempts, (* attempts to call user back pses *) delay_time, (* delay time between hangup/callbk*) drop_delay, (* time to keep DTR lowered *) min_time, (* min time granted for door use *) hang_time, (* no entry hangup time *) max_SL : BYTE; startmenu : STRING[8]; (* not used - probably never *) LC_SL, (* New SL for local validations *) LC_DSL, (* New DSL for local validations *) LD_SL, (* New SL for longds validations *) LD_DSL : BYTE; (* New DSL for longds validations *) LC_AR, (* New ARCQ flags for local *) LD_AR : ACFF; (* New ARCQ flags for remote *) LC_flags, (* New uflags flags for local *) LD_flags : ACRR; (* New uflags flags for LD *) IRQLevel, (* not currently used *) LC_filepoints, (* New File points for local *) LD_filepoints : INTEGER; (* New File points for LD *) bbs_areac, (* BBS Area Code *) bbs_prefix, (* BBS Prefix *) bbs_suffix : STRING[4]; (* BBS Suffix *) LD_PREFIX : STRING[20]; (* LD Dialing prefix *) dialcommand, (* command to dial on modem *) hangupcmd : STRING[30]; (* command to hangup the modem *) logfiledir, (* path to log file directory *) _BBSDIR_ : STRING[60]; (* complete path to MAIN BBS DIR *) version1, (* version ID flag - check #1 *) version2, (* version ID flag - check #2 *) LastDate, (* not used *) LD_WIN_START, (* LD window starts (sec since MN) *) LD_WIN_STOP : LONGINT; (* LD window ends *) END; (CBV100) 23 ▐▐▐▐▐▐ F. WWIV-ANSI Colors CBV message files can be colorized using color codes similar to WWIV ANSI color codes. These are in the format of <CHAR #3><COLOR> CHAR #3 = Heart Character (ALT-003) COLOR = 0..9 <COLOR> ForeGround BackGround Color 0 LightGray Black Color 1 LightCyan Black Color 2 Yellow Black Color 3 Magenta Black Color 4 White Blue Color 5 Green Black Color 6 LightRed Black Color 7 LightBlue Black Color 8 LightBlue LightGray Color 9 Yellow Red