home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
bbs
/
ezv133.zip
/
EZVERIFY.DOC
< prev
next >
Wrap
Text File
|
1994-02-21
|
17KB
|
478 lines
EZVERIFY 1.33
Copyright (c) 1993-94 by Mark Hanson
ALL RIGHTS RESERVED
Disclaimer
----------
This software and documentation are supplied "AS IS". The author
makes no warranty of any kind, either express or implied, with
respect to this software and accompanying documentation.
IN NO EVENT SHALL THE AUTHOR OF THIS SOFTWARE BE LIABLE FOR ANY
DAMAGES ARISING OUT OF THE USE OF THIS PRODUCT. YOUR USE OF THIS
SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE TERMS.
License
-------
EZVERIFY is not public domain or free software.
You are granted a license to use the shareware version of EZVERIFY
for an evaluation period of 30 days. After 30 days, registration is
required. The shareware version of EZVERIFY may be duplicated and
distributed for the purpose of evaluation only. No fee may be
charged for distributing the shareware version (other than an
administrative fee not exceeding $5).
Registration
------------
Features of the registered version include:
- The right to edit any or all of the external display files.
- The display of your BBS name when calling a user back.
- The display of your registration name when the program starts,
with no delay whatsoever.
To receive a registered version of EZVERIFY, you may print out and
complete the text file named "ORDER.FRM". If you cannot print the
order form, just write the equivalent information out by hand. Send
the order information, along with a check or money order for $20 in
US funds ($25 outside the US) payable to Mark Hanson to:
Mark Hanson
PO Box 10154
Rochester, NY 14610-0154
USA
After payment is received, a serial number based on your registration
name will be generated for you. Your serial number will be mailed to
you within 10 days. If you supplied a FidoNet address with your
information, your serial number will be netmailed to you.
When you receive your serial number, run the setup program and enter
your registration name and serial number. The registration name must
be typed EXACTLY as it appeared on the order form. Your personalized
serial number will work with all future releases of EZVERIFY.
Introduction
------------
EZVERIFY is an automated callback verifier created specifically for
Ezycom. EZVERIFY makes it unnecessary for a sysop to call BBS users
by voice to verify their phone numbers. By using EZVERIFY, you never
have to worry about people calling under duplicate accounts again!
EZVERIFY can automatically call back first-time callers. If the
caller's phone number is valid, EZVERIFY will instantly upgrade his
or her time limit and security level. EZVERIFY is multi-node aware,
and automatically detects which node it's running on.
Installation
------------
To install EZVERIFY, simply create a directory for it and copy the
distribution files to that directory.
After the files are in their own directory, create a menu option for
EZVERIFY using EZYMENU. The required fields for the option are:
Data: <path>\EZVERIFY.EXE *M
(where <path> is the drive/directory you installed to)
Menu Type: 7
(Menu Type 7 means "Shell to DOS program")
Sysops who run multi-node systems should have the TASK environment
variable set correctly. If you do not set TASK, placing -n*N on the
command line after EZVERIFY.EXE will specify the correct node number.
Please be sure that the EZY environment variable is set correctly.
After creating a menu option for EZVERIFY, you must run the setup
program to specify a few options. See the section on setup below.
Support
-------
EZVERIFY is supported on:
BBS: 1 X. I. S.
Where: Rochester, NY USA
Sysop: Mike Shimkus
Phone: (716) 671-7745
Speed: 12-14.4K v32
FidoNet: 1:2613/119
To download the latest version of EZVERIFY or to receive support,
sign on with the user name "EZVERIFY".
EZVERIFY may also be File Requested with the magic name "EZV".
Any questions or comments you have about EZVERIFY may be
addressed to "Mark Hanson" in the EZVERIFY support conference.
You may also send netmail to "Mark Hanson" at 1:2613/119.
Setup
-----
To set up EZVERIFY, first switch to the directory that contains the
program files. Then, run EZVSETUP. EZVSETUP allows you to change
many options concerning how EZVERIFY works.
The opening screen presents a main menu. Select a menu option by
clicking with the mouse, pressing enter, or hitting the highlighted
letter. Use the arrow keys or a mouse to move among menu options or
fields. The status line at the bottom of the screen provides a
description of each menu option and field.
Setup - System
--------------
Registration Name
-----------------
If you have registered EZVERIFY, enter the registration name as
it appears on the order form into this field.
Serial Number
-------------
Complete this field if you have registered EZVERIFY.
Local Area Code
---------------
EZVERIFY must be aware of your local area code to implement it's
intelligent dialing features. Even if you don't want to make
toll calls, be sure the local area code is correct.
Local Exchange
--------------
As with the Local Area Code, EZVERIFY must be aware of your local
telephone exchange. By having this information, EZVERIFY can
automatically build a list of calls that are local to you. In
North America, the exchange is the first three digits of your
phone number (without the area code).
Verify Only
-----------
If set to "Y"es, EZVERIFY will ALWAYS hang up on the user after
verification is complete. This is desirable to sysops who run
their BBS on "metered" phone lines.
Duplicate Check
---------------
If set to "Y"es, two events will occur:
EZVERIFY will record the phone number of every successful
verification in a file called "EZVERIFY.DUP".
If a user's phone number appears in "EZVERIFY.DUP",
verification will not proceed.
Use Alias
---------
If set to "Y"es, a user's alias will be used in preference to his
or her real name.
Enforce LOCAL.EZV
-----------------
If set to "Y"es, EZVERIFY will never ask a caller if the phone
number is a toll call. All local numbers must be defined in
"LOCAL.EZV" for this to work.
Verified Level
--------------
This field designates the security level to grant to a newly
verified user. This level must be defined in the BBS in order to
correctly set the user's time left after verification.
Flags A-D
---------
These fields indicate how to set a user's Ezycom "flags" upon
verification. Each flag has 8 positions. An "X" in a position
means "turn this position on". An "O" in a position means "turn
this position off". A "-" or space means "ignore this position".
Time To Bank
------------
If a value is entered in this field, the user's banked time will
be increased by this amount (in minutes) after verification.
KB To Bank
----------
If a value is entered in this field, the user's banked kilobytes
will be increased by this amount after verification.
User Comment
------------
If this field is not blank, the Ezycom "User Comment" will be
set to the this value upon verification.
Setup - Modem
-------------
You may define different modem information for each node of the
BBS. If you are running a multi-node system, press the PageUp
and PageDown keys to configure the modem for each node.
Init String
-----------
If this field is not blank, it will be sent to your modem before
EZVERIFY places a call to a user. There are 40 characters
available, to allow things such as turning the modem speaker off.
As in Ezycom, use a "|" character to represent a carriage return.
Dial Prefix
-----------
This is the prefix to send to the modem before a phone number.
For most modems, it should be "ATDT" for touch-tone dialing, or
"ATDP" for pulse dialing. Do NOT append a "|" character to it.
Hangup String
-------------
This is only used if EZVERIFY is having problems hanging up on a
user. For most modems, "ATH|" will work fine.
Redial Attempts
---------------
Set this to the maximum number of tries that EZVERIFY will make
at connecting to a user, not counting the first try.
Redial Delay
------------
Set this to the number of seconds to wait before redialing a
user's phone number (if the first attempt was not successful).
Setup - Toll Calling
--------------------
Allow Toll Calls
----------------
If set to "Y"es, EZVERIFY will place toll calls within the times
specified by you. If set to "N"o, EZVERIFY will never place a
toll call. EZVERIFY will always hangup on the user after a toll
call. If a toll caller is successfully verified, he or she will
be granted the access specified in this dialog box.
Toll Prefix
-----------
This specifies the digits to place before a phone number that is
a toll call. This will most likely be "1" in North America.
Auto Verify
-----------
If you don't want to make toll calls, you can set this to "Y"es
and long distance users will be granted the access specified
in this dialog box. This is provided so toll callers can be
granted at least slightly better access, even if they are not
called back.
Sunday-Saturday
---------------
These fields specify the start and end times to allow toll calls
on each day of the week. The times must be entered in 24-hour
format. To disallow toll calling on a specific day, enter 00:00
in each of that day's fields.
Remaining Fields
----------------
The remaining fields describe what should take place if a toll
caller is successfully verified (or "Auto Verified"). The fields
are independent and will not be combined with the similar fields
in "Setup - System" or "Setup - Age Checking".
SEE "Setup - System" FOR AN EXPLANATION OF THE REMAINING FIELDS.
Setup - Age Checking
--------------------
Age Checking
------------
By setting this field to "Y"es, EZVERIFY will check a user's age
upon verification. If the user's age is at or above the Minimum
Age, he or she will be granted the access specified in this
dialog box.
Minimum Age
-----------
The is the minimum age that a user must be to receive the access
specified in this dialog box. It is only effective if Age
Checking is turned on.
Remaining Fields
----------------
The remaining fields describe what should take place if a person
of the specified age is successfully verified. The fields are
independent and will not be combined with the similar fields in
"Setup - System" or "Setup - Toll Calling".
SEE "Setup - System" FOR AN EXPLANATION OF THE REMAINING FIELDS.
Setup - Local Calls
-------------------
This option brings up a miniature text editor to allow viewing
and/or changing the contents of the "LOCAL.EZV" file described
below.
Setup - Blocked Calls
---------------------
This option brings up a miniature text editor to allow viewing
and/or changing the contents of the "NOCALL.EZV" file described
below.
Phone Numbers
-------------
EZVERIFY only works with the numeric digits of a user's phone number.
Any formatting characters, such as dashes and parentheses, are
ignored. This way, it doesn't matter how a user's phone number is
formatted. EZVERIFY will always work consistently.
When EZVERIFY processes a user's phone number, it first strips out
any non-numeric characters. Then, if the phone number begins with
your local area code, it strips out the area code.
When entering phone numbers in "LOCAL.EZV" and "NOCALL.EZV"
(described below), it is important to not include the area code if it
is the same as your local area code. Also, never include any
formatting characters in a phone number. All numbers in "LOCAL.EZV"
and "NOCALL.EZV" must consist of numeric digits only.
LOCAL.EZV
---------
"LOCAL.EZV" is a normal ASCII text file used to automatically
determine if a number is local. The file can be edited with any text
editor or the editor built into EZVSETUP. If a user's phone number
does not match one in "LOCAL.EZV", he or she will be asked if it's a
toll call.
Each line of "LOCAL.EZV" should include a number that is known to be
local (excluding the local area code). An "X" can be used to
represent an unknown digit. Only the leftmost portion of the phone
number that is meaningful must be entered.
For example, let's assume that all the numbers you can call locally
begin with 762, 343, or 344. Your "LOCAL.EZV" file would look like:
762
343
344
If you don't feel like typing in all your local exchanges, EZVERIFY
can do it for you! Every time a local connection is made (that was
not previously known to be local), the exchange from the user's phone
number will be added to "LOCAl.EZV". After some time, EZVERIFY will
have automatically built a list of your local exchanges!
If you live in an area where some numbers in a different area code
are local, EZVERIFY can handle that also. Just place the area
code/exchange on a line of "LOCAL.EZV", including the toll prefix
before the number.
For example, let's assume that you are in area code 716, but
exchanges 589 and 483 of area code 315 are actually local to you.
Part of your "LOCAL.EZV" could include:
1315589
1315483
This is the only way EZVERIFY will dial local numbers in a different
area code.
NOCALL.EZV
----------
"NOCALL.EZV" is a normal ASCII text file used determine what numbers
should not be called under any circumstances. The file can be edited
with any text editor or the editor built into EZVSETUP. If a user's
phone number matches one in "NOCALL.EZV", he or she will receive a
message indicated the number is not callable.
Each line of "NOCALL.EZV" should include a number that you don't want
to be called. An "X" can be used to represent an unknown digit. Only
the leftmost portion of the phone number that is meaningful must be
entered.
For example, let's assume that you don't want EZVERIFY to call 911,
411, or 555-1212 in any area code. Your "NOCALL.EZV" would look like:
911
411
5551212
XXX5551212
External Text Files
-------------------
Nearly all of the messages in EZVERIFY are stored in external text
files. Registered users may edit these text files to their liking.
EZVERIFY supports ASCII and ANSI text files. ASCII files have an
extension of ".ASC", while ANSI files have an extension of ".ANS".
Users with Avatar support turned on will receive the ANSI versions.
The text file names (without the extension) are as follows:
EZV01 - Information and instructions
EZV02 - Final instructions
EZV03 - Password is correct and user is now verified
EZV04 - User is a toll caller and was auto-verified
EZV05 - User is already verified
EZV06 - Password was incorrect
EZV07 - User's phone number is a duplicate
EZV08 - User's phone number is a toll call
EZV09 - User's phone number is blocked
Logging
-------
Any fatal errors that occur during a verification are recorded in a
log file named "EZVERIFY.ERR". Each line of this file contains a
date, time, error code, and description. This file is for
informational purposes only, and may be edited or deleted at will.
Anything that happens, including fatal errors, is logged in a file
named "EZVERIFY.LOG". This file supercedes the "EZVERIFY.ERR" file.
If running on a multi-node system, EZVERIFY will maintain a separate
log file for each node.
Acknowledgments
----------------
Ezycom is copyrighted by Peter Davies.
Feedback
--------
Suggestions, comments, and criticisms are always welcome. The author
may be contacted via the methods discussed in the section on support.