Copyright (C) 1995 by James Nerlinger CallUp v1.9 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 (513) 244-2255 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............. ????????.DSP º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ 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.DSP - Shown immediately as users enter PPE. SELECT.DSP - Shown to caller at first phone number prompt. CALLING.DSP - Shown as system hangs up to call the user back. PASSWORD.DSP - Shown when successful connect has been made. UPGRADED.DSP - Shown when user has been successfully upgraded. LDCALLER.DSP - Shown to long distance callers just as systems disconnects. Display files shown as "errors" to the user: TOOHIGH.DSP - Shown to users who have too high a security for callback. ABORT.DSP - Shown to users who abort callback. ALREADY.DSP - Shown to users whose phone number is in the verified list. AC-NO.DSP - Shown to users with an area code that has been locked out. PRE-NO.DSP - Shown to users with a prefix that has been locked out. SUF-NO.DSP - Shown to users with a suffix that has been locked out. REFUSED.DSP - Shown to users whose entire number is locked out (banned). AC-LD-NO.DSP - Shown to users of area codes that are not configured. LD-NO.DSP - Shown to users who are attempting LD callback outside LD times. WRONG.DSP - Shown when an incorrect password has been entered. OUT.DSP - Shown after user has failed all password attempts. ERROR.DSP - 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! :-) ----------------------------------------------------------------------------- ----------------------------------------------------------------------------- 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... ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 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 (513) 244-2255 FidoNet 1:108/155 InterNet jnj@ais-bbs.org CIS 102104,175