------------------------------------------------------------------------- Courier Caller ID PPE Version 1.32 8-1-96 Written by Joseph C. Frankiewicz Support BBS: 847-843-2871 ------------------------------------------------------------------------- Version 1.32 corrects the following problem found in version 1.31B: If the "NMBR" field of the Caller ID info is the last item in the CID sequence, the PPE would mistakenly report that the CID info was missing. To install this update, simply copy the new PPE file over the old one. No other changes are needed. ------------------------------------------------------------------------- CCID is a PCBoard PPE program designed for use with the US/Canada version of the USRobotics Courier V.Everything modem. It may work with other brands or models, but it hasn't been tested that way. There is no "registration" needed for use of this software, it's free. This software has no guarantee or warranty of any kind. If you have a problem with it, I will try to help you as best I can, but remember that the software is free. This is the third public release of this software. It has been tested on a multi-node system running under Desqview+Lantastic, and on a single-node system under DOS. Bug reports and feature suggestions are welcomed. ------------------------------------------------------------------------- The program does the following things: 1. It creates a log file in the following format, 1 entry per line: X YYYYYYYYYYYYYYYYYYYYYYYYY ZZ-ZZ ZZ:ZZ ZZZZZZZZZZZ ZZZZZZZZZZZZZZZ Where: "Y" is the User Name (up to 25 characters) "Z" is the Caller ID info "X" is one of the following characters: space = Caller ID matches User Record O = Caller ID reports "OUT OF AREA" P = Caller ID reports "PRIVATE" ! = Caller ID does not match User Record ^ = Caller ID found in Trashcan file, caller was disconnected * = Something went wrong, see message to Sysop 2. The "P", "!", "*", and "^" types can trigger an automatic message to be sent to the SYSOP. This feature is controlled by the config file. The message contains details of the call, and can be read by logging in as the Sysop and reading your mail. 3. If the Trashcan file is present, and the Caller ID number matches any one of the numbers in the trashcan file, the caller is disconnected. ------------------------------------------------------------------------- This PPE does not display anything to the caller, it just quietly alerts the Sysop. The name and location of the log file is specified in the config file. The log file is written in append mode, it doesn't disappear unless you delete it yourself. This file can get pretty big, so keep an eye on it. The Trashcan file (if used) must be located in the same directory as the PPE, and must be named the same as the PPE, with a .TCN extension. (Example: CCID.TCN) Enter the complete phone number as returned in the Caller ID info, one entry per line. The config file must be located in the same directory as the PPE, and must be named the same as the PPE, with a .CFG extension. (Example: CCID.CFG) Config file format: Line 1: Y or N, controls logging of calls that match the User Record Line 2: Y or N, controls logging of OUT OF AREA calls Line 3: List of node numbers that the PPE should NOT be used on Line 4: Y or N, controls the sending of auto-messages. Line 5: The name/location of the log file. Line 6: Y or N, controls use of modem ATI15 command Line 7: Escape Character for ATI15 mode Example: Y Y 0 Y C:\PCB\CIDLOG.TXT N 128 Explanation of example: Line 1: Calls that match the phone number found in the User Record will be recorded in the log file. If you only want the "bad guys" recorded in the log, set this to N. Line 2 Calls that are OUT OF AREA will be recorded in the log file. If you don't want the OUT OF AREA calls in the log, set this to N. Line 3: If you have a multi-node system, and one or more nodes do NOT have Caller ID, list them here so the PPE will not try to process CID for that node. If you have more than one node to avoid, list each one with a space in between. If ALL your lines have Caller ID, leave this line blank or "0". Line 4: The PPE will send a private message to the Sysop when the Caller ID is missing, private, or doesn't match the User Record. Line 5: The location of the log file. Do NOT point this at the PCBoard caller log. Line 6: This causes the program to directly interrogate the modem for the Caller ID info, instead of using PPL's built-in Callid() function. This works only with the USR Courier modems, and the modem must be configured to allow entry into Online Command Mode. If you do not understand how to do this, do not use this option! This feature is intended for diagnostic purposes, in cases where PCBoard/PPL "loses" or "forgets" the Caller ID info. Line 7: The escape character used to put the modem into command mode, when using the option described above. Values of 0-127 can be used to match the modem's S2 register. A value of 128 assumes that the modem is set to &D1, and command mode will be entered by briefly toggling DTR. For more information about Online Command mode and modem init strings, see the documentation for my STPCB PPE. ------------------------------------------------------------------------- This PPE can be installed in a text file or as a logon SCRIPT. (NOT in $$LOGON.BAT) I do not recommend installing it in the NEWS file, as this can be bypassed under some circumstances. The LOGON SCRIPT is the most secure place. (File Locations -> New User/Logon/Logoff -> Name/Loc of Logon Script) Also, make sure you have (Configuration Options -> Logging Options -> Log Connect String to Disk) set to "YES". See your PCBoard manual for further installation instructions. ---[End]-----------------------------------------------------------------