Documentation for Phone Line Watcher Version 0.53. **************************************************************************** COPYRIGHT NOTICE: © Copyright 1990 by Christian Fries. All rights reserved. This program is NOT in the public domain. This program may NOT be distributed by any commercial software of hardware vendor. This program may ONLY be distributed by non-profit user groups, networks, bbs's, and of course by Fred Fish. The Author cannot be liable for the use of misuse of this program. This copyright notice must be distributed with the program. If you find this program useful please send $5 - $10 (or equivalent in other currency) to one of the following adresses: Christian Fries Christian Fries c/o Fred Fries c/o Gudrun Horst Ferdinand - Dietz Straße 19 77, Rue des Romains D 5500 Trier L 2443 Senningerberg **************************************************************************** 0. Changes Version Changes to lower version ---------------------------------------------------------------------------- V 0.34 First version that successfully protokolls calls V 0.40 Protokoll stored in a file (no more output to CLI/stdout) V 0.45 Bugs on login removed. V 0.50 Bugs on login removed. Copyright notice added. V 0.52 Bugs on login removed (PLW crashed after sending GoodbyeFile). V 0.53 Bugs on login removed (Login with 300/1200/2400/4800/9600 Baud). V 0.54 Bugs on login removed. Windowing on Workbench Screen. View. 1. Preface ® The Phone Line Watcher is an program for all owners of a Hayes-Compatible Modem. The program will protokoll all incomming calls with date, time and the amount of rings. It also offers the possiblity to let other modem owners 'log in' and leave a message. 2. Protokolling of calls The program protokolls all calls with date, time and the amount of rings into a file called 'PLW.protokoll'. To prevent the loss of data the file is only opend while the program adds new data to it (e.g. while a message comes int). Therefor the data is not lost on a system crash and you can view the protokoll file even while PLW is running (exept if a messages comes in or new data is stored). If PLW is unable to open the file the message will be directed to the standart output (often the CLI window). Data will be always append to the protokoll file and so you can view the protokoll of several sessions, beause the program will never delete that file but append the line "Phone Line Watcher - Protokoll since [DATE] [TIME]" to the file on startup. So you should delete that file when you no longer need the old protokoll. 3. The Menus 3.1. Reset. This Command resets the program (clears buffers, sets counters to zero) and the modem (according to the stuff specified in the Setup menu s.b.). 3.2. Setup. This Command lets you specify certain parameters that are described below. The parameters are stored in 'S:PhoneLineWatcher.config'. - Ring Tolerance Time: The Program detects calls by the receiving of the 'RING' string from the modem. When it detects in a certain time intervall no more 'RING' it decsides that the caller hanged up and increases the call-counter and sets the ring-counter to zero. This time intervall is the 'Ring Tolerance Time' (specified in seconds). Usually eight to ten seconds are enough. - Auto Answer After this amount of RINGs the program send the ATA command to the modem, that lets the modem go off hook and send the answere-tone. You should set this number higher than 12 to prevent the bothering of innocent persons that don't like to 'log in'. You are able to switch the log-in feature off by setting this number to zero. - Maximum Online Time This number specifies the maximum amount of minutes that may the remote user look around inside your system. When the time is up the user will be disconnect even if he is about to leave a message. - Welcome File When the remote user is logged in the program will send this file. This file should be provided by you. This file has the same purpose than an spoken answere text on an phone-answere-machine (e.g. "I am shopping. Back at 15:00. Chris." or "On Vacation till 20 of March. Getting some sunshine. Chris."). - Goodbye File When the remote user selected 'Exit' in his menu the program will send this file. Maybe you can use it for a more personal goodbye text than "DISCONNECTING". - Master Password ® When a remote user is logged in he can select an access to AmigaDOS. This access is only permitted, if the user enters the Password specified here. NOTE: ACCESS TO AmigaDOS IS NOT IMPLEMENTED IN ANY VERSION LOWER THAN V0.70. - Baud Rate Please enter here the Baudrate that will be used on the serial port on startup and when the reset is selected. Your modem should support that rate of course. NOTE: THE BAUD-RATE OF THE SERIAL PORT IS SET TO THAT BAUD-RATE AND AN AT FOLLOWED BY AN [CR] (ASCII: 13) IS SEND TO THE MODEM. - 1st InitString This string is send to the modem after startup or after selecting reset followed by an [CR] (ASCII: 13). I recommend the use of ATZ as InitString1. - 2nd InitString This string is send to the modem after startup or after selecting reset followed by an [CR] (ASCII: 13). I recommend the use of ATB0V1X4 as InitString2. - Init delay time This is the number of seconds between the sending of InitString1 and InitString2. I recommend the use of 1 (One second) here. 3.3. View View shows the contens of the PLW.protokoll file. To hold the dispay simply hold the right mousebutton. 3.4. About Try is out. 3.5. Exit Frees all devices (timer, serial, console), frees memory, and shuts down the program. 4. The login-feature CAUTION: TO ENSURE A CORRECT DISCONNECTING IT IS ABSOLUTELY NECESSARY THAT THE TERMINAL (MEANS YOUR COMPUTER) HAS CONTROL OVER THE DTR (DATA TERMINAL READY) HANDSHAKE WIRE. PLEASE SET YOUR DIP-SWITCHES (ON MOST HAYES-COMPATIBLE MODEMS IT IS DIP- SWITCH 1) THAT YOUR TERMINAL PROVIDES THE DTR SIGNAL (ON MOST HAYES-COMPATIBLE MODEMS THE DIP SWITCH MUST BE IN THE UP POSITION). ALSO YOU SHOULD CHECK IF THERE IS A WORKING CONNECTION BETWEEN THE TERMINALS AND COMPUTERS DTR SIGNAL (CHECK YOUR CABEL - REPROGRAM IT IF YOU HAVE AN PROGRAMABLE CABLE). [TO CHECK: THE TR-LED SHOULD BE OFF WHEN THE PROGRAM IS NOT RUNNING AND ON IF THE PROGRAM IS RUNNING.] The login-feature displays a menu to the remote user. Currently only the 'leave a message' option is working. The terminal emulation accepts ASCII characters to edit the entered data (e.g. DELETE or BACKSPACE). Also it accepts the amiga console device commands (like CURSOR-KEYS - see RKM¹ for more. As CSI¹ $9B is accepted.) to edit the entered data. - leaving a message To leave a message the remote user has always the possiblity to edit one line (80 characters). After the line is full or the end is reached the data will be stored. 5. Comming Soon: * Transmission of Files in both direction (XMODEM). * Access to AmigaDos with a Password from remote. * Phonebook for easy-dial. 6. Bugs: A big bug is that the program does not yet hang up when the remote user selects 'Exit' in his menu. I don't know why that bug is there but I does not matter to you, because the modem simply keeps the line open. Then the remote user will disconnect sooner or later on his own and your modem will go back to command-mode because the carrier is lost. (The only one how probably will be hurt is the remote users phone bill.) Thanks to A. Soldo and H. Kopp for additional bug testing. Notes: ¹ RKM: Amiga ROM Kernal Reference Manual. Addison-Wesley Publishing Company, Inc. CSI: Console sequence introducer.