home *** CD-ROM | disk | FTP | other *** search
Text File | 1993-03-09 | 43.0 KB | 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
-
-
-