NetDial Modem Script Dialer 1.3              (C)-1996/97 by Marc S. Ressl
 ===========================================================================

             NetDial is Copyright (C) 1996/97 by Marc S. Ressl,
                            All Rights Reserved.

  NetDial is a simple modem script dialer for MS-DOS. It is easy to use
  and configure, and allows to make automatized dial-in's, for example to
  Internet providers.

  To run NetDial you can use these switches:

        NETDIAL [COMn] [speed] [HANGUP]
                [MODE <mode>] [PORT 0xnnn] [IRQ <n>]
                [TRIES <n>]

          COMn          Specifies the COM port (<n> is 1 to 4).

          speed         Specifies the port speed (2400, 4800, 9600,
                        19200, 38400, 57600 or 115200). Defaults to 57600.

          HANGUP        Hangs the modem up.

          MODE <mode>   Sets the port <mode>, for example 8n1 (8 data
                        bits, no parity, 1 stop bit), 7e2 (7 data bits,
                        even parity, 2 stop bits). The default is 8n1.

          PORT <0xnnn>  Sets the port base-address nnn in hexadecimal.

          IRQ <n>       Sets the port IRQ.

          TRIES <n>     Tries the script up to <n> times on failure
                        (Use <n> = -1 to dial endlessly).


 Scripts
 =======

  The script file "NETDIAL.SCR" must exist in the current directory when
  connecting. This file is made up of these entries:

  recv <timeout> ["string"]

        Waits <timeout> miliseconds, until "string" is received by the
        modem. Otherwise hangs up.

        If "string" is empty, waits <timeout> miliseconds.

  send <"string">

        Sends a string to the modem.

  The strings must be in C-language notation, and enclosed in double-quotes.
  To specify return, use \r. See the appendix for more escape sequences.


 Sample scripts
 ==============

  This script shows an example of an Internet dial-in:

        send "\r"
        recv 1000
        send "ATZ\r"
        recv 5000 "OK"
        send "ATDT555-1234\r"
        recv 35000 "CONNECT"
        recv 15000 "name:"
        send "your_login\r"
        recv 15000 "word:"
        send "your_password\r"
        recv 10000 "menu_prompt"
        send "menu_option\r"
        recv 1000

  This script works with Compuserve (remember to use MODE 7E1):

        send "\r"
        recv 1000
        send "ATZ\r"
        recv 3000 "OK"
        send "ATDT555-1234\r"
        recv 30000 "CONNECT"
        recv 3000
        send "\r"
        recv 3000 "Host Name:"
        send "CIS\r"
        recv 3000 "User ID:"
        send "nnnnn,xxxx/noint/go:pppconnect\r"
        recv 3000 "Password:"
        send "your_password\r"


 Appendix
 ========

  NetDial supports these escape sequences:

        \\              A simple \
        \a              Alarm           (ASCII 7)
        \b              Backspace       (ASCII 8)
        \f              Line feed       (ASCII 12)
        \n              New line        (ASCII 10)
        \r              Return          (ASCII 13)
        \t              Tab             (ASCII 9)
        \v              Vertical tab    (ASCII 11)
        \"              A simple "
        \xnn            The ASCII character nn in hexadecimal
        \0nnn           The ASCII character nnn in octal

  And returns these errorlevels:

        0               The script was completed successfully.
        1               Timeout or other errors.
        2               User cancelled.

  NetDial is also compatible with Merit's EtherPPP script format.

  This program was built with the MCOMM free communications library
  by Mike Dumdei.


 Common problems
 ===============

  If you use an external high-speed modem, and experience problems with
  NetDial, try leaving some time (200 ms) after each sent AT command.


 Bugs or comments
 ================

  To contact the author send your mail to:

        ressl@interactive.com.ar

  I'll try to help you whenever possible.


  NetDial is cardware. If you like this program, please send me a
  postcard of your place to this address:

        Marc S. Ressl
        Wilde 301 (Fisherton)
        Rosario 2000 (Santa Fe)
        Argentina


 Disclaimer and copyright
 ========================

  NetDial is freeware with the following limitations:

  This program is provided "AS IS" without warranty of any kind, either
  express or implied. In no event shall Marc S. Ressl be liable for any
  damages whatsoever including direct, indirect, incidental, consequential,
  loss of business profits or special damages, even if it is advised of the
  possibility of such damages.

  NetDial may not be sold or resold, distributed as a part of any
  commercial package, used or distributed in support of a commercial
  service, or used or distributed to support any kind of profit-generating
  activity, even if it is being distributed freely.

  The integrity of the original files as distributed by the author is
  essential. All of its related files must be distributed together. None
  of its contents may be modified, decompiled, or reverse engineered.