home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ARexxTools / DispMod.lha / DispMod / Docs / CONNECT.doc < prev    next >
Encoding:
Text File  |  1990-03-05  |  1.5 KB  |  47 lines
  1.  
  2. NAME:    CONNECT
  3.  
  4. SYNTAX:    CONNECT <portname> <command>
  5.  
  6. DESCRIPTION:
  7.  
  8.   This command tells the display module where and how to send any
  9.   data received from the keyboard. After this command is executed,
  10.   all further data received will be sent to <portname> with the
  11.   command <command>.
  12.  
  13. EXAMPLES:
  14.  
  15.   CONNECT 'ROBBS_ser' 'SEND'
  16.  
  17.   The example will cause all keyboard data to be sent to a public
  18.   port called 'ROBBS_ser', using a 'SEND' command. Assuming the
  19.   data typed was "a", the actual string sent to 'ROBBS_ser' will
  20.   be "SEND a".
  21.  
  22.   CONNECT ''
  23.  
  24.   Effectively 'disconnects' the display module. keypresses will not
  25.   be sent until a 'CONNECT <portname> is received by the display
  26.   module.
  27.  
  28. NOTES:
  29.  
  30.   It is important to note the difference between CTRL and CONNECT. CTRL
  31.   specifies where function key and HELP keypresses are sent, since they
  32.   are usually sent to a 'controlling program', as opposed to a program
  33.   that expects ASCII characters. CONNECT is for sending characters (with
  34.   a command) to a program that understands what to do with them.
  35.  
  36.   Note that a program refers to either an ARexx script or an executable
  37.   written in any other language, and that the CTRL and CONNECT ports may
  38.   be the same port.
  39.  
  40.   The data typed will be sent as a 'stream' as it is received,
  41.   so it will be sent as individual packets of arbitrary length.
  42.   If you want to parse it on a line basis (or any other basis),
  43.   your application will have to handle it by checking for a
  44.   linefeed or carriage return.
  45.  
  46. SEE ALSO: STATUS, CTRL
  47.