home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 367.lha / SETMODEM_v1.0 / README.pp / README
Encoding:
Text File  |  1990-05-03  |  5.1 KB  |  121 lines
  1.  
  2.  
  3.                  SETMODEM V1.0 for the Commodore Amiga.
  4.  
  5.                       Compatable with V1.0 for the
  6.       MSDOS, UNIX, XENIX, AIX, MacIntosh, Apple and C64/128 systems.
  7.          (Sorry, nobody I know has (or wants) an Atari ST system)
  8.  
  9.                                  By
  10.                            Michael Evenmo
  11.  
  12.                           Copyright © 1990
  13.  
  14. *****************************************************************************
  15.  
  16.   NOTICE: SETMODEM program is provided free of charge. You may distribute
  17.           it freely and/or included in commercial programs, provided that
  18.           the binary executable (SETMODEM) is not changed in any form.  
  19.           You can throw away or change anything else, but leave SETMODEM
  20.           the way it is.
  21.  
  22. *****************************************************************************
  23.  
  24.  PURPOSE: The intent of this program is to simplify modem configuration and
  25.           provide the ability to quickly reconfigure diffrent options and
  26.           diffrent modems.
  27.  
  28. *****************************************************************************
  29.  
  30. COMMENTS: SETMODEM is a simple program.  There are few built in commands.
  31.           I wanted to keep it simple.  I have included a few example script
  32.           files, which are probably more informative than this messy file.
  33.  
  34.           SETMODEM defaults 8 data bits, no parity, 1 stop bit, and 9600
  35.           baud.  Only the baud rate can be changed.  I don't know of any
  36.           reason to change any of the other parameters.
  37.  
  38.           The reason this is a simple CLI program, and not an Amigatized
  39.           program, is because it's completely compatable with versions I
  40.           have written for most other computers.  I use it at work on many
  41.           diffrent machines.
  42.  
  43.           The code was easy to port, with the exception of the RS232 I/O
  44.           routines.  As you may already know, it's handled very diffrently
  45.           on each machine (with the MSDOS version being the most difficult,
  46.           because I had to write my own RS232 interrupt driven I/O routines).
  47.  
  48. *****************************************************************************
  49.  
  50.     BUGS: I do not write buggy code.  None of us do.  But not everyone uses
  51.           a program the way the author had intended it to be used.  And not
  52.           everyones system is configured the same.
  53.  
  54.           If you should perhaps find a bug and desire to report it, give me
  55.           a call and we'll talk.  Monday thru Friday, 9AM to 9PM, call me at
  56.           612/463-2633.  Ask for Mike.  If I'm not in, leave a message and
  57.           I'll return your call.  Sorry, I'm not allowed to accept collect
  58.           calls.
  59.  
  60. *****************************************************************************
  61.  
  62.   SYNTAX: SETMODEM -f<scriptfile> [-s<start char.> -t<terminate char.>]
  63.  
  64.           Where: <scriptfile> is the name of a command/parameter script.
  65.  
  66.                  <start char.> is indicator for start of command/parameter.
  67.  
  68.                  <terminate char.> is indicator for end of command/para.
  69.  
  70.                  -s and -t are optional, and default to -s> and -t<.
  71.  
  72.                  Start and Terminate characters provide a way to indicate
  73.                  program and modem commands.  By enveloping commands, you
  74.                  can place comments anywhere within the script file.  See
  75.                  the 'setmodem.set1' example file for a good reason why I
  76.                  did things this way.  
  77.  
  78. *****************************************************************************
  79.  
  80. COMMANDS: There are a few built in commands as follows-
  81.  
  82.     >BAUDn<  It tells SETMODEM to set baud at (n)BPS.  Select from 300, 1200,
  83.              2400, 4800, 9600 or 19200 BPS. 
  84.  
  85.                Example:  >BAUD9600< will communicate at 9600 baud.
  86.  
  87.     >CASEn<  Where (n) is 1=Convert ALL input from the script to upper case
  88.              characters and 0=Do not convert input to upper case characters.
  89.  
  90.                Example:  >CASE1< will convert all input to upper case. 
  91.  
  92.     >WAITn<  Wait (n) seconds, (n) is a number 0 to 60.  Provides a way to
  93.              delay script processing.
  94.  
  95.                Example:  >WAIT3< will delay processing for 3 seconds.
  96.  
  97.     >FAIL!s< SETMODEM will terminate if subsequent command(s) fail to reply
  98.              with (s) reponse.
  99.  
  100.                Example:  >FAIL!OK< will terminate if OK is not received.
  101.                Example:  >FAIL!< will clear the FAIL not equal string.
  102.  
  103.     >FAIL=s< SETMODEM will terminate if subsequent command(s) reply with
  104.              (s) reponse.
  105.  
  106.                Example:  >FAIL=ERROR< will terminate if ERROR received.
  107.                Example:  >FAIL=< will clear the FAIL equal string.
  108.  
  109.     >FAIL<   Display current FAIL values.
  110.  
  111. *****************************************************************************
  112.  
  113.     NOTE: SETMODEM requires some sort of response back from the modem after
  114.           sending it a command.  If you have turned off echo (ATE0) or have
  115.           enabled quiet mode (ATQ1), then SETMODEM will wait 5 seconds for
  116.           the modem to respond before timeout.  Upon timeout, SETMODEM will
  117.           terminate.
  118.  
  119. *****************************************************************************
  120.  
  121.