home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
CLBKV161.ZIP
/
CALLBK.DOC
< prev
next >
Wrap
Text File
|
1993-02-01
|
20KB
|
518 lines
┌───────────────────────────────────────────────────────────────┐
│ W E L C O M E to... CALLBK version 1.60 │
│ │
│ The callback verifier door for RBBS-PC sysops worldwide. │
│ │
│ Copyright (c) 1992 SteveSoft Software. USA. │
│ │
│ All Rights Reserved. │
│ │
└───────────────────────────────────────────────────────────────┘
There has long been a need for a dedicated call back verification
program for RBBS sysops. Until now, there were a few that were
relatively well programmed, however, after having tried two or three of
them, and after having determined that they didn't quite meet
my expectations, I felt it necessary to create one. The result is the
program that you, the RBBS sysop, will shortly have fully operational
on your system.
RBBS has long had the ability to allow the use of a verification door
built-in, or more accurately, a registration door. This program, CALLBK
takes full advantage of that RBBS ability.
CALLBK is small, fast, and above all, reliable. It will run on any IBM
system, or compatible computer on which you operate your RBBS
(INCLUDING a LAN and DESQVIEW). It will take some time for you to edit
the sysop configurable files which are described in more detail later in
this documentation. Other than that, it should be fully operational on
your system in about 10 minutes!
In RBBS-PC v17.3C, and RBBS v17.4 CONFIG PARAMETER 107 is used to tell
RBBS-PC what the door name is to check new users at log-in. For example,
I use "F:\RBBS\DOORS\VALIDATE.BAT"
CONFIG PARAMETER 108 is the parameter to tell RBBS-PC "This security
level AND lower, must be sent to the above named door". For example, I
have it set to level 30. Everyone is at level 30 on my RBBS until they
are called back with the verifier. The verifier can easily be setup to
increase the callers' security level when a given caller has responded
successfully to the callback question, and has been logged back into
your RBBS.
Installation of CALLBK is pretty much straight forward and should
cause no difficulty for most experienced sysops. If you are a
'freshman' RBBS sysop, I strongly suggest that you read this entire
document to obtain maximum performance of the CALLBK program. The
following describes the required files and their purposes.
The batch file needed to call CALLBK from RBBS...
──────────────────────────────────────────────────
This example assumes that you are using XU.EXE and it reflects the
lines about XU.EXE as shown...
You can name the following as CALLBACK.BAT just as a reference when you
are looking through the dozens of BAT files on your system.
────────────────────────
The VALIDATE.BAT file...
────────────────────────
@echo off
XU WATCHCD:0:OFF
@Echo Please stand by... > com1
cd \rbbs\doors\mycalbk
MYcalbk %1 /wait:7
cd \rbbs
IF NOT EXIST VER%NODE% GOTO DONE
msgform /LTR:\rbbs\newwelc.def /MSG:\RBBS\SYSTEM\MAINM.DEF /SEC:30 ────┐
┌──────────────────────────────────────────────────────────────────────┘
└─── /PRI /NET /DOR:\RBBS\DORINFO%node%.DEF del ver%node% :DONE XU
:DONE
WATCHCD:0:ON
The VERx file is a SEMAPHORE file to allow you to create an
Auto-welcome message for your new user. I use MSGFORM.EXE but you may
use something different, OR process the new user differently. Possibly
"tossing" the user into another door (Now that you know they are
verified).
* One note. Do not use a .BAT file named VERIFY as DOS will not execute
it. (VERIFY is a DOS keyword.)
The Configuration files and samples...
──────────────────────────────────────
────────────
MYCALBKx.CFG (Where 'x' = node number).
────────────
F:\rbbs
YELLOW <---- NEW!!!!!!!!
F:\bulletin\b1
ATE1V1Q0X4
00000
Line 1 = Path to your RBBS DORINFOx.DEF file.
Line 2 = Background Color of "desktop". (BLACK or BLUE not recommended!).
Line 3 = Path to ASCII bulletin...(not used but necessary).
Line 4 = MODEM init string to get "OK" out of it.
Line 5 = Registration code. The five (5) zeros * MUST * be there!
When you register MYCALBK you will receive a registration key which you
type in place of the five (5) zeros. The five zeros simply put a
small message on the monitor that this copy is not registered. When
you do get around to registering, I will send you a registration key
which will then put a message on the monitor that you have registered
this copy, along with the name of your RBBS. Please see the information
about registering near the end of this document.
──────
SL.CFG * NOTE * SL.CFG is: Security level configuration.
────── If you do not have a security listed
30,60,30 here, MYCALBK will NOT upgrade thier
65,65,65 security.
60,60,30
0,30,0
Parameter 1 = ENTRANCE security (What they will be when they get here).
Parameter 2 = PASS security (what to upgrade to if they pass).
Parameter 3 = FAIL security (what to drop them to if they fail).
────────
LDSL.CFG * NOTE * LDSL.CFG is: Long distance security level cfg.
────────
30,61,30
65,65,65
Parameter 1 = ENTRANCE security (What they will be when they get here).
Parameter 2 = PASS security (what to upgrade to if they pass).
Parameter 3 = FAIL security (what to drop them to if they fail).
If you enable LD calls, you MUST have this file. Otherwise your
callers SECURITY LEVEL will be set to 0 (zero) when they return. It
allows you to "bump up" LONG DISTANCE callers so they have
more time on-line (Some SysOps prefer their long distance
callers to have an extra 15 minutes on-line. After all, they are
calling long distance to visit your RBBS). If you do not like that,
then just set it the same as SL.CFG.
────────────
AREACODE.CFG
────────────
803,0000,2359,1
919,1800,0800,1
Parameter 1 = areacode approved for call back.
Parameter 2 = time to START call backs...(no colons, 24hr time!).
Parameter 3 = time to STOP call backs...(no colons, 24hr time!).
Parameter 4 = hang up flag. 1 = hang up after verify.
0 = stay on the line (at YOUR expense!).
First areacode * MUST * be YOUR area code! Don't make an error here!
(Please note, if the supplied AREACODE.CFG file does not contain
all United States areacodes, please let me know so I may add
them in future releases).
────────────
LCLXCHNG.CFG *NOTE* LCLXCHNG.CFG is: Local exchanges cfg.
────────────
393
332
669
665
Local exchanges are ones that do NOT require a '1-' in front of them and
are in your areacode.
───────────
LDXCHNG.CFG *NOTE* LDXCHNG.CFG is: Long distance exchanges cfg.
───────────
803,1800,0700,1
919,1800,0700,1
LONG DISTANCE exchanges in YOUR state (USA) or province (Canada) that
you want to call back to.
Parameter 1 = exchange number
Parameter 2 = start time...(military time. NO COLONS!)
Parameter 3 = end time.....(military time. NO COLONS!)
Parameter 4 = hang up flag. 1 = hang up after verify.
0 = stay on the line (at YOUR expense).
───────────
NO-1AC.CFG *NOTE* NO-1AC.CFG is: Area codes that do NOT require
─────────── a 1- in front of the number!
803
What the Bells have done now is this... They make it MUCH easier for
you to call Long Distance by now not telling you it's Long Distance!
This I feel is wrong, but we have to deal with it!
Let's say you have configured a Long distance area code in the ABOVE
.CFG file. Now, you can call Long distance to that area code without a
1! So, add it into this .CFG file here. It must be 1 of 2 things. YOUR
base areacode or Areacodes defined in the LDXCHNG.CFG file! That's it.
───────────
###XCHNG.CFG *NOTE* ###XCHNG.CFG is: The area code is ### and the
─────────── exchanges inside this .CFG file
395 are local calls.
Another fine problem to deal with with the "BELLS". Apparantley in some
portions of the country, you can dial to more than one area code and
it's a local call. So to handle this problem, I have created this .CFG
file. If you have defined an exchange in LCLXCHNG.CFG that is NOT in
your areacode, remove it from there and enter it in this file. This
will allow local calls made across area codes to be made without the
program "thinking" they are LD and restrict them.
MYCALBK 4
^ Node number even if you only run 1 node! See the
CALLBACK.BAT sample file which will make this clear to you.
Command line switches...
────────────────────────
NOTE *** ALL command line switches * MUST * begin with the forward
slash (/) in order to be initiated. See the CALLBACK.BAT file for more
details. Also, please take note of the full colon (:) as part of the
command switch. Very important...
───────────────────────────────────────────
/PREFIX:0,,, /SUFFIX:18005551212,,####,,,
───────────────────────────────────────────
Allows you to use Sprint or whatever number you want to use to call
back LD calls.
─────────────
/REDIALTIME:5
─────────────
Controls how long between calls (when dialing the caller) that MYCALBK
waits. Defaults to 10 seconds. NOTE: if you are using a high speed
modem such as the USRobotics HST, a setting for this switch of 3
seconds has proven to be very effective.
────────
/WAIT:8
────────
Allows you to control how long MYCALBK waits until it tries to call the
caller back. Defaults to 15 seconds. Also, you should know that
MYCALBK will attempt to place a call to the caller three (3)
times. If a connection is not made after three (3) attempts,
that's it! It's recycle time! The caller will have to try again at some
future date. NOTE: if you are using a high speed modem such as the
USRobotics HST, a setting for this switch of 3 seconds has proven to be
very effective.
─────
/DUMP
─────
Instead of allowing the caller back into the BBS when a duplicate number
is detected, this switch simply disconnects them. In other words, if
someone logs-in using the name Wayne Gretzky with a phone number of
say, 403-123-4567, and is verified, and then, if someone logs-in from
the SAME number using the name Eric Lindros, unfortunately for
Eric Lindros, he will be disconnected as quickly as a hockey puck is
dropped to start a game! Real fast!
─────
/NO-1
─────
I have been told that there are areas in the US that allow one to dial
any number in their area code without a 1. This switch takes care of
that. The door defaults to dialing a 1 if the call is long distance.
───────────────────
/FOSSIL: ON or OFF
───────────────────
Use this to FORCE Fossil status. Mainly used for debugging but I have
left the code intact for your use.
/FOSSIL:ON will force the use of the FOSSIL even if your DORINFOx.DEF
file does not have it enabled.
/FOSSIL:OFF will force the use of the FOSSIL off even if your
DORINFOx.DEF file enables it.
───────────────────
/LPT:#
───────────────────
Use this switch to get a print out of the callers as they are verified.
Usefull to see what has happened during the day.
# is a valid DOS printer port from 1 - 3.
SysOp configurable files...
───────────────────────────
Please see the enclosed sample files for each of the following for
your convenience. You can edit them with any ASCII text editor to suit
your particular system.
There are five (5) files in this package that are SysOp "adjustable".
The FIRST line * MUST * be one of the eight valid IBM colors...
(RED, GREEN, BLUE, CYAN, YELLOW, WHITE, BLACK, and MAGENTA)
Here's a description of each file and the output to the caller.
WELCOME Shown to the caller when they first log-in.
NODUPES Shown to the caller when that phone number has already been used.
SORRYAC Shown to the caller when their area code is not one you
selected to call back.
INSTRUCT Shown to the caller just before disconnect, explains to caller
what to do at his/her end.
NOTTIME Shown to the caller when you have configured to call LD
callers back but this is not the right time to do it.
Again, please take the time to view the enclosed sample files if you
are not quite able to make sense of any of the foregoing. Sometimes a
sample can be worth more that a thousand words...
Once you have edited the necessary files discussed above, you should be
ready to begin using MYCALBK. You may want to make a subdirectory from
your RBBS subdirectory and put all the MYCALBK files in it. For example
E:\RBBS\CALBAK (You can rename CALBAK as shown, to any legitimate DOS
subdirectory). Then put the MYCALBK files into it. The CALLBACK.BAT file
can be easily put into your RBBS subdirectory where RBBS can find and
read it instantly. It's only a few bytes in size. Don't forget to tell
the RBBS config (CONFIG) where the CALLBACK.BAT file is located. Use
RBBS config parameter 107 where you type the name of the CALLBACK.BAT
file for RBBS to find, and then check the security level for new users
for the verification, parameter 108. The enclosed CALLBACK.BAT file will
give you a sample of what to put in the CALLBACK.BAT file for those using
Ray Gwinn's XU/X00.
And while I have your attention, please don't forget to add a line to
you RBBS DOORS.DEF file so RBBS can readily find this program. The line
you type into your DOORS.DEF file should like something like the
following...
DOORS.DEF
CALLBACK,5,,D,"CALLBACK.BAT [NODE]",N,,
*REMEMBER* Do not call this .BAT file VERIFY. VERIFY is a DOS keyword.
For more explicit information regarding DOORING, please read the area
in the RBBS-PC Technical Reference Manual. It lists complete details
and several examples regarding the parameters required to operate doors
smoothly and efficiently with RBBS.
OUTPUT files generated by MYCALBK...
────────────────────────────────────
MYCALBK will generate files for you with relevant information pertinent
to the related activities of callers who are swept into the RBBS
registration door. The information generated is for the sysop's
information.
───────────
MYCALBK1.LOG
───────────
This file will list any errors that may have been caused by a faulty
installation. As an example, if you should accidentally put the
MYCALBK.CFG file into the wrong sub-directory, it will generate an
error messages as follows...
Couldn't find .CFG file!
If you should see such information, then it becomes quite clear as to
what your next step should be. ...A N D also the following...
SAMPLE ONLY! of the MYCALBK1.LOG file generated by MYCALBK.EXE
^^^^^^^^^^^^
MYCALBK 1.00 Firing up!
User on-line -> DAVE CHABUN @ 01:52:04 on 08-19-1992
FOSSIL present and ACTIVATED!
Initing modem, Try #1
Modem init response OK
Dialing 432-1097 Try # 1
Modem dial response
CONNECT 9600/ARQ
DAVE CHABUN @ 432-1097 Verified!
Upgraded security to 6
DAVE CHABUN Exited Door.
MYCALBK 1.00 Firing up!
User on-line -> BOB SINGLEMAN @ 14:58:23 on 08-19-1992
FOSSIL present and ACTIVATED!
Initing modem, Try #1
Modem init response OK
Dialing 457-0114 Try # 1
Modem dial response
CONNECT 9600/ARQ
BOB SINGLEMAN @ 457-0114 Verified!
Upgraded security to 6
BOB SINGLEMAN Exited Door.
MYCALBK 1.00 Firing up!
User on-line -> WIL MA @ 16:28:46 on 08-19-1992
FOSSIL present and ACTIVATED!
WIL MA aborted call back
WIL MA Exited Door.
MYCALBK 1.00 Firing up!
User on-line -> JOHN RIVEST @ 17:00:18 on 08-19-1992
FOSSIL present and ACTIVATED!
JOHN RIVEST aborted call back
JOHN RIVEST Exited Door.
────────────
VERIFIED.LOG
────────────
This file will hold the information regarding new callers to your RBBS.
You should note that this file is dynamically expanding, so keep in
mind that you have enough disk space to allow this file to grow by
leaps and bounds! The information listed contains the phone number of
the caller, the name of the caller, the date, and the time that the
caller used the MYCALBK door on your RBBS.
SAMPLE ONLY! of the VERIFIED.LOG file generated by MYCALBK.EXE
^^^^^^^^^^^^
403-475-3844 BUBBA SMITH 08-15-1992 12:31:45
403-672-0923 BILLY-JOE BOB 08-15-1992 15:17:42
403-461-5704 ELVIS PRESLEY 08-15-1992 17:25:05
403-437-1444 JO-DON BAKER 08-15-1992 19:10:11
403-961-3034 STEVE STEVENS 08-15-1992 20:56:01
403-456-9017 GLEN SATHER 08-15-1992 22:04:31
403-479-6239 WAYNE GRETZKY 08-16-1992 09:31:07
403-467-1117 MIMI LAMOUR 08-16-1992 10:51:40
403-962-0407 EDGAR HOOVER 08-16-1992 11:35:17
403-477-6475 CANDY SAMPLES 08-16-1992 17:54:25
403-469-3705 JOHNNY LARUE 08-16-1992 22:29:19
In conclusion, MYCALBK has proven to be highly reliable and stable on
the beta test sites, and on other systems that are currently operating
with this program. If you are an RBBS sysop in Canada, please feel free
to call the two systems listed at the end of this document,
Alberta One RBBS @8:990/105 -or- Alberta Express @8:990/106, for any
assistance you may require. If you are in the USA, please try your
best to get in touch with me, rather than Rod Bowman, who is very
busy looking after the RBBSnet worldwide network.
Registration...
───────────────
Dear fellow RBBS SysOp...
MYCALBK required considerable time and effort, and many updates with
suggestions and ideas from several participating beta test sites (in
the USA and Canada). Therefore if you like and use MYCALBK on a regular
basis on your RBBS, and you find it does exactly what it should do,
then please consider registering this quality RBBS utility.
Please review the enclosed REGISTER.FRM file and ensure you respond to
the questions accurately. I will then mail you your registration key,
netmail it to you, -OR- put in on hold in the P)ersonal downloads of my
RBBS for you to retrieve.
A financial contribution of $20.00 to $30.00 (US Funds) would be much
appreciated.
Payment may be made with certified cheque, money orders, or personal
cheque (Please note, personal cheques require a delay in processing).
Your support is much appreciated.
Thank you for supporting CALLBK...THE RBBS-PC caller verification
utility.
Steve Stevens The Neutral Zone 8:927/2
Queries? Feel free to...
1). Leave questions addressed to me Via NETMAIL
2). Call me VOICE @ (803)-393-0246
3). Call my BBS at (803)-395-6286.
4). Post a message in RBBS-PC, RBBS-SYSOP or RBBS-DEV Echos.
*** Special thanks to the following people and beta sites, in the
evaluating and for making helpful tips and hints, in the development of
CALLBK ***
Frank Harman Sysop of Alberta One RBBS (Canada) @8:990/105
Casey Vanloo Sysop of Alberta Express RBBS (Canada) @8:990/106
Fred Busteed Sysop of Arcs and Sparks RBBS (USA)
Rod Bowman Sysop of PC-Spectrum (tm) RBBS (USA) @8:8/8
Dan Shore SysOp of ShoreLine BBS (USA) @1:109/458
Plus several others who have slipped my mind at the moment.
─────── Without all of you, this would not have been possible.───────
RBBS-PC is copyright 1992 Tom Mack, and probably Ken Goosens. USA.
IBM is the registered trademark of International Business Machines. USA.
XU/X00 utilities, v1.01 is copyright 1990. Raymond L. Gwinn. USA.
USRobotics, and HST are trademarks of USRobotics, Inc. USA.
DESQview is the registered trademark of Quarterdeck Office Systems. USA.
MSGFORM.EXE is copyright 1990 Mike Zakharoff. USA