
                              WATTCP FTP

                             Version 0.70

                     Erick Engelke and Dean Roth

Use:
    FTP  [hostname]  [-f cmdfilename]  [portnumber]

    - if you include an optional hostname, FTP opens a connection to that host
    - you can create a file of commands and automatically invoke that command
      file by using the -f option (followed by a space) and the name of the
      FTP command file.
    - if you use an optional portnumber on the command line, FTP will use
      that port number for all opens until you QUIT.  However, if you
      specify a port number on a particular OPEN, that number will only
      be used for that single session.

Script Files
    Script files can be started from the command line by using the -f option,
    or from the session prompt by enterring RUN scriptname

    The commands for a script file should be enterred just as you normally
    would type them.  You can simply enter the userid and password on a
    separate line as they answer the questions.

    eg. WATSUN.SCR                              This sample script waits until
        wait 2:30                               2:30 am and then opens an
        open watsun.cc.columbia.edu             ftp connection to watsun.
        anonymous
        joe@mechanical.watstar.uwaterloo.ca
        cd msk
        bget msn112.zip
        quit

    Scripts support some handy features:

    WAIT      wait until a specified time before continuing.  This permits
              scripts which wait until the dead of night before loading down
              lines with data.  Wait uses 24 hour time.

    QUIET ON  stop printing script commands and some other messages
    QUIET OFF return to normal 'noisy' operation

    ECHO      When used with QUIET commands, allows you to echo messages
              to the screen.

    Any script line which begins with a '@' is not echoed to the screen.
    So @QUIET ON will quietly turn the machine into quiet mode.  This is
    kind of cheezy, but it fits in well with DOS.

    Scripts do not automatically log out when done, this allows you to
    create a 'login' script to connect up to a machine and beep you, then
    resume in command mode.  If you want to exit from the script, use the
    QUIT command.  (Here the ^G is a control-G or ASCII BEL character.)

    eg. SUNEE.SCR
        @OPEN sunee.uwaterloo.ca
        anonymous
        joe@gnat.uwaterloo.ca
        echo ^GYou are connected to sunee!

Sample Script

        To invoke this script, use:
        ftp -f ftp.cmd

Configuring:
    You need a WATTCP configuration file called WATTCP.CFG.  If you have
    one from other WATTCP applications, that will work.  Otherwise it
    should look something like:

        # sample config file for all wattcp applications.  For more
        # details, download sunee.uwaterloo.ca  pub/wattcp/apps.zip and
        # read the info sheet


        # set ip number
        my_ip=129.97.176.99
        # or for bootp set my_ip=bootp

        # set a non-zero network mask
        netmask=255.255.254.0

        # enter one or more nameservers
        nameserver=129.97.128.196
        nameserver=129.97.128.189

        # enter one or more gateways
        gateway=129.97.176.1
        gateway=129.97.20.1

        # should have a domain list
        domainslist="uwaterloo.ca"

        # optional inactive flag tells WATTCP to kill connection if nothing
        # happens for a period of time in seconds
        # eg. inactive=300    # 300 seconds or 5 minutes

        # define timeout for most things, like openning sessions
        # defaults to 30 seconds
        # eg. sockdelay=60    # extend it to one minute

Send bug notices to:

Erick@development.watstar.uwaterloo.ca
