HPAVC/HPAVC CD-ROM.iso/pc/PWAPCP01.ZIP/CU2B/CU-2BETA.ZIP/CALLUP.DOC

Text File | 1995-07-11 | 18.2 KB | 459 lines

                    Copyright (C) 1995 by James Nerlinger
                               CallUp v2.ß PPE


      CallUp is a Callback Verification program [PPE] for PCBoard v15.21

Please see HISTORY.DOC for revision information.

╔════════════════════════════════════════════════════════════════════════════╗
║  F E A T U R E S                                                           ║
╚════════════════════════════════════════════════════════════════════════════╝

 ■ Local only or local and long distance calling
 ■ Setting of times to allow long distance calling
 ■ Upgrade security level
 ■ Keeps track of verified numbers & names
 ■ Allows you to lock out area codes, prefixes, suffixes, or whole numbers
 ■ Runs in local mode and simulates the process so that you can see how
   it looks on your system.
 ■ Sets expiry date
 ■ Optionally updates comment 2 field of user record with fon#/date/time
   of verification
 ■ Checks for valid phone numbers
 ■ Fully configurable prompts and information screens
 ■ Disconnects after verifying long distance and toll callers
 ■ Maintains a complete log separate from its verified list

╔════════════════════════════════════════════════════════════════════════════╗
║  R E G I S T R A T I O N                                                   ║
╚════════════════════════════════════════════════════════════════════════════╝

CallUp is shareware and totally uncrippled.  Registration for CallUp is
$10.00. You may use this program for 30 days for evaluation purposes. If after
30 days you continue to use it, please register it.  Registration will remove
the "* UNREGISTERED *" notice at the beginning of the program.  :-)  When you
register, you receive a registration number.  This number will be good for all
future releases.

Registrations can be sent to:

        Access! Information Services
        C/O James Nerlinger
        P.O. Box 58505
        Cincinnati, Ohio 45258-0505
        [phone]

Please make checks payable to James Nerlinger.

╔════════════════════════════════════════════════════════════════════════════╗
║  I N S T A L L A T I O N                                                   ║
╚════════════════════════════════════════════════════════════════════════════╝
Installation is very simple as are all PPEs.  You can attach it to the command
list and run it as a command or you can run it as a door.

        1. Give PCBoard a way to call it up.

        2. Edit the configuration file "CALLUP.CFG" to suit your needs.

        3. Edit the "LOC_EXC.DAT File". With one on each line enter areacodes
           & prefixes which are local to you.

        4. Edit the "LC_EX_1.DAT File". With one on each line enter areacodes
           & prefixes which are local but require 1+prefix+suffix dialing.

        5. Edit the "AREACODE.DAT File". With one on each line enter areacodes
           you will long distance calling to.

        6. Edit the "TRASH.DAT File". With one on each line enter numbers
           you will not allow for call back.

        7. You should be ready to go!


There are a couple of ways you can install this PPE in your PCBoard.  One way
is to set it up as a door.  Another, and the way I do it on my system, is to
put it in a bulletin.  That way, whenever the user logs in they will get it.

PCBoard allows you to send users a bulletin dependent upon their security
level.  For example, if an user registers on my system they get an access
level of 10.  In my C:\PCB\GEN directory, there is a file called 10 (no
extension, just the two digits) that is displayed to all users with an
access level of 10.  This file has a single line:

!C:\PCB\PPE\CALLUP\CALLUP.PPE

This is the full path and filename of the PPE I wish to execute.  It works
like a charm.

I also have it set up in my CMD.LST file as an option from the main menu.
Just go into PCBSetup, edit your CMD.LST (follow the sample add-in commands
there) and then it will be accessible from your main menu.  You'll also want
to change your menu file so the users will know it is there.

╔═════════════════════════════════════════════════════════════════════════════╗
║  C O N F I G U R A T I O N                                                  ║
╚═════════════════════════════════════════════════════════════════════════════╝


╔══════════════════════════ Filenames ══════════════════════════════╗
║  Area Code file............  AREACODE.DAT                         ║
║  Program file..............  CALLUP.PPE                           ║
║  Instructions..............  CALLUP.DOC                           ║
║  Trashcan..................  TRASH.DAT                            ║
║  Verified Listing..........  VERIFIED.DAT                         ║
║  Exchange File.............  LOC_EXC.DAT                          ║
║  One Plus Exchange File....  LC_EX_1.DAT                          ║
║  Configuration file........  CALLUP.CFG                           ║
║  Internal File Description.  FILE_ID.DIZ                          ║
║  Revision History..........  HISTORY.DOC                          ║
║  Registration Form.........  REGISTER.FRM                         ║
║  Display files.............  ????????.                            ║
╚═══════════════════════════════════════════════════════════════════╝


