home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: DFÜ und Kommunikation / SOS-DFUE.ISO / programm / dos / utility / qdial2 / qdial.doc < prev    next >
Encoding:
Text File  |  1993-12-04  |  9.5 KB  |  239 lines
  1.  
  2.   Quick Dial Version 2.0 (Shareware)                         November 1993
  3.   Copyright (c) 1992-1993 by Richard Cheung. All Rights Reserved.
  4.  
  5.   INTRODUCTION
  6.  
  7.     Quick Dial is a shareware program written in C programming language.
  8.     It allows you to dial a voice call using your modem and computer in DOS
  9.     prompt.  I have kept the program very small, so that it would only take
  10.     up a small space in your hard disk.  Quick Dial is a fully functional
  11.     Program.  There is nearly no installation at all.  It is marketed under
  12.     the shareware concept -- try it before you buy it.
  13.  
  14.   Files in this Quick Dial Version 2.0 package (QDIAL20.ZIP)
  15.  
  16.     QD.EXE        Quick Dial Program
  17.     QDIAL.DAT     Quick Dial Phone Book
  18.     QDIAL.CFG     Quick Dial Configuration File
  19.     QDIAL.DOC     Quick Dial Documentation
  20.     REGISTER.DOC  Registration Form
  21.  
  22.   EASY INSTALLATION
  23.  
  24.     1. Use a text editor to edit the qdial.cfg file, documentation is
  25.        provided inside the file itself. If you are using DOS 5.0 or higher,
  26.        you can use the command "EDIT QDIAL.CFG" without the quote.
  27.     2. If you want to be able to call the Quick Dial program, you first put
  28.        QD.EXE in a directory where the path can reach.  Second, you have to
  29.        set the environment variable QDIAL to the path where the phone book
  30.        (QDIAL.DAT) and configuration file (QDIAL.CFG) located.  However, if
  31.        phone book (QDIAL.DAT) are in the same directory with QD.EXE program,
  32.        then you don't have to set the qdial environment variable.
  33.  
  34.        For example, add this line in AUTOEXEC.BAT
  35.               SET QDIAL=C:\QDIAL
  36.        add the C:\QDIAL in the path too
  37.               SET PATH=C:\DOS;C:\BIN;C:\QDIAL
  38.        assumming the Quick Dial files are all in the directory C:\QDIAL.
  39.  
  40.     That's all about it, folk!
  41.  
  42.   DOS COMMAND LINE
  43.  
  44.     Usage  : QD [/?] [PhoneNumber] [PersonName]
  45.              /?          - display help information
  46.              PhoneNumber - Phone number to dial, no space in between
  47.              PersonName  - The Name in the phone data file, no space in
  48.                            between characters
  49.     Examples:
  50.  
  51.     QD /?
  52.         This will display a help information.
  53.  
  54.     QD 123-1234    or
  55.     QD 1231234
  56.         This will dial the phone number 123-1234 for you.
  57.  
  58.     QD john
  59.         This will dail the phone number of John for you provided that John
  60.         is entered in the phone book (qdial.dat) using a text editor.
  61.  
  62.         NOTE: the name is not case-sensitive, you can use all
  63.         lowercase(eg. john) even the name in the phone book is in
  64.         uppercase(eg. John or JOHN).
  65.  
  66.     QD jo
  67.         This will call the first person appeared in the phonebook with
  68.         "jo" as the first two characters of the name.
  69.  
  70.   HARDWARE REQUIREMENT
  71.  
  72.     1. Hayes Compatible Internal or External Modem 300 Baud or higher
  73.     2. Modem connected to serial port COM1, COM2, COM3, or COM4
  74.        (COM3 & COM4 are for 286 or higher IBM Compatibles only.)
  75.     3. Touch Tone/Pulse phone connected to the modem
  76.  
  77.     If you are not sure about the requirement, just try it and see if it
  78.     works for you.
  79.  
  80.   USAGE TIPS
  81.  
  82.     1. If you have a touch tone phone, you can put the S11=50 in your
  83.        modem initialization string to double the speed of dialing.
  84.        Of course, try and see if it works well on your phone system.
  85.  
  86.     2. Instead of putting a long first name of a person in the phone book,
  87.        you can just put a few letters to represent the person, so
  88.        that it will save you some keystrokes to dial.
  89.  
  90.        Example:
  91.         [In qdial.dat]  RCC 123-1234
  92.         [When dialing]  QD RCC
  93.  
  94.        You can still document the phone number by putting a comment line
  95.        after or before that.  A comment line is a line with a semi-colon
  96.        in front.
  97.  
  98.        Example:
  99.         [qdial.dat]     ;Name        Phone
  100.                         ;---------------------
  101.                         RCC          123-1234
  102.                         ;Richard Cheung
  103.                         PKS          222-3333
  104.                         ;Peter K. Simis
  105.                         ;---------------------
  106.  
  107.     3. You can even write a batch file for each quick dial call.
  108.  
  109.        Example:
  110.         [create john.bat]   QD john
  111.  
  112.  
  113.   PHONE BOOK FORMAT (QDIAL.DAT)
  114.  
  115.     You can only enter one name in the phone book for a person, in other
  116.     words, you cannot put both Last Name and First Name and then
  117.     the phone number together in one line in the qdial.dat file.
  118.  
  119.        For example:
  120.        John Smith 123-1234               <--- Invalid entry
  121.        JohnSmith  123-1234               <--- OK
  122.        John_Smith 123-1234               <--- OK
  123.        John       123 1234               <--- Invalid space in phone number
  124.        John       1231234                <--- OK
  125.        richard3   1-123-321-1234         <--- OK
  126.        richard1   1(800)-123-1234        <--- OK
  127.        page_peter 123-1234,,,,,454-6789  <--- OK, call peter pager number
  128.                                               and input return phone number
  129.                                               The commas will do time delay.
  130.  
  131.     In short, one continous string for name and another one for phone
  132.     number.
  133.     Name  - No space in between and can use any characters, except space.
  134.             Maximum 50 characters.
  135.             Must start with a letter.
  136.     Phone - No space in between, can use hyphen [-] or parentheses.
  137.             Maximum 50 characters.
  138.  
  139.   CONFIGURATION FILE FORMAT (QDIAL.CFG)
  140.  
  141.     COM_PORT
  142.       You can put 1, 2, 3 or 4 in this line, to represent COM1, COM2, COM3
  143.       or COM4.
  144.  
  145.     COM_SPEED
  146.       You can put 300, 1200, 2400, or 9600 baud speed depend on your modem
  147.       speed, however, for dialing, it will not make any noticable difference.
  148.  
  149.     DIAL_STRING
  150.       If you have a touch tone phone, use ATDT.  If you have a pulse phone
  151.       use ATDP.  If you always have to dial a 9, to dial out, then use
  152.       ATDT9, make sure no space in between the dialing string.
  153.  
  154.     INIT_STRING
  155.       You can put any initialization string here, this will be send before
  156.       the modem start to dial.  But usually, you don't need any
  157.       initialization string to make it work, you can even put a semi-colon
  158.       in front of this line to ignore the initialization.
  159.       Note: Actually, without initialization, the program will skip the
  160.             50ms delay before dialing.
  161.  
  162.     ASK_REDIAL
  163.       You can enable or disable the program to ask you if you want to
  164.       redial or not.  If you put a letter N, then redial will be done
  165.       automatically when busy signal is detected.  On the other hand, if
  166.       you put a letter Y, then a question will be prompted to ask if you
  167.       want to redial or not on a busy signal.
  168.  
  169.    QDIAL_PAUSE
  170.      This is the number of seconds it will waits before it redials the
  171.      phone number again.
  172.  
  173.   REVISION HISTORY
  174.  
  175.     1.0 - First released Initial Version
  176.     2.0 - Add re-dialing for busy phone
  177.           If QDIAL.DAT is located in the same directory as QD.EXE,
  178.           QDIAL dos environment variable is not necessary.
  179.           (To test the re-dialing feature, just dial your own phone
  180.            number your modem is using.)
  181.  
  182.   UPGRADE FROM V1.0
  183.     1. First make a backup of the old files QDIAL.DAT, QD.EXE, QDIAL.CFG.
  184.     2. Replace the old QDIAL.CFG, QD.EXE with the new one.
  185.        QDIAL.DAT format has not been changed.  Therefore, you can keep
  186.        all your phone entries.
  187.     3. Edit the QDIAL.CFG and make sure all setting is correct, such
  188.        as communication port, speed, etc. You can compare it with the
  189.        old QDIAL.CFG
  190.  
  191.     That's all.  Enjoy!
  192.  
  193.  
  194.   DISCLAIMER
  195.  
  196.     This program is provided AS IS without any warranty, expressed or
  197.     implied, including but not limited to fitfulness for a particular use
  198.     or purpose.  The author assumes no liability for any damages incurred
  199.     through the use of the program.
  200.  
  201.   PROGRAM REGISTRATION
  202.  
  203.     Quick Dial is a US $20 Shareware program.  This is not freeware or
  204.     public domain. Shareware is a mean of marketing commercial software.
  205.     You are required to register if you intend to use this program after
  206.     a 21 days of evaluation.  It is only $20, so please be generous. :-)
  207.  
  208.     You can fill out the registration form (REGISTER.DOC) together with a
  209.     registration Cheque payable to "Richard Cheung".  To print a copy of
  210.     registration form you can type COPY REGISTER.DOC PRN in DOS prompt.
  211.     After recieving your registration form, I will send you your
  212.     registration number, and a disk with the registered copy without the
  213.     registration reminder.
  214.  
  215.     QDIAL should be registered for the maximum number of copies that
  216.     will be used simultaneously.  Multi-site fees for commercial users
  217.     can be negotiated.
  218.  
  219.     Please feel free to upload this program to any local BBS or internet ftp
  220.     sites as long as the whole package is unchanged.  Vendors or distributors
  221.     who want to include this program in their library have to contact
  222.     author for permission.
  223.  
  224.     Please support the concept of shareware and register your copy now!
  225.     Have fun.  If you have any problem regarding the use of this program,
  226.     feel free to reach the author at the following address or by electronic
  227.     mail.
  228.  
  229.     Author : Richard Cheung
  230.     Address: 10753 Lawler Street, #10
  231.              Los Angeles, CA 90034
  232.              U.S.A.
  233.  
  234.              CompuServe ID: [70314,3070]
  235.     Internet Email Address: richardc@netcom.com
  236.                             70314.3070@Compuserve.com
  237.  
  238.   **** END OF QDIAL.DOC ****
  239.