home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 199 / 4PHONE.ZIP / 4PHONE.DOC next >
Encoding:
Text File  |  1992-04-16  |  6.0 KB  |  222 lines
  1.  
  2.  
  3.             Phone Utility for 4DOS
  4.  
  5.                   by
  6.  
  7.              Marshall E. Giguere
  8.              CIS ID: [71511,3513]
  9.  
  10.             Created: April 8, 1992
  11.              Last revised: April 16, 1992
  12.  
  13.  
  14.  
  15. Purpose:
  16. --------
  17.  
  18. Phone works in conjunction with a freeform text database as described
  19. in DB.ZIP.  Phone is a simple interface to your text database that
  20. can extract a series of records by a query string, extract the phone
  21. number from a selected record and then use your Hayes compatible
  22. modem as a dialer.
  23.  
  24.  
  25. Requirements:
  26. -------------
  27.  
  28. PHONE requires:
  29.  
  30.     * 4DOS version 4.0 or later
  31.     * DB utilities (DB.ZIP)
  32.     * GREP or FGREP text search utility
  33.     * ATMODEM (included)
  34.     * Hayes compatible modem
  35.  
  36.  
  37. Acknowledgements:
  38. -----------------
  39.  
  40. I would like to thank those people who have contributed either
  41. directly or indirectly to the PHONE utility. Donavon Kuhn and Jon
  42. Niedfeldt for their AT utility without which nothing would be
  43. possible and Myles Barrett for the original version of PHONE.BTM.
  44.  
  45.  
  46. Installation:
  47. -------------
  48.  
  49. The 4Phone utility consists of three parts: PHONE.BTM, DIAL.BTM and
  50. AT.COM.  The files PHONE.BTM and DIAL.BTM will be found in the ZIP
  51. file 4PHONE.ZIP.  The utility AT.COM will be found in the file
  52. ATMODEM.ARC contained in 4PHONE.ZIP.  Simply copy these files to
  53. where ever you keep your system utilities, e.g. \BIN.
  54.  
  55.  
  56. Using PHONE:
  57. ------------
  58.  
  59.  
  60. PHONE provides the interface to the DIAL.BTM phone dialer through a
  61. DB (freeform text database).  You place a call by first issuing the
  62. PHONE command with a search string.  The PHONE command has the form:
  63.  
  64.     PHONE search-string [number prefix]
  65.  
  66. Example:
  67.  
  68.     C:\ > PHONE Fred
  69.  
  70. The above causes PHONE to examine the DB file for instances of
  71. records containing the string "Fred".  PHONE the creates a pop-up
  72. select list containing all the records in your database that
  73. contained the string "Fred".  You may then select the proper record
  74. using the arrow keys on your keyboard and PHONE will then process the
  75. number and dial your phone.
  76.  
  77.  
  78. Configuring PHONE:
  79. ------------------
  80.  
  81. PHONE.BTM requires access to the text search utility FGREP for
  82. scanning the DB file and selecting records.
  83.  
  84. There are several variables used by PHONE to perform its function:
  85.  
  86.     Variable    Purpose
  87.     --------    -------
  88.  
  89.     %ac        set to contain your area code
  90.     %dbpath        the directory contaning your DB file.
  91.     %dc        contains the list of local codes.
  92.     %prefix        set to any prefix you want default is nothing.
  93.     %temp4dos    where 4DOS will create temporary files.
  94.  
  95. The variables AC, DC, and PREFIX will be found in the file PHONE.BTM,
  96. TEMP4DOS should be set in your AUTOEXEC.BAT file.
  97.  
  98.  
  99. Setting %AC:
  100. ------------
  101.  
  102. Set AC to your area code. PHONE uses this to determine if you a
  103. making a call outside of your area code and therefore need to prefix
  104. the phone number with a "1".  If your area code is 408 then change
  105. the SET AC= statement in PHONE.BTM as follows:
  106.  
  107. SET AC=408
  108.  
  109.  
  110. Setting %DC:
  111. ------------
  112.  
  113. The %DC variable is a comma seperated list of local codes, those
  114. local codes you may dial with out first dialing a 1.  PHONE uses this
  115. list to determine whether or not to prefix the selected number with a
  116. "1".  This list may be found in the front of your local phone
  117. directory.  Example:
  118.  
  119. SET DC=555,555,555,555
  120.  
  121.  
  122. Setting %PREFIX:
  123. ----------------
  124.  
  125. PHONE will prefix any phone number with the contents of this
  126. variable.  As installed %PREFIX is undefined.  If you are using PHONE
  127. from an office that requires you to dial an access number to get to
  128. an outside line you might define PREFIX to contain the access number,
  129. e.g. you need to dial a "9" to get an outside line:
  130.  
  131. SET PREFIX=9
  132.  
  133. PHONE will now prefix each phone number with a "9".
  134.  
  135.  
  136. Format of phone numbers:
  137. ------------------------
  138.  
  139. Phone numbers obey simple syntactic conventions. A phone number is
  140. simply a string of numbers preceded by the sentinel string "**".
  141. Some examples of valid phone numbers:
  142.  
  143.     **(555)-555-5555
  144.     **555-555-5555
  145.     **5555
  146.  
  147. Phone numbers may ONLY consist of the characters "0123456789()-#*.;".
  148. The characters ".;" are meta characters and change the behavior of
  149. PHONE.  Metacharacters have the following meaning:
  150.  
  151.     metacharacter    meaning
  152.     -------------   ------------------------------------------
  153.          .        if a number begins with the "." the number
  154.                  is simply dialed as is no attempt is made
  155.             to determine area code etc.
  156.  
  157.          ;        If a number is terminated with a ";" PHONE
  158.                  will place the modem into continued dialing
  159.             mode.  This allows you to continue entering
  160.             more numbers to be dial.  This is useful for
  161.             calling into automated systems, or networks
  162.             that require you to enter more codes.
  163.  
  164.  
  165.  
  166. Examples:
  167.  
  168.  
  169.     **.5555            Dail this number as is.
  170.     **(555)-555-5555;    Dial this number and wait for
  171.                 more dialing codes.
  172.  
  173. DIAL.BTM:
  174. ---------
  175.  
  176. DIAL.BTM provides the interface to your modem for the purpose of
  177. dialing a phone number.  DIAL also saves the last number dialed and
  178. allows you to continue entering dialing codes if a number is
  179. terminated with a ";".  Finally DIAL will allow you to edit a number
  180. if you a keypress is detected before dialing begins.
  181.  
  182.  
  183. Configuring DIAL:
  184. -----------------
  185.  
  186. DIAL.BTM contains the variable %PORT which tells DIAL which COMn: device
  187. your modem is connected to.  The currently set default value of %PORT
  188. is COM2:.  The %PORT variable MUST be set properly before using DIAL.BTM
  189. or DIAL will be unable to connect to your modem.
  190.  
  191.  
  192. Using DIAL:
  193. -----------
  194.  
  195. DIAL is normally called by PHONE, however, you may use DIAL as a
  196. standalone phone dialer.  The DIAL command has the following form:
  197.  
  198.     DIAL [phone-number[;]]
  199.  
  200.  
  201. Examples:
  202.  
  203.  
  204.     DIAL 555-5555
  205.  
  206.     Dials the number and exits command mode.  
  207.     NOTE:    You must pick up the hand set before
  208.         dialing is completed or the modem will
  209.         go on-hook (hang-up the line).
  210.  
  211.  
  212.     DIAL 1-555-5555;
  213.  
  214.     Dials the number and prompts for more dialing codes.
  215.     The modem stays off-hook and accepts further input until
  216.     a carriage return is entered, i.e. an empty line.
  217.  
  218.  
  219.     DIAL
  220.  
  221.     Redial the last number.
  222.