TriBBS CallBack Verifier version 2.0.2. Works
with modems 1200-16800. Multinode capable.
Major bug fixes. New reporting of errors.
Better loss of carrier detection. No more
device I/O errors. TriBBS 4.0 compatible.
Works with TriBBS 2.11 or later. Registration
is still $15.

CallBack
Callback Verifier for the TriBBS BBS
Copyright (C) 1992 by Adam Zuckerman
All rights reserved.
CallBack version 2.0.2 Page 1


Files included with this ZIP:

File Size Date Description
------------ -------- -------- ---------------------------------------------

CallBack.EXE 97,848 03-03-93 The executable file that performs the
callback verification.

CallBack.DOC 15,509 03-03-93 This document.

CallBack.CFG 949 07-30-92 This file is the configuration text for
CallBack.

CallBack.BAT 83 07-10-92 This file is the batch file that runs
CallBack.

BuildPH.EXE 44,088 10-26-92 The executable to build PHONES.DAT from your
TriBBS USERS.DAT file.

History.202 2,062 03-03-93 This file lists the changes for CallBack
version 2.0.2

JokePhon.DAT 190 03-03-93 This is the sample file for Joker phone
numbers and pattern matches.
CallBack version 2.0.2 Page 2

CallBack is shareware and is being released in a shareware fashion. Shareware
is a great concept. It allows you to try before you buy. Then you can decide
if this software fills your needs or not. The registration fee for CallBack is
$15 US. The registration fee gives you free updates (if there are any), a
printed manual, and the ability to upgrade the caller's security level and
remaining on-line time. For registration of $100 US, you will also get the
source code. Registration outside the US is $15 US. Registration outside the
US is limited to only those countries whose phone system uses US style phone
numbers (i.e. 404-292-5303). If your country does not use this style of phone
number, then send me private mail (see Support on how to contact me) and I will
make a version specific to your country. This software is the intellectual
property of Adam Zuckerman. You are given license to use the software for 30
days. If you do not register CallBack, you MUST discontinue its use. Please
support the shareware concept and register your copy of CallBack.


Now that the legal stuff is out of the way, we should begin our discussion of
CallBack. CallBack is a program written in PDS 7.1 (QuickBASIC Professional).
It allows your callers to be verified by your board. It will prompt the caller
for their data phone number and allow them to change it if necessary. It will
call back the user a specified number of times (sysop configurable). You can
use an unusual physical port address with CallBack. Upon verification, you can
add to the caller's time and security level (registered version only).


CallBack has been thoroughly tested under Desqview. The few problems that have
occurred have been related to opening a DOS window with communications set to
NONE. If this occurs (extremely remote possibility), have the caller attempt
the callback verification again. I have also been told to set Optimize
Communications to NO.
CallBack version 2.0.2 Page 3


The format of the configuration file is:

The Dining Room ; BBS name
Adam Zuckerman ; SysOp name
C:\TriBBS ; Path to TriBBS node 1
C:\TriBBS ; Path to current TriBBS node
COM1 ; Com port (1 or 2 only)
3F8 ; Com port physical address
ATM1E1Q0H0 ; Modem init string
ATDT ; Dialing prefix
CONNECT ; Connect message from modem
15 ; Security level after verification
10 ; Minutes to add to caller's time
3 ; Number of callback attempts to make
1 ; Long distance: 0-all, 1-drop, 2-none
15 ; Time to pause between attempts


All filenames must have the complete pathname for the file including the drive
letter specification. Expect the configuration file to change with any later
releases of CallBack. The configuration file has not changed between 1.2 and
2.0.2.


Now, let's look at the configuration file in detail. First, the first 2 lines
are self-explanatory.

The Dining Room ; BBS name
Adam Zuckerman ; SysOp name

Change these to suit your board. Next comes the pathes to TriBBS. Line 3 is
the path to your node 1 directory. If node 1 is in C:\TriBBS then you won't
have to change a thing. If you are running a single node system, line 4 will
be the same as line 3. Otherwise, you will need to change it to the full path
that leads to node 2 (e.g. Node 2 is in C:\TriBBS2, line 4 would be
C:\TriBBS2).

C:\TriBBS ; Path to TriBBS node 1
C:\TriBBS ; Path to current TriBBS node

Line 5 is going to be a bit tricky to explain. It must be COM1 or COM2. This
is the communications port name. If you are using COM3, then tell CallBack to
use COM1 and change the physical address in line 6. More on this in a minute.
Line 6 is the physical port address of the communications port. For COM1, it
is normally 3F8. COM2 is 2F8. COM3 is 3E8. And COM4 is 2E8. If you are
using COM3 or COM4, then you will have to change the physical port address in
line 6. If you are not sure what the physical address is, contact me directly,
via The Dining Room bbs (404) 292-5303. I'll get a program to you that will
let you know what your physical port addresses are. If you are using COM3 or
COM4, changing the physical port address will allow you to continue to use that
communications port. DOUBLE CHECK the physical port address if you change it.
If you put in a WRONG ADDRESS, YOU CAN HANG YOUR SYSTEM OR CAUSE DAMAGE TO YOUR
DATA.

COM1 ; Com port (1 or 2 only)
3F8 ; Com port physical address
CallBack version 2.0.2 Page 4


Line 7 is the initialization string for your modem. If your are using a HAYES
compatible modem, then the initialization string listed will work best for you.
Consult your modem manual to insure that the command echo is turned on,
responses are set to verbose (e.g CONNECT, BUSY, NO CARRIER), and your modem
goes on-hook (hangs up). It may be necessary to change the default init string.

