Copyright (C) 1995, 1996 by James Nerlinger All Rights Reserved CallUp v3.1 PPE CallUp is a Callback Verification program [PPE] for PCBoard v15.21 Please see HISTORY.DOC for revision information. If you are upgrading from a previous version please read the information in the UPGRADE section! ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 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 þ Logs reasons for unsuccessful callback attempts þ Allows for automated user deletions on basis of number of days since last call ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º R E G I S T R A T I O N º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ CallUp is shareware and totally uncrippled. Registration for CallUp is Free. 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. By registering, you let ME know that my PPE is being used! Registrations can be sent to: Access! Information Services C/O James Nerlinger P.O. Box 58505 Cincinnati, Ohio 45258-0505 (513) 244-2255 You may also send registrations via an email message to: Internet: jnj@ais-bbs.org FidoNet: 1:108/155 ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 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. Change to the directory where you are keeping CallUp (we suggest C:\PCB\PPE\CALLUP) and type PCBOARD /PPE:SETUP.PPE to setup your CALLUP.CFG file. You may also wish to manually edit this file. 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. ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º U P G R A D I N G I N F O º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ If you are upgrading from a previous version of CallUp, you may run the SETUP.PPE in your CallUp home directory to upgrade your files. To run this PPE simply change to the directory in which CALLUP resides and type PCBOARD /PPE:SETUP.PPE and it will automatically run. This PPE will update your CALLUP.CFG file to reflect the new changes made to subsequent versions of the program. You can also make these changes manually if you prefer by simply comparing the default CALLUP.CFG file to your existing version. You must first have copied the new files (excluding your existing, modified display files!) to your CallUp home directory from the compressed distribution file. Be careful when unpacking -- you won't want to lose any changes you may have made to files by overwriting them (especially your existing CALLUP.CFG and display files). It can also update your VERIFIED.DAT file as well (see below). You MUST update these two files in order for the new version to work! Depending upon how old your existing version of CallUp was, you may need to update the display files. Beginning with v2.á, RIP support was added. As such, all file extensions were removed from the display files. Sample display files in both @X format and RIP format are included. A special thanks goes out to Don Shriver who designed the RIP files. The VERIFIED.DAT file has a new format as well. Each entry must be of the following format in order for the PPE to detect previously verified users: 01/01/01 123-456-7890 :Joe User If an entry is not in the above format, then that entry will be skipped. If you run the SETUP.PPE file included with this version, you will find an option that will allow you to update it to the current date. ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º G E N E R A L I N F O º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Beginning with CallUp v3.0, full logging features are enabled. The system will note the reason a callback verification attempt is not successful, or that it was successful. It will also note the time, date, and phone number called. This is in addition to updating the 2nd Comment field in the user record and maintaining the VERIFIED.DAT file. Another new feature that began with v3.0 is the ability for CallUp to disregard information in the VERIFIED.DAT file on the basis of its age. If a user completed callback verification x number of days ago, you can tell CallUp to allow them to go through it again. The "x" number of days is configurable as line number 18 in the CALLUP.CFG file. By default it is set to a value of '0' which disables this feature. This feature is especially useful for SysOps who automatically delete users that have not called their system in x number of days. Finally, there is now included a file called SETUP.PPE which will upgrade you to the new version of CALLUP. Please see the upgrade section for more information. ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º C O N F I G U R A T I O N º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Filenames ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ 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. Putting a zero (0) on this line will disable this feature of CallUp. 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\PPE\CALLUP\CU Since the program automatically adds the node number to the end of the log file, you won't want to put more than 5 digits in the name of the logfile (we use only two in the above example). The node number and ".LOG" are appended by the PPE. VERIFIED.DAT #17 ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß This will allow you to optionally turn on or off the VERIFIED.DAT file. By default, this option is set to 1 (on). 0=Disabled 1=Enabled When To Ignore VERIFIED.DAT Entries #18 ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß This allows you to set a number of days after which an entry in VERIFIED.DAT will be ignored. This option is ideal for SysOps who automate deletions of users who do not call their system for more than x number of days. For example, if this were set to 180, then any user who had been verified MORE than 180 days ago would be able to go through callback again. If the user were verified say 30 days ago, then they would not be allowed. Setting this to 0 will disable this feature. LD Disconnect #19 ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß This allows the SysOp to determine whether or not long distance callers will be automatically disconnected upon successful verification -- i.e., let 'em call back on their own dime. By default this is set to ON -- meaning that all long distance callers will be disconnected once verified. Valid options are: 0=Disabled 1=Enabled ----------------------------------------------------------------------------- Local Mode Operation ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß In local mode CallUp runs it's course except the actual callback is just simulated. The user record on which this is run will be updated. 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. The only exception is if Line 19 is set to '0'. User security level record is increased, their number and name are added to the VERIFIED.DAT file, and configured number of days are added 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