SETMODEM V1.0 for the Commodore Amiga.

                      Compatable with V1.0 for the
      MSDOS, UNIX, XENIX, AIX, MacIntosh, Apple and C64/128 systems.
         (Sorry, nobody I know has (or wants) an Atari ST system)

                                 By
                           Michael Evenmo

                          Copyright © 1990

*****************************************************************************

  NOTICE: SETMODEM program is provided free of charge. You may distribute
          it freely and/or included in commercial programs, provided that
          the binary executable (SETMODEM) is not changed in any form.  
          You can throw away or change anything else, but leave SETMODEM
          the way it is.

*****************************************************************************

 PURPOSE: The intent of this program is to simplify modem configuration and
          provide the ability to quickly reconfigure diffrent options and
          diffrent modems.

*****************************************************************************

COMMENTS: SETMODEM is a simple program.  There are few built in commands.
          I wanted to keep it simple.  I have included a few example script
          files, which are probably more informative than this messy file.

          SETMODEM defaults 8 data bits, no parity, 1 stop bit, and 9600
          baud.  Only the baud rate can be changed.  I don't know of any
          reason to change any of the other parameters.

          The reason this is a simple CLI program, and not an Amigatized
          program, is because it's completely compatable with versions I
          have written for most other computers.  I use it at work on many
          diffrent machines.

          The code was easy to port, with the exception of the RS232 I/O
          routines.  As you may already know, it's handled very diffrently
          on each machine (with the MSDOS version being the most difficult,
          because I had to write my own RS232 interrupt driven I/O routines).

*****************************************************************************

    BUGS: I do not write buggy code.  None of us do.  But not everyone uses
          a program the way the author had intended it to be used.  And not
          everyones system is configured the same.

          If you should perhaps find a bug and desire to report it, give me
          a call and we'll talk.  Monday thru Friday, 9AM to 9PM, call me at
          612/463-2633.  Ask for Mike.  If I'm not in, leave a message and
          I'll return your call.  Sorry, I'm not allowed to accept collect
          calls.

*****************************************************************************

  SYNTAX: SETMODEM -f<scriptfile> [-s<start char.> -t<terminate char.>]

          Where: <scriptfile> is the name of a command/parameter script.

                 <start char.> is indicator for start of command/parameter.

                 <terminate char.> is indicator for end of command/para.

                 -s and -t are optional, and default to -s> and -t<.

                 Start and Terminate characters provide a way to indicate
                 program and modem commands.  By enveloping commands, you
                 can place comments anywhere within the script file.  See
                 the 'setmodem.set1' example file for a good reason why I
                 did things this way.  

*****************************************************************************

COMMANDS: There are a few built in commands as follows-

    >BAUDn<  It tells SETMODEM to set baud at (n)BPS.  Select from 300, 1200,
             2400, 4800, 9600 or 19200 BPS. 

               Example:  >BAUD9600< will communicate at 9600 baud.

    >CASEn<  Where (n) is 1=Convert ALL input from the script to upper case
             characters and 0=Do not convert input to upper case characters.

               Example:  >CASE1< will convert all input to upper case. 

    >WAITn<  Wait (n) seconds, (n) is a number 0 to 60.  Provides a way to
             delay script processing.

               Example:  >WAIT3< will delay processing for 3 seconds.

    >FAIL!s< SETMODEM will terminate if subsequent command(s) fail to reply
             with (s) reponse.

               Example:  >FAIL!OK< will terminate if OK is not received.
               Example:  >FAIL!< will clear the FAIL not equal string.

    >FAIL=s< SETMODEM will terminate if subsequent command(s) reply with
             (s) reponse.

               Example:  >FAIL=ERROR< will terminate if ERROR received.
               Example:  >FAIL=< will clear the FAIL equal string.

    >FAIL<   Display current FAIL values.

*****************************************************************************

    NOTE: SETMODEM requires some sort of response back from the modem after
          sending it a command.  If you have turned off echo (ATE0) or have
          enabled quiet mode (ATQ1), then SETMODEM will wait 5 seconds for
          the modem to respond before timeout.  Upon timeout, SETMODEM will
          terminate.

*****************************************************************************