Program File
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
CALLUP.PPE is the executable PPE program.

Instructions
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the documentation file with instructions (in other words, this file!)


Trashcan
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This should be the filename to the file that will hold all locked out
numbers.  It can be used to lock out any area code and/or prefix and/or
suffix and/or full phone number.

                (SEE TRASH.DAT FILE FOR EXAMPLES)

TRASH.DAT must be located in the CallUp PPE path

Verified Listing
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This should be the filename to the file that will hold verified
numbers & names. It is automatically updated as the program runs.

                (SEE VERIFIED.DAT FILE FOR EXAMPLES)

VERIFIED.DAT must be located in the CallUp PPE path

Exchange File
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This should be the filename to the file that will hold all local exchanges
to that only require prefix+suffix dialing.

If 513-244 is a local number and only requires prefix+suffix dialing, you
should have 513-244 in this file.

One area code-exchange per line.

LOC_EXC.DAT must be located in the CallUp PPE path

For at least this release, all numbers that are verifiable must be put in
this file.  Any area code-prefixes that aren't listed here will be treated
as long distance.

One Plus Exchange File
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This should be the filename to the file that will hold all local exchanges
to that require 1+prefix+suffix dialing.

If 513-244 is a local number and requires 1 plus dialing, you should have
513-244 in this file.

One area code-exchange per line.

LC_EX_1.DAT must be located in the CallUp PPE path

Area Code File
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This should be the filename to the file that will hold all area codes to
allow for LD callback.  If 513 area code is allowed for LD call back, you
should have 513 in that file.  In other words, ALL area codes that are to
be verifiable must be listed here.  One area code per line.

AREACODE.DAT must be located in the CallUp PPE path



Configuration File
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
File for definable configuration options.  Please see config file for more
info.

Revision History
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This file will list all updates and revisions to the program.

Registration Form
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Fill this out and mail it with your check to register this program!

Display Files
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
The following files are SysOp configurable and represent the files displayed
to the user during the callback verification process:


Display files shown during the course of CallUp:

WELCOME     - Shown immediately as users enter PPE.
SELECT      - Shown to caller at first phone number prompt.
CALLING     - Shown as system hangs up to call the user back.
PASSWORD    - Shown when successful connect has been made.
UPGRADED    - Shown when user has been successfully upgraded.
LDCALLER    - Shown to long distance callers just as systems disconnects.


Display files shown as "errors" to the user:

TOOHIGH     - Shown to users who have too high a security for callback.
ABORT       - Shown to users who abort callback.
ALREADY     - Shown to users whose phone number is in the verified list.
AC-NO       - Shown to users with an area code that has been locked out.
PRE-NO      - Shown to users with a prefix that has been locked out.
SUF-NO      - Shown to users with a suffix that has been locked out.
REFUSED     - Shown to users whose entire number is locked out (banned).
AC-LD-NO    - Shown to users of area codes that are not configured.
LD-NO       - Shown to users who are attempting LD callback outside LD times.
WRONG       - Shown when an incorrect password has been entered.
OUT         - Shown after user has failed all password attempts.
ERROR       - Shown for general errors (as in those in the program).

Canned versions of these have been included -- by all means create your own
and be imaginative!  :-)  By adding a "G" or a "R" to the default name, you
can use separate files for ASCII/ANSI/RIP.  There are some default RIP
screens included to get you started.

-----------------------------------------------------------------------------
-----------------------------------------------------------------------------

Configuration File
~~~~~~~~~~~~~~~~~~

Registration Name Line #1
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
The name used in registration.  Must be entered exactly as it appears on your
registration.  *** THIS IS CASE SENSITIVE ***


Registration Number Line #2
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
The number which is your registration number.  Put any number if you are
not registered.


Max Security Level Line #3
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the max security allowed to access this program.


Security Level Adjustment Line #4
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the security level the user will get if call back is a success.


Password Failures Allowed Line #5
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the number of password failures allowed before the user
is disconnected.

Expiration Date Increase Line # 6
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the number of days to add the users current expiration date
if call back is a success.  CallUp will add this number to the current date.
For example, if today's date was 02/01/95 and the number here was 14, then the
user's expiry date would be change to 02/15/95.

Number Of Local Call Back Attempts Line #7
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the number of call back attempts to be made if the caller is
Long Distance.


