home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / WDIAL110.ZIP / WDIAL.DOC < prev    next >
Text File  |  1993-08-16  |  7KB  |  197 lines
  1. Wdial is an autodialer for modems with the hayes/AT-command set
  2. operating under Microsoft Windows 3.0 or later.
  3.  
  4.  
  5. Starting the program
  6. -----------------------------------------------------------------------
  7.  
  8. To start the program use the following command line :
  9.  
  10.     wdial <parameter file>
  11.  
  12. <parameter file> is a pathname to the file containing the dialing
  13. parameters. The file name is used as is to open the file for reading.
  14. If no filename is given, wdial defaults to the file PHONE.LST in the
  15. directory of the executable. (See the section 'Parameter file format'
  16. for details on the file format.)
  17.  
  18. You'll probably want to add wdial as a Program manager item. To do
  19. this, use Program Manager's File/New-menu entry.
  20.  
  21.  
  22. Exiting from the program
  23. -----------------------------------------------------------------------
  24.  
  25. Use the Quit-button to exit wdial.
  26.  
  27.  
  28. Using the program
  29. -----------------------------------------------------------------------
  30.  
  31. Select the desired entries from the list box and then click the
  32. OK-button to start. The OK-button now changes to Cancel-button
  33. which can be used to cancel the dialing, after which a new set of
  34. entries can be selected. The Clear-button can be used to clear all
  35. selections.
  36.  
  37. When started wdial starts to go trough the selected entries
  38. sequentially, starting again from the first, as the last one has
  39. been processed. It stops when the local modem has connected to
  40. a remote modem, when the user stops it by clicking the Cancel-
  41. button, when no entries remain (see Notes section below) or when
  42. an error occurs.
  43.  
  44.  
  45. Parameter file format
  46. -----------------------------------------------------------------------
  47.  
  48. The file consists of three line entries separated by blank line(s).
  49.  
  50. When reading the a line, trailing whitespace characters are ignored.
  51. If the character '#' is encountered the rest of the line is ignored.
  52. A line containing a '#' as its first non-whitespace character is
  53. treated as an empty line.
  54.  
  55. Entry format :
  56.  
  57. <entry name>
  58. <phone number / modem command>
  59. <COM<port>:<bps>,<parity>,<databits>,<stopbits>>
  60.  
  61. <entry name> specifies the name by which you select the entries
  62. when running wdial.
  63.  
  64. <phone number / modem command> specifies a phone number or a literal
  65. modem command related to the entry.
  66.  
  67. The following escape sequences can be used :
  68.  
  69.     \r : <cr>
  70.     \p : pause for 0.1 s before sending next character
  71.     \P : pause for 1 s before sending next character
  72.  
  73. <COM<n>:<bps>,<parity>,<databits>,<stopbits>> specifies the com-
  74. port and line parameters used :
  75.  
  76.     <n>        : com-port number (1 - 4)
  77.     <bps>      : communication speed (e.g. 1200,2400,4800,9600,19200)
  78.     <parity>   : parity (N/E/O)
  79.     <databits> : databits (7/8)
  80.     <stopbits> : stopbits (1/2)
  81.  
  82.  
  83. Sample parameter file
  84. ----------------------------------------------------------------------
  85.  
  86. #
  87. # INITIALIZE : load defaults / enable result codes
  88. # word result codes / wait 30 s for carrier
  89. #
  90.  
  91. INITIALIZE
  92. ATZ Q0 V1 S7=30
  93. COM2:2400,N,8,1
  94.  
  95. #
  96. # A hangup command entry must be
  97. # provided for all used speeds.
  98. #
  99.  
  100. HANGUP 2400
  101. \P+++\P\PATH0
  102. COM2:2400,N,8,1
  103.  
  104. HANGUP 1200
  105. \P+++\P\PATH0
  106. COM2:1200,N,8,1
  107.  
  108.  
  109. # phone numbers
  110.  
  111. University modem bank
  112. 123456
  113. COM2:2400,E,7,1
  114.  
  115. Max's BBS
  116. 654321
  117. COM2:1200,N,8,1
  118.  
  119. Notes
  120. ----------------------------------------------------------------------
  121.  
  122. If the first character of a <phone number / modem command> entry
  123. is not a digit, the string is sent to the modem with a CR added to
  124. the end. If the first character is a digit, the modem command ATD
  125. is added before the string and a CR is added to the end of it
  126. before sending it to the modem.
  127.  
  128. After sending a dial or other command string, wdial waits for a
  129. result code from the modem. Upon receiving a code, one of the
  130. following actions is taken depending on the particular code :
  131.  
  132.     OK, ERROR : proceed to next, skip this in the following rounds
  133.     CONNECT   : stop dialing
  134.     other     : proceed to next
  135.  
  136. If no result code is received within 60 seconds, a timeout occurs.
  137.  
  138. When comparing the result code string against CONNECT, wdial is
  139. satisfied with a string beginning with CONNECT.
  140.  
  141. It is required for correct operation, that the modem responds to
  142. commands with the word response codes. Therefore, when using
  143. literal modem commands be careful not to affect the result codes.
  144. Usually, the word result codes are used by default. If this is
  145. not the case, you need to send the AT-commands Q0 V1 to the modem
  146. before dialing. This is best done by creating a literal modem
  147. command entry containing those commands. Such an entry should be
  148. placed before the phone number entries, so that you can select it
  149. along with the phone numbers required and it gets fed to the modem
  150. before any dialing command. Because of the action upon the OK or
  151. ERROR result code, such an initialization string is sent to the
  152. modem only once and skipped in the following rounds.
  153.  
  154. If you want to explicitly specify a dial method, use the appropriate
  155. dialing command in the phone number entry instead of plain phone
  156. number (ATDP for pulse dialing, ATDT for tone dialing).
  157.  
  158. Note that all the dial modifiers in the AT command set can be used
  159. in a plain phone number entry (as long as it begins with a digit).
  160.  
  161. If your modem doesn't detect when the line is busy and in that case
  162. respond with the BUSY result code, you might want to modify the
  163. modem's carrier wait time. Use the AT-command S7=NN to set the
  164. timeout to NN seconds.
  165.  
  166.  
  167. Bugs and caveats
  168. ----------------------------------------------------------------------
  169.  
  170. Wdial doesn't always respond immediately to a Cancel- or Quit-button
  171. press. This is because it calls Yield() (instead of returning from
  172. the message handler function) at some points such as while waiting
  173. the delay specified by the \P escape sequence to complete, and hence
  174. the processing of the messages generated by the buttons is delayed.
  175.  
  176. Wdial.exe 1.00 was by accident marked for Windows 3.1 or later,
  177. though it should work from 3.0. This has been corrected with 1.01.
  178.  
  179. The former versions of this file had the parameter file examples
  180. all wrong : the command/phone number and line parameter lines had
  181. swapped places. This has now been corrected.
  182.  
  183. There have been quite substatintial changes in Wdial code from
  184. version 1.01 and earlier. Hence, I think the minor version number
  185. should increase all the way to 1.10 although the only impact actually
  186. visible to the user is that Wdial now shows up in the Task List as
  187. supposed.
  188.  
  189. ----------------------------------------------------------------------
  190. Copyright (C) 1992, 1993 Jouni Leppäjärvi. This version (1.10) of
  191. wdial may be used and distributed freely. The program and the
  192. documentation are provided 'as is' with no warranty of any kind.
  193. I assume no responsibility for any damage or loss caused by this
  194. software either directly or indirectly. Comments, suggestions and
  195. bug reports are welcome. (jml@stekt.oulu.fi) -- Jouni Leppäjärvi
  196. ----------------------------------------------------------------------
  197.