ToneLoc v0.97 Reference Manual by Minor Threat & Mucho Maas This is the reference manual. You should read this AFTER reading TL-USER.DOC unless: 1. You are already familiar with Toneloc -or- 2. You want to get started quickly ------------------------ COMMAND LINE OPTIONS ------------------------ Here are the command line options for ToneLoc: Toneloc [DataFile] /M[Mask] /X[ExMask] /R[Range] /D[ExRange] /C[Config] /S[StartTime] /E[EndTime] /H[Hours] /Q /T[-] /K[-] ToneLoc must ALWAYS be run with at least one parameter, and if you only use one parameter it MUST be the dialing mask to use. If you only give ToneLoc one parameter, the first 8 characters of the dialing mask will also be the data file name. So if you run "TONELOC 555-XXXX", the mask will be 555-XXXX and the data file will be 555-XXXX.DAT. /M - Dial Mask. Use this parameter if you want to use a data file- name other than your dialing mask. /X - Exclude dial mask. This tells ToneLoc to -NOT- dial certain numbers. For example, if your local Police department has phone numbers ranging from 555-5000 to 555-5099, and you were using the dial mask 555-5XXX, use the exclude mask 50XX. This mask applies to the active part of the dial mask (in this case 5XXX) and therefore should be no more than 4 characters long. If an exclusion mask is longer than 4 characters, ToneLoc will ignore it. All exclusions must be sub-sets of the dialing mask. /C - Config File. This tells toneloc to use an alternate config file. The default is TONELOC.CFG, but you may change this for different types of scans. You might want to set up different config files for different kinds of scanning or for different kinds of modems. /S - StartTime. Tells ToneLoc to wait until a certain time to begin. You may either use military time or end the time with a "p" for P.M. Example: 5:30p and 17:30 are the same. /E - EndTime. Tells ToneLoc to STOP dialing at a certain time. Use the same notation as the /S parameter above. /H - Hours. Tells ToneLoc to dial for a certain number of hours after starting, and then exit. "/H5:30" would mean 5 hours, 30 minutes. /Q - Quiet. Tells Toneloc to suppress all sound. The speaker and all sounds will be turned off. /T - Sets the scan mode to look for tones, overriding whatever is specified in the config file. /T- will look for everything >except< tones. /K - Sets the scan mode to look for carriers, overriding whatever is specified in the config file. /K- will look for everything >except< carriers. These parameters may appear in any order, EXCEPT the first parameter MUST always be the datafile, and if you do not specify a dial mask with /M it MUST ALSO be the mask. ----------------- WHILE DIALING ----------------- While ToneLoc is scanning, there are several keys that do various things. Here they are: J - Pressing 'J' will Jump to a DOS shell. Upon returning, ToneLoc will redial the last number. N - This will "Note" the current number by putting a special entry in the logfile. It looks like this: "* Noted *". Use this if you want to remember this number for later. R - This will redial the current number. S - This toggles the modem speaker ON or OFF while dialing. Toneloc will play a noise to indicate the status of the speaker if sound is enabled. Once the current dial is finished the speaker will be toggled. X - This will extend the current dial time by 5 seconds. The meter will reflect the time addition. 0-9 - These are the modem volume changing keys. They will send the corresponding string in the config file to the modem. They work like 'S'. ! - This will write the file SNAPSHOT.DAT to the current directory. Exclude ranges will NOT be cleared from this .DAT file, so it can used to debug exclude ranges with Tonemap or Tlog. [Escape] - Pressing Escape will abort the current number and exit ToneLoc. ---------------------- CONFIGURATION FILE ---------------------- ToneLoc uses a configuration file. Before running ToneLoc, you need to edit this config file for your setup. The config file has a little bit of help in it, so it should be self-explanatory. But just in case, here's an explanation of each keyword in the configuration file. Port - This is which COM port to use. ToneLoc has been tested on COM1 - COM4 successfully. It should, theoretically, work up to COM16. See your FOSSIL documentation for details. Baud - This is the baud rate at which ToneLoc communicates with the modem. For a USRobotics HST or Dual Standard, it should be 38400. (No commas allowed). If you have problems with dropped characters, lower this to 19200 or 9600. Speaker - This tells if the modem speaker should start ON or OFF. The word "On" or "Off" should follow "Speaker". You may toggle the speaker while dialing by pressing 'S'. FoundSound - ToneLoc can make a noise when it finds something - if you want this enabled set it to 1. Sound - ToneLoc can makes noises for speaker toggles and volume changes. If you want to hear these sounds, set this to 1. InitString - This is the string that is sent to the modem when ToneLoc is first run. Usually this is ATZ. You may need to send other parameters like X7, &N1, etc. Use the characters | for [Enter] and ~ (tilde) for a 0.5 second delay. InitResponse - ToneLoc checks for this after initializing the modem. If the modem doesn't send this back, toneloc will try to initialize the modem up to 3 times. If it doesn't work, ToneLoc exits. DialString - This is the string to dial the modem. Usually "ATDT". If you need to dial *70 to disable call waiting, for example, add it here like "ATDT*70". Or if you need to dial "9" first, put it here. SpeakOn - String to send to the modem that turns the speaker ON. Usually "ATM1" or "ATM3". SpeakOff - Same as above, but to turn the speaker off. Usually "ATM0" Volume0-Volume7 - Strings that adjust the volume of the modem while dialing. Press '0' - '7' while dialing to adjust the modem volume. You could also use these as other macros besides volume. Hangup - String that tells the modem to hang up. Usually "ATH0" LogFile - File that toneloc logs it's activity to. Usually TONE.LOG CommandDelay - Delay between modem commands. Usually 200 or so. BetweenDelay - Delay between dial attempts. If you have 3-way calling, you'll need to set this to a higher number. BetweenWipe - How to 'wipe' the meter between calls. 1 = Ends to Middle 2 = Middle to Ends 3 = Backwards 4 = No wipe WaitDelay - How many milliseconds to allow each dial attempt before hanging up and trying the next number. Could be anywhere from 16000-45000; you'll have to experiment. NoDupes - This tells toneloc to never dial the same number twice within a dial mask. This should usually be on. MaxRing - This tells ToneLoc to abort the current dial after a certain number of rings. If set to 0 ToneLoc will not abort on rings. ScanType - Tells ToneLoc to scan for either Tones or Carriers, or everything except Tones or Carriers. 0 = Tones 1 = Carriers 2 = Everything except tones 3 = Everything except carriers IgnoreCD - If your modem always sets Carrier Detect (CD) as TRUE turn this on. Otherwise, turn it off. AutoSave - This is the number of minutes ToneLoc should wait between automatic backups of the .dat file. If set to 0 it will only save on exit. FoundFile - This is the name of the file where ToneLoc should store the found numbers (tones or carriers.) Blacklist - This is a file containing numbers you don't want ToneLoc to dial. You could put in your own numbers, your friend's numbers, the police department, etc. Random/Forward/Backward - ToneLoc's default mode is to dial numbers randomly without duplication, but it can also dial forwards and backwards sequentially. Set this to the keyword you want. Logging - This sets whether ToneLoc should keep a log file or not. ----------------- DESQview INFO ----------------- ToneLoc runs most excellently under DESQview. It will detect DESQview, and if DESQview is found, screen writes are directed to the screen buffer so your screen isn't trashed. ToneLoc also releases unneeded timeslices to DESQview. Because of this, ToneLoc uses VERY LITTLE CPU time, so you can run it in background with minimal slowdown. I tested ToneLoc with two windows open. One was a DOS window sitting at the prompt idle (doing nothing). The other was ToneLoc scanning. ToneLoc used about 10% of the CPU time, and the idle DOS window used about 88% (with about 2% DESQview overhead). The file "TL-PIF.DVP" is included with ToneLoc. To add ToneLoc to your DESQview setup, do the following: 1. Run DESQview 2. Choose "Add a Program" 3. Type 'O' for other 4. Enter the path where ToneLoc is found 5. Move the cursor bar to "ToneLoc" and hit [Space Bar] 6. Press [Enter]. ToneLoc will be added to the list of applications on your DESQview menu. To run ToneLoc, choose "TL" from the application menu. You will be placed at the DOS prompt with "ToneLoc " already typed. Just finish the command line and press enter. --------------- FOSSIL INFO --------------- ToneLoc also requires a FOSSIL driver. The two most popular are called X00 and BNU. Just call your local PD board and search for "FOSSIL", "BNU", and "X00". We like BNU because it is 7K and can be unloaded from memory. New versions of X00 may also be unloaded, but it requires more RAM. Both may be loaded HIGH if you're using QEMM-386. -------------------------------------------------------------------------- If this doc file sucks, please us know. -- Minor Threat -- Mucho Maas