                      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

