CD Shareware Magazine 1997 January

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

/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / RGVBETA1.ZIP / RGV.DOC < prev next >

Wrap

Text File | 1996-10-06 | 19.2 KB | 448 lines

- The Renegade Verification System - ┌─────────── ┌────────── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─────────── ┌─── ┌────── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌────── ┌─── ┌─── ┌────────── ┌──── - The Ultimate Renegade Verfication System - Written & Copyright (C) 1996 Gary Hall ┌──────────┐ │ CONTENTS └ Features Introduction Disclaimer Requirements Files INCLUDED in a valid archive of RGV Rengade Compatability Installation and configuration Important notes on validation levels The RGV-LOCK.DAT The RGV-DIAL.DAT Running RGV Locally Other RGV Functions Registration? How to reach the author ┌──────────┐ │ FEATURES └ * Callback verification including extensions. * Supports 99 nodes (in theory). * Timeslices for DOS, Os/2, Desqview, & Windows 3.0+. * Flexable lockout file. * A very useful maintenence mode. * Configurable ansi/ascii screens. * Long distance time window settings. * Easy and SAFE validation for Renegade sysops. ┌──────────────┐ │ INTRODUCTION └ This program was written to "fill the void" of a decent automatic validation system for the Renegade Bulletin Board System (Copyright by Cott Lang). It was written in Borland Pascal...about 5 times now. :) ┌────────────┐ │ DISCLAIMER └ Rgv is supplied without any guarantees or warranties, expressed or implied, with regard to it's suitability or use for any purpose, other than contributing to the entropy of the universe. It does do that quite nicely, however. Like most people who create such trinkets, I created Rgv to solve a particular problem of mine, on my system, with my setup, etc. I hope it works on yours, but if it breaks, you own both halves. ┌──────────────┐ │ REQUIREMENTS └ * MsDos v3+ or compatable environment. * Renegade v05-11 Exp. (for auto-validation to work). * A modem that displays verbal result codes. * ...and with some minor intellegence, 5 minutes. :) ┌──────────────────────────────────────────┐ │ FILES THAT SHOULD BE INCLUDED IN ARCHIVE └ README.1ST - Important. Read it. RGV.DOC - What you're reading right now you idiot. :) RGVBETA.TXT - Text file explaining changes and upgrade tips. RGV.EXE - The main program. Rgv will also read the following files if they exist in both .ASC & .ANS formats (they are displayed in order) : RGV1.??? - displayed introduction screen RGV2.??? - displayed at phone number detection RGV3.??? - displayed if extensions are allowed RGV4.??? - displayed if area code is locked out RGV5.??? - displayed if number is permenantly locked out RGV6.??? - displayed if number is locked out but not permenently RGV7.??? - displayed if long distance callbacks are not allowed at the current hour. RGV8.??? - displayed if password is required RGV9.??? - displayed during hangup countdown RGV10.??? - displayed during callback interruption RGV11.??? - displayed if the caller cannot be validated for any reason RGV12.??? - displayed after validation to long distance callback before hanging up RGV13.??? - displayed then local callback is successful or long distance caller is auto-validated In the original archive, I included these 13 files; however, if you're missing one or more of these files, download a copy from my BBS (see below). ┌────────────────────────┐ │ RENEGADE COMPATABILITY └ To take full advantage of Rgv with your Renegade BBS, you MUST be running a valid copy of Renegade v05-11 Exp. if not, don't fret. Rgv will still perform as you have it configured except it won't validate the user or write anything in the user note. However, everything will be logged for manual validation at your convience. ┌───────────────────────────────────────┐ │ INSTALLATION AND CONFIGURATION OF RGV └ STEP 1. - Unarchive Rgv into a specified directory. STEP 2. - **IMPORTANT! READ RENEGADE COMPATABILITY SECTION ABOVE! ** - STEP 3. - Type "RGV /SETUP" ┌──────────────────────────────────────────────────────────────────────────────┐ │ RGV v05-13ß - Copyright 1996 - ChAoSoft(tm) │ └──────────────────────────────────────────────────────────────────────────────┘ Record #1 of 1. [Node #1] Page 1 of 2. ┌──────────────────────────────────────────────────────────────────────────────┐ │ [A] Path To Renegade.Dat : [path to Renegade.Dat] │ │ [B] Display File Path : <current path> │ │ [C] Log Path\Filename : <current path>\RGV.LOG │ └──────────────────────────────────────────────────────────────────────────────┘ ┌────────────────────────────────────┐┌────────────────────────────────────────┐ │ RGV Configuration Information ││ [J] Node Reference : 1 │ └────────────────────────────────────┘│ [K] Inactivity Timeout : 180 │ ┌────────────────────────────────────┐│ [L] Callback Attempts : 3 │ │ [D] Number In User Note : No ││ [M] Password Attempts : 5 │ │ [E] Lockout Prev. Numbers : No ││ [N] Seconds Before Dialing : 7 │ │ [F] Create Password : No ││ [O] Seconds To Connect : 60 │ │ [G] Allow Extensions : No ││ [P] Local Validation Level : B │ │ [H] Hangup On All Callbacks : No ││ [Q] LD Validation Level : D │ │ [I] Auto Validate LD Calls : No ││ [R] INTL Dial Prefix : 1 │ └────────────────────────────────────┘└────────────────────────────────────────┘ Ins = Insert Entry ] = Forward Record PgUp = Next Page Del = Remove Entry [ = Backward Record Esc = Save/Exit A. Path To Renegade.Dat : [drive:\+path to Renegade.Dat] B. Display File Path : [drive:\+path to Rgv's *.ANS/*.ASC files] C. Log Path\Filename : [drive:\+path+\+filename of Rgv's logfile] D. Number In User Note : Toggle whether or not Rgv should write the phone number verfifed in the "User Note" field of your users.dat. E. Lockout Prev Numbers : Toggle whether or not you wish multiple calls to the same number, ie., multiple users in the same household (See "The RGV-LOCK.DAT" below). F. Create Password : Rgv can create a unique password for each call just prior to initiating callback. This is *not* the user's system password and will only be used during that particular callback. G. Allow Extensions : Allow the use of phone extension numbers, ie., those used in dorms and offices. If this is toggled "Yes", Rgv will dial the phone number, add the modem delay string (provided by you below), then dial the extension number. H. Hangup All Callbacks : Toggle whether or not you wish Rgv to hangup on all callbacks once the caller is verified. I. Auto Validate LD Calls : Toggle whether or not you wish Rgv to automatically validate LD callers. J. Node Reference : What node number is the record relative to? [Max=99] (Note: you cannot have two node numbers the same. Duh! :) ). K. Inactivity Timeout : How many seconds before Rgv hangs up due to inactivity (ie., no key pressed.). [Max=240 (4 mins)] L. Callback Attempts : How many times Rgv will attempt to callback during a session. [Max=25] M. Password Attempts : How many times Rgv will allow an incorrectly entered password before hanging up. [Max=25] N. Seconds Before Dialing : Number of seconds to wait after hanging up and initializing the modem before attempting callback. [Max=15] O. Seconds To Connect : Number of seconds to wait before Rgv should give up on a callback attempt and go to the next or exit. [Max=180] P. Local Validation Level : Renegade subscription level "A-Z" to validate callbacks within your local calling area. Q. LD Validation Level : Renegade subscription level "A-Z" to validate callbacks who are *not* in your local calling area. R. INTL Dial Prefix : What is your international dial prefix. (example : 1 = USA & CANADA) ┌─────────────────────────────────────────────┐ │ ** IMPORTANT ** Notes on validation levels. └ * Validation levels are the same as what you have configured in your Renegade system configuration (G. Subscription/Validation System). * If a validation level is blanked in Rgv, Rgv will not validate the user. Instead, it will display "RGV11.*". * If the user's security level = 255 Rgv will not attempt to validate them to a lower security level. * If the Renegade version is incompatable, Rgv will not touch anything in Renegade. It will log the activity and display "Rgv11.*". STEP 4. - Press the "Page Up" key and we have : ┌──────────────────────────────────────────────────────────────────────────────┐ │ RGV v05-13ß - Copyright 1996 - ChAoSoft(tm) │ └──────────────────────────────────────────────────────────────────────────────┘ Record #1 of 1. [Node #1] Page 2 of 2. ┌───────────────────────────────────┐┌─────────────────────────────────────────┐ │ [A] Init : ATE1Q0V1X4&C1&D2S0=30 ││ [J] Answer : ATA │ │ [B] Dial : ATDT ││ [K] Hangup : ATH0 │ └───────────────────────────────────┘│ [L] Connect : CONNECT │ ┌───────────────────────────────────┐│ [M] Ok : OK │ │ 0.....6.....0.....6..... ││ [N] Ring : RING │ │ [C] Sun:........................ ││ [O] Busy : BUSY │ │ [D] Mon:........................ ││ [P] No Dial Tone : NO DIAL TONE │ │ [E] Tue:........................ ││ [Q] No Carrier : NO CARRIER │ │ [F] Wed:........................ ││ [R] Error : ERROR │ │ [G] Thr:........................ ││ [S] Voice : VOICE │ │ [H] Fri:........................ ││ [T] Fax : FAX │ │ [I] Sat:........................ ││ [U] Delay : ,,,,,, │ └───────────────────────────────────┘└─────────────────────────────────────────┘ The following are a brief description of the above key options : Ins - (the insert key) - Creates another record for another node. Del - (the delete key) - Marks the current configuration for removal from "RGV.CFG" once you press ESC (see below). Pressing the "Del" key on a record marked for deletion will unmark it. ] - (the left bracket key) - if you have more than 1 node configured, pressing this will allow you to move forward to the next node config. [ - (the right bracket key) - same as above except this moves backwards. PgUp - (the page up key) - goes to the second page of options. Esc - (the escape key) - Quit & save. A. Initialization : Initialization string to use before calling B. Dial Command : Your dialing prefix C.- I. : Place an "X" in the time frame you allow LD callback verifications for each day of the week. NOTE : If you are auto validating LD users, setting these fields is redundant. J. Answer Command : Your modem answer command K. Hangup Command : Your modem hangup string L. Connect : Your modem's VERBAL connect response M. Ok : Your modem's VERBAL ok response N. Ring : Your modem's VERBAL ring response O. Busy : Your modem's VERBAL busy response P. No Dial Tone : Your modem's VERBAL no dial tone response Q. No Carrier : Your modem's VERBAL no carrier response R. Error : Your modem's VERBAL error response S. Voice : Your modem's VERBAL voice response T. Fax : Your modem's VERBAL fax response U. Modem Delay : Your modem's delay command string to use before dialing an extension. STEP 5. - Create the batch file to call RGV For a single node BBS, you can use: @Echo Off C:\ Cd\Rgv Rgv <Path to Door.Sys> ( ie., RGV C:\BBS\DROP ) For a multi-node BBS, you can try this: @Echo Off C:\ Cd\Rgv Rgv <Path to Door.Sys> ( ie.. Rgv C:\Bbs\Drop%1) The %1 in a multi-node setup passes the node variable. STEP 6. - Run Rgv /MAINT. This will read your Renegade USERS.DAT file and create a standard text file of validated users, thier numbers, the date, and the time. Be sure to edit this to lockout 911, 1-800, etc... calls. (See "The RGV-LOCK.DAT" below). STEP 7. (optional) - Edit all .ASC, & .ANS files for your personal needs/likes/dislikes STEP 8. - Create an entry for Rgv in your Renegade start menu. This is the menu you have defined in Renegade Config, Subscription Level A, Startout menu. NOTE!!! THIS DOOR ONLY READS DOOR.SYS! For a single node BBS use: ACS : !VV Cmdkeys : DG Options : R;RGV.BAT For a multi-node BBS use: ACS : !VV Cmdkeys : DG Options : R;RGV.BAT %N ┌──────────────────┐ │ The RGV-LOCK.DAT └ This file (if it exists) keeps basic information on what numbers you do NOT want Rgv to call. The following are some valid examples of how RGV-LOCK.DAT should be formatted : If you've set Rgv to lockout previously used numbers, it uses this format : 1-219-447-7205 # NO EXT. # Gary Hall # 11/28/96 # 9:09am ; You can permenantly lockout a number later by adding a '+' before the entry : +1-219-447-7205 # NO EXT. # T.P.R. Systems # 11/28/96 # 9:09am ; or entire areacodes : +1-900* # * # Toll Call Lockout # ; +1-800* # * # 800 Call Lockout # ; +1-000* # * # Operator Call Lockout # ; or use "X"'s to lockout 911 calls to any areacode like this : +1-xxx-911* # * # Emergency Lockout # ; +1-xxx-555-1212 # * # Information Lockout # ; BE AWARE! You MUST use this format (spaces and all) for Rgv to function correctly. The first 3 fields are required separated by a space # space. The time and date fields are optional. NOTE: If you're allowing extensions, be aware, Rgv will call duplicate phone numbers if the extension entered is different. Thus, if you have the following entry in RGV-LOCK.DAT : 1-219-447-7205 # NO EXT. # T.P.R. Systems # 11/28/96 # 9:09am ; a user can still call 1-219-447-7205 extension #3294. To lockout all extensions belonging to the phone number place a "*" in the extension field : +1-219-447-7205 # * # T.P.R. Systems # 11/28/96 # 9:09am ; ┌──────────────────┐ │ The RGV-DIAL.DAT └ If this file exists in your Rgv directory, Rgv will not ask if the user is long distance. Instead, it will read this file to find that information out. The RGV-DIAL.DAT should be formatted ilke this : 219-447 ; 219-447 exchanges are local to me. 219-456 ; 219-456 exchanges are local to me. or 219* ; all 219 areacodes are local to me. ┌─────────────────────┐ │ Running RGV Locally └ Rgv has no local switch because I didn't want to waste time and your hard drive space on too much redundant crap. But, if you want to get a look at it, you can run it locally from your bbs reading DOOR.SYS or edit a DOOR.SYS file and change the "COM?:" line to "COM0:". When in local mode, Rgv will do everything it normally does. ┌─────────────────────┐ │ Other RGV Functions └ * Running RGV /MAINT will run a basic maintenece that does the following : - Reads your Renegade USERS.DAT file and imports all users whos security level is above that of new user status into the RGV-LOCK.DAT. - If a RGVLOCK.DAT already exists, all entries preceeded with a "+" will also be included in the new RGV-LOCK.DAT. I run this in a nightly maintenece to keep my lockout file from locking out numbers of deleted users. It also comes in handy if you're setting up RGV for the first time. ┌──────────────┐ │ Registration └ After being a sysop for 6 years, I know what kind of extreme cost can go into running a bulletin board if you actually register everything. So, send me what you think it's worth.... Once I recieve whatever you think this program is worth, you can pickup a registered copy from my bbs. Postcards are welcome. :) Gary Hall 3504 Tillman Rd. Fort Wayne, IN 46816 ┌─────────────────────────┐ │ How to reach the author └ If you have a problem, I'm not home. :-) Just kidding. <grin> Internet address - Unfortunately, I just recently lost this.. :( Networks - Fidonet 1:236/64, ITCnet 85:30/0, ChaosNet 98:98/0, PODSnet 93:9607/0, & LibertyNet 76:19/69. BBS - The Pool Room (T.P.R. Systems) (219)447-7205 or (219)447-5698 ┌─────────────────┐ │ Thanks go to... └ Those who beta test. Scott Mayall, Don Cranford, & Charles Bowman and Cott Lang for the cool bbs package.