Allow or Disallow Long Distance Calling Line #8
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is set to allow or disallow long distance call backs.

    0 = False/No, Do Not Allow Long Distance Call Backs
    1 = True/Yes, Do Allow Long Distance Call Backs


Number Of Long Distance Call Back Attempts Line #9
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the number of call back attempts to be made if the caller is
Long Distance.


Long Distance Calling Start Time Line #10
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the time to start allowing long distance call backs.

In 24 hour format. HH:MM

HH:MM HH:MM          The first  time is for Monday->Friday
     ^               The second time is for Sunday
     |
     |<-Make sure you place a single space here

Calling is allowed any time on saturday


Long Distance Calling Stop Time Line #11
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is the time to stop allowing long distance call backs.

In 24 hour format. HH:MM

HH:MM HH:MM          The first  time is for Monday->Friday
     ^               The second time is for Sunday
     |
     |<-Make sure you place a single space here

Calling is allowed any time on saturday


Allow Typing In Phone Number #12
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This allows the user to type in a phone number other than the voice or
data number in their users record.

0 = False/No, Do Not Allow User To Type In A Number
1 = True/Yes, Do Allow User To Type In A Number


Seconds To Wait For Connect #13
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This is how many seconds you will allow for the modems to connect before
call back retry recycles.

NOTE: This should not be set higher that your modems
      S7=?? register (remote carrier wait time).

Modem Init String #14
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This line allows you to send any modem init string you may require just
prior the dialing.   If left blank, it will only send  "AT" the your modem.

Update Comment Field 2 #15
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can optionally enable CallUp to update the Comment Field 2 in the user's
record with the full phone number verified, and the date and time of
verification.

                                  0=Disabled
                                  1=Enabled

Logfile Pathname #16
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You may optionally enable CallUp to maintain a separate logfile of all
activity.  If you do not wish to enable this feature, this line should be
set to NONE.  If you wish to enable the logging feature, simply place the
full pathname of the logfile in this field like so:

                        C:\PCB\CALLUP.LOG

-----------------------------------------------------------------------------




Local Mode Operation
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
In local mode CallUp runs it's course and except the actual callback
is just simulated.

 !!!!!!!!! NOTICE !!   User records will be updated !! NOTICE !!!!!!!!!!!!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This allows you to get a look and feel of how CallUp works.



General Operation
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
What follows is a step by step operation of CallUp:

NOTE : Your configuration may alter and/or remove some of the steps.

Security levels are checked.
If they are higher than the Maximum Level they are also brought back
to PCBoard.

They are asked if they want to call back their (V)oice or (D)ata number
from their user record, or if that want to (E)nter a different.  If it is
found that the phone number is not in a valid format, they will be asked to
re-enter it correctly (same as if they had selected 'E').


The user enters their choice of  phone numbers.  If the phone number in
their user record is incomplete (not in xxx-xxx-xxx or (xxx)xxx-xxx format)
they will be forced abort.


Duplicate numbers and disallowed numbers are checked for.
If a duplicate and/or disallowed number is found program aborts.


The number is checked to see if it is long distance using the  Exchange File.
The Bad Number File is also check to insure that they are not a problem
user/banned from the system. If their area code and/or prefix and/or suffix is
not allowed they are displayed a message letting them know that their number
is not allowed for call back.


If Long Distance caller, it checks to see if the current time is allowed
for long distance calling.


The actual dialing string is created according to your settings.


CallUp drops carrier, delays for a moment and then initializes the modem.


CallUp attempts the callback the configured number of times and waits
the configured number seconds for a connection on each attempt.


If a connection is made then CallUp will prompt them for their password.
They get the configured number of tries to enter the correct password
or they are disconnected.


All Long Distance Call Backs Are Disconnected After Call Back
Successful Or Not.   This is hard-coded and may not be altered.


User security level record is increased, their number and name are
added to the Trash can file, adds configured number of days to their
expiration date if the call back was a success.


I think that's it...<g>



╔════════════════════════════════════════════════════════════════════════════╗
║  Q U E S T I O N S   &   C O M M E N T S    ( B U G S )                    ║
╚════════════════════════════════════════════════════════════════════════════╝

I would think that this PPE would work without any problems, but well...  If
you have any problems or questions feel free to get in touch with me.

If you like the program and would like some additions please let me know.
Even if you don't like the program, or don't continue to use it still drop me
a note and let me know you gave a looksee and what you think.  :-)

James Nerlinger
Access! Information Services
[phone]
FidoNet  1:108/155
InterNet [e-mail]
CIS      102104,175