ATM1E1Q0H0 ; Modem init string

Line 8 is the dialing prefix string needed to call the user back. For most
systems, the default is all you need. If you run your board out of a business
where dialing out requires a special code (e.g. 9 for an outside line), the
you would change line 8. If you have call-waiting, change line 8 to ATDT*70,

ATDT ; Dialing prefix

Line 9 is the message sent back from your modem indicating that a connection
has been made. Some modems do not send out a standard HAYES response. Change
this as necessary.

CONNECT ; Connect message from modem

Line 10 is the security level that a verified caller will receive upon
completion of the callback process (registered version only). If a caller
with a higher security level attempts to use CallBack, they will receive a
message stating that their security level is too high and be returned to the
board.

15 ; Security level after verification

Line 11 is the amount of time to add to a caller's on-line time once they have
been verified. This is an exclusive feature of CallBack (registered version
only). You can add from 0 to as many minutes as you want. Only TriBBS limits
what you can set. TriBBS will still limit the caller to the maximum time per
call set up in the node configuration.

10 ; Minutes to add to caller's time

Line 12 tells CallBack how many attempts to make to reach the caller at the
number supplied by the caller. Again, you can set this as high as you would
like.

3 ; Number of callback attempts

Line 13 sets CallBack to accept or deny long distance callbacks. Setting line
13 to 0 says to accept all callbacks. Upon verification, drop back to TriBBS
and continue. Leaving line 13 set to 1 will have CallBack accept the long
distance callback. Upon verification, the caller is told that their time and
security level have been upgraded (registered version only). It then tells the
caller that he/she will have the modem hang up. Changing line 13 to 2 will
tell CallBack not to accept any long distance callbacks.

1 ; Long distance: 0-all, 1-drop
CallBack version 2.0.2 Page 5


Line 14 tells CallBack how long to pause between callback attempts. I
recommend setting it to 15 secondes. If there is no value in this line, then
CallBack defaults to 15 seconds.

15 ; Time to pause between attempts



For the following examples, CBV1.BAT is used for the batch file name. If you
have 2 or more nodes, I recommend using CBV1.BAT for node 1, CBV2.BAT for node
2, etc. Also do the same with the configuration files (e.g. CBV1.CFG for node
1, CBV2.CFG for node 2, etc.). The default setup from me has the batch and
configuration files called CALLBACK.???.


Setting up CallBack as a door is fairly simple. The door type is T for TriBBS.
The batch file should be set up in the current node and look like the batch
file listed further down on this page. Security level should be set to your
new user security level.

T,Call Back Verifier,CBV1.BAT,10


Setting up CallBack in your NEWUSER.BAT is also fairly simple. Just have a
batch file that looks like this:

cd c:\TriBBS\doors\CallBack
CallBack CBV1.CFG
cd c:\TriBBS
board

CBV1.CFG is the configuration file for the current node.


CallBack can also be setup up as an extended menu command. Refer to the TriBBS
documentation for further details.


With release 1.2, I have included a utility program for building the PHONES.DAT
file. This program (BuildPH.EXE) will go through your USERS.DAT file, finding
all of you callers with a specified security level or higher, and build the
duplicate phone number data file (PHONES.DAT). This program requires your
CallBack.KEY to be in the same directory when executed. This utility is a one
time only kind of utility. Once you run it, it has built the PHONES.DAT file
for you. It won't be necessary to use it again (excepting any loss of data).
To start BuildPhone, type at the DOS prompt:

BuildPH C:\TriBBS C:\TriBBS\doors\CallBack 15

This will build PHONES.DAT with all callers from your USERS.DAT file with a
security level of 15 or higher. The first path is the path to TriBBS's node 1.
The second path is to CallBack's sub-directory (where PHONES.DAT is actually
located.
CallBack version 2.0.2 Page 6


Support

For support, I can be reached via TTN, SmartNet, AFS, or my board, The Dining
Room (404) 292-5303. The fastest way to reach me would be my board. Leave me
a comment. I will respond within 24 hours. I will help all users of CallBack.
If you are not registered, don't worry. I won't bite your head off. I will
help you with whatever problem you have.


Once you have registered, all subsequent versions of CallBack will accept your
registration key (thanks to Mark Goodwin for the idea).


Please fill out the enclosed registration form and mail it to:

Adam Zuckerman
1364 Debden Place
Stone Mountain, GA 30083-1212

Please make all checks payable to Adam Zuckerman.




CallBack Registration Form

+------------------------------------------------------------------------------+
| |
| Name:___________________________________ [] CallBack Registration $15.00US |
| [] Printed Manual N/C |
| Address:________________________________ [] Foreign Registration N/A |
| [] Source Code $85.00US |
| City:___________________ State:_________ [] Catalog of software N/C |
| |
| Zip Code:_______________ Zip+4:_________ |
| |
| Make checks payable to: Adam Zuckerman Total Enclosed $_____.___ |
| |
| What is the name of your BBS? |
| Name ___________________________________________ |
| Phone number: (_____)____-_________ |
| |
| Where did you get CallBack? |
| [] Local BBS Name ___________________________________________ |
| Their phone number: (_____)____-_________ |
| |
| [] Information Service [] America On Line |
| [] BIX |
| [] Compuserve |
| [] Delphi |
| [] GEnie |
| [] Other _______________________________________ |
| |
| [] Directly from me (Adam Zuckerman) |
| |
| [] Friend Name ___________________________________________ |
| |
| [] Shareware outlet house Name ___________________________________________ |
| 2.0.2 |
+------------------------------------------------------------------------------+