home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / comm / ts3m.zip / DIALER.TXT < prev    next >
Text File  |  1994-12-08  |  25KB  |  617 lines
  1.     DIALER.EXE 1.1                Copyright (c) 1992 Joe Hayashi
  2.  
  3.  
  4.     A brief note:  Dialer is run automatically if you are using Telefile
  5.     with the proper dialer setup in telefile.ini.  You may contact
  6.     P. C. Softsmith for ASP level support for dialer.
  7.  
  8.     Dialer is a nifty utility -- read on ...
  9.  
  10.  
  11.     I.  What is dialer?
  12.  
  13.     Dialer is designed to be (as much as any program can be) the one pro-
  14.     gram you need to make all of your voice and data calls.   If you make 
  15.     a lot of calls, are constantly updating your phone lists, or frequently
  16.     travel between area codes, dialer could be for you. 
  17.  
  18.     I originally wrote dialer to work with stand-alone communications proto-
  19.     cols (specifically DSZ from Omen Technology).  With dialer and one of
  20.     these protocols (like DSZ, GSZ, Kermit, OZBEXT, or others) you get
  21.     most of the functionality of a more expensive (and sometimes less reli-
  22.     able) communications package.  Dialer has all of the features of the 
  23.     dialing portion of any good communications program.  I think dialer is
  24.     better in that you can 1) use a regular text file as a phone directory
  25.     2) use it to easily dial your voice calls, and 3) pick and choose
  26.     among a variety of free and inexpensive software to add whatever other
  27.     communications functionality you might need. 
  28.  
  29.     Probably the best thing about dialer is that it is easy to use for
  30.     making your voice calls.  If you travel between different area codes, 
  31.     just tell dialer which area code you are in and all the numbers in your
  32.     phone list that have this area code will be dialed as a local call--no
  33.     more editing phone lists!  When making voice calls, just hit any key
  34.     and dialer will hang up the modem and let you talk.  Dialer even has an
  35.     option to dial certain numbers as long distance calls even though they 
  36.     are in your local area code.
  37.  
  38.     More specifically dialer is a filter that takes text, parses a phone 
  39.     number, and dials the phone until it gets a connection.  The program is
  40.     easy to configure and was designed to work with short batch files.
  41.     Port & line settings can be set with a few simple switches.  Almost
  42.     everything about dialer is configurable.  Dialer requires a modem, 
  43.     DOS 3.x or higher, and 128k.  Best of all, dialer is free.
  44.  
  45. ________________________________________________________________________________    
  46.  
  47.     II.    How do I use dialer?
  48.  
  49.     Dialer works best with batch files. I've included some well documented
  50.     batch files that are easy to modify and should work for most people.
  51.  
  52.     Using dialer is something like this:
  53.  
  54.     dial Alice    or    dial Allen Barton    or     dial Compuserve
  55.  
  56.     With this distribution are 3 batch files: DIAL.BAT, LOOKUP.BAT, and 
  57.     BBS.BAT.  Also included is a sample phone number, NUMS.TXT, and a 
  58.     READ.ME file. The batch files rely on the DOS FIND utility to function.
  59.     If FIND is not your path, these batch files won't work.  In most cases 
  60.     if DOS is installed on your machine, FIND will be on your path.
  61.  
  62.     Description of included files:
  63.  
  64.     DIALER.DOC    The file you are reading.  
  65.  
  66.     DIALER.EXE    The dialer program.  Dialer is distributed as a 
  67.             compressed executable.  If you have weird iron and
  68.             suspect that the compression is causing problems, 
  69.             contact me and I'll send you the uncompressed
  70.             version.  I don't have an optimizing compiler so my
  71.             C programs tend to be larger than they need to be, 
  72.             hence the compression.
  73.  
  74.     LOOKUP.BAT    Batch file to find a person in your phone list.  Will
  75.             show you the entire phone list if given no arguments.
  76.             Type:    "lookup Eric" or "lookup"
  77.  
  78.     DIAL.BAT    Batch file to dial a person or bulletin board you
  79.             specify. You can use first or first and last names.
  80.             Case is important.
  81.             Type:    "dial Robert" or "dial Robert Tell"
  82.  
  83.     BBS.BAT        Batch file to dial a bbs and launch DSZ in terminal 
  84.             mode if you get a connection.  DSZ must be on your path
  85.             or in the same directory.
  86.             Type:    "bbs Compuserve"
  87.  
  88.     NUMS.TXT    Phone directory file.  Contains some sample numbers and
  89.             some hints on adding your own.
  90.  
  91.     READ.ME        Some notes on this and other versions of dialer.
  92.  
  93.  
  94.     Dialer has a lot of options.  The default options should be adequate
  95.     for nearly everyone.  In all likelihood you'll never have to read all
  96.     of the documentation.  
  97.  
  98.     If you think you know what you're doing, look at the batch files, edit
  99.     the phone list, and start dialing.
  100.  
  101.     If your modem seems to have taken a vow of silence or seems to be
  102.     speaking in tongues, make sure that you know how to specify the correct
  103.     COM port (see the C SWITCH below).  You might also check the I and D 
  104.     SWITCHES.
  105.  
  106.     If you're having problems figuring out why dialer isn't recognizing
  107.     your phone numbers, first check to make sure that you are using the 
  108.     batch files properly and then read about the S and X SWITCHES.
  109.  
  110.     If you plan to use dialer as the dialing portion of your communications
  111.     software or if you're a fan of DSZ or GSZ, be sure to read section IV
  112.     on other useful utilities.
  113.  
  114.     If you find yourself constantly editing your phone directory file and 
  115.     you've read the entire documentation, write me a letter.  I tried to 
  116.     write dialer so that you could use it with any text file of names and 
  117.     phone numbers.  If this is not working for you, let me hear about it 
  118.     and maybe I can suggest something or perhaps I'll rewrite the program.
  119.  
  120.     Happy dialing!
  121.  
  122. ___________________________________________________________________
  123.  
  124.     Dialer as used in TELEFILE.INI:
  125.  
  126.     [TELEFILE]  # TELEFILE initialization file
  127.     # $(NUMBER) is replaced by the telephone number at run time
  128.     dialer = echo $(NUMBER) | dialer /c2
  129.  
  130.  
  131. ___________________________________________________________________
  132.  
  133.     III.    The details - switches and miscellaneous stuff.
  134.  
  135.     Dialer accepts both slash (/) and dash (-) command line switches.  If 
  136.     you type "dialer /?" or "dialer -?" you should see this:
  137.  
  138.     dialer version 1.1 Copyright (c) 1992 Joe Hayashi
  139.     usage :    dialer [ options ]
  140.          /a# ignore area code #
  141.          /b# use # baud
  142.          /c# use # COM port
  143.          /d$ use string $ as dial command
  144.          /h  print this message
  145.          /i$ use string $ as modem initialization string
  146.          /l  turn off automatic 1 prepend for long distance numbers
  147.          /p# use # as minimum phone number length
  148.          /r  turn off redial mode
  149.          /s# parts of phone number are separated by # non-digits
  150.          /w# wait # seconds between redial attempts
  151.          /xc use character c as local long distance marker
  152.          /yc use character c as line settings marker
  153.  
  154.  
  155.     The following is a description of what the switches do.
  156.     -----
  157.  
  158.     A SWITCH
  159.     AREA CODES            /a#    or    /A#
  160.     I strongly recommend that you use full ten-digit phone numbers in your
  161.     phone list.  If you move your computer to another area code, just
  162.     tell dialer about it and all will be well.  If you live in Boston
  163.     you might specify the option like this:
  164.  
  165.         dialer /a617
  166.  
  167.     With this setting, all numbers in the 617 area code get dialed as
  168.     local numbers.  For numbers within the same area code that need to be
  169.     dialed as a long distance number, read about LOCAL LONG DISTANCE 
  170.     DIALING below.
  171.     -----
  172.  
  173.     B SWITCH
  174.     BAUD                /b#    or    /B#
  175.     I allowed you to set the baud in two places.  By default, dialer will
  176.     use 2400 baud.  If you have a 9600 baud modem, use 9600 as the default
  177.     and specify slower speeds for individual bulletin boards in your phone
  178.     directory file.  Read more about the phone list in the NUMS.TXT file
  179.     and under OTHER LINE SETTINGS below.
  180.  
  181.         dialer /b9600
  182.  
  183.     This would set dialer to dial out at 9600 baud.  If you only use dialer
  184.     for voice calls, you never have to worry about baud or other line
  185.     settings.
  186.     -----
  187.  
  188.     C SWITCH
  189.     COM PORT            /c#    or    /C#
  190.     If your modem is not connected to COM1, you need to inform dialer of
  191.     this. Dialer does not support more than 4 COM ports, if you try to 
  192.     specify a port higher than 4, dialer will default back to COM1.  
  193.     COM2 can be specified like this:
  194.         
  195.         dialer /c2
  196.  
  197.     If you use a member of the DSZ or OZBEXT family, dialer will use the
  198.     DSZPORT or OZPORT environment variables and you won't have to specify
  199.     the