From decwrl!elroy.jpl.nasa.gov!sdd.hp.com!cs.utexas.edu!uunet!allbery Wed May 16 10:14:22 PDT 1990
Article 1564 of comp.sources.misc:
Path: decwrl!elroy.jpl.nasa.gov!sdd.hp.com!cs.utexas.edu!uunet!allbery
From: wht%n4hgf@gatech.edu (Warren Tucker)
Newsgroups: comp.sources.misc
Subject: v12i084: ECU 2.80 manual part 02/03
Message-ID: <88387@uunet.UU.NET>
Date: 12 May 90 02:07:00 GMT
Sender: allbery@uunet.UU.NET
Lines: 2224
Approved: allbery@uunet.UU.NET (Brandon S. Allbery - comp.sources.misc)

Posting-number: Volume 12, Issue 84
Submitted-by: wht%n4hgf@gatech.edu (Warren Tucker)
Archive-name: ecuman2.80/part02

---- Cut Here and unpack ----
#!/bin/sh
# this is ecuman280.02 (part 2 of ecuman280)
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/ecu.man continued
#
if touch 2>&1 | fgrep '[-amc]' > /dev/null
 then TOUCH=touch
 else TOUCH=true
fi
if test ! -r @shar_seq_.tmp; then
	echo "Please unpack part 1 first!"
	exit 1
fi
(read Scheck
 if test "$Scheck" != 2; then
	echo "Please unpack part $Scheck next!"
	exit 1
 else
	exit 0
 fi
) < @shar_seq_.tmp || exit 1
echo "x - Continuing file doc/ecu.man"
sed 's/^X//' << 'SHAR_EOF' >> doc/ecu.man &&
X
X
X
X    5.41  SZ : send via	ZMODEM/CRC32
X
X    usage: sz [<file-list>]
X
X
X    This command invokes ecusz to send file(s) to the  remote  system  using
X    ZMODEM/CRC32.
X
X    You	are prompted to	enter filename(s) to send, which may consist of	 one
X    or more wildcard specifications.  File transfer progress is	presented on
X    a visual display.  To abort	 the  transfer,	 press	your  interrupt	 key
X    (usually DEL unless	reset with stty(C)).
X
X    Note: if you specify sending only newer files and  the  remote  receiver
X    does  not  support	the  feature,  it  may skip (reject) all your files.
X    Retry the transfer specifying 'N' to 'Transfer only	newer files'.
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      30
X
X
X
X    |								     |
X    |  File(s) to send:						     |
X    |  ckermit-5a-130						     |
X    |								     |
X    |  Binary: Y (no NL-CR/LF translation)			     |
X    |  Overwrite destination files: Y				     |
X    |  Send full pathames:  N					     |
X    |  Transfer	only newer files: N				     |
X    |								     |
X    |	  TAB:next  ^B:prev  END:perform transfer  ESC:abort	     |
X    `--	enter file(s) to send ---------------------------------------'
X    `--	Y: no conversion, N: NLs converted to CR/LF -----------------'
X    `--	Y: overwrite, N: protect destination files ------------------'
X    `--	Y: full	pathnames, N: strip directory portion from names ----'
X    `--	Y: send	only if	source newer than destination, N send all ---'
X
X
X
X    5.42  TIme : time of day
X
X    usage: time
X
X
X    This command displays the local date and time as  well  as	the  current
X    UTC.
X
X
X    5.43  TTy :	console	tty name
X
X    usage: tty
X
X
X    This command displays the current console tty name.
X
X
X
X    5.44  XA : hex to ascii char
X
X    usage: xa [<hex-val>]
X
X
X    <hex-val> is a hexadecimal value between 0 and FF; the parity (sign) bit
X    is stripped	and the	equivalent ASCII character value is displayed.
X
X    If no argument is supplied,	a table	of  control  characters	 is  printed
X    containing	decimal,  octal,  hex,	ASCII  identifiers and two-character
X    control character identifier.
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      31
X
X
X
X    5.45  ! : execute shell
X
X    usage: !
X	   !<command>
X
X
X    The	'!' command is a shell escape.	The environment	 variable  SHELL  is
X    read  to  determine	 what shell program to execute (e.g., /bin/sh, etc).
X    If '!' is entered by itself, an interactive	shell is started;  press  ^D
X    to	exit  back  to ECU.  If	<command> is supplied, it is executed by the
X    shell with an immediate return to ECU.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      32
X
X
X
X    6.	Procedure Language
X
X
X    Sample procedures are shown	in the companion document 'samplproc.man'.
X
X
X
X    6.1	 Arguments
X
X
X    There are five types of arguments to procedure commands:
X
X	 Switch
X	 Alphabetic Token
X	 Integer
X	 String
X	 Relational Operators
X
X    This section describes the syntax and construction of each type in turn.
X    There  are separate	groups of valid	of relational operators	for integers
X    and	strings; thus, they are	described under	the appropriate	sections.
X
X
X    6.1.1  Switches
X
X    Switch arguments begin with	a hyphen (minus, '-').	The switch  argument
X    must  be the first argument	after the command.  Only one switch argument
X    is allowed on the command line.  If	switches '-a', '-b'  and  '-c',	 are
X    available and '-a' and '-b'	are desired, '-ab' or '-ba' is entered.
X
X
X    6.1.2  Alphabetic Tokens
X
X    Alphabetic tokens, for lack	of a  better  term,  are  non-integer,	non-
X    quoted terms used as arguments for certain commands, such as:
X
X	 plog off
X
X    Such argument types	are fairly simple to understand	and  use;  they	 are
X    described here for completeness.
X
X
X    6.1.3  Integers
X
X    Integer values are 32-bit quantities  ranging  between  -2147483647	 and
X    2147483647.
X
X    In one case, an integer  is	 used  to  store  a  32-bit  color  mask  as
X    described by the color command and the %colors integer function.
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      33
X
X
X
X    6.1.3.1  Constants
X
X    Integer constants are numeric strings, optionally with an initial  minus
X    sign, the absolue value of which must be less than 2147483648.
X
X
X    6.1.3.2  Variables
X
X    There are 50 numbered, permanent integer  variables	 referenced  by	 the
X    terms  '$i0'  through  '$i49'.   When  ECU is started, the value of	each
X    variable is	zero.  Variables retain	 their	value  until  changed,	even
X    between  procedure	executions.   The  integer  variable  number  may be
X    expressed as  an  expression  by  enclosing	 an  integer  expression  in
X    brackets.  For instance:
X
X	 $i[4+5]      refers to	$i9
X
X	 $i2=5
X	 $i[20+$i2]   refers to	$i25
X
X
X    Integer variables may be created for use  as  "local"  variables  or  to
X    promote code readability.  Refer to	the mkvar command.
X
X
X    6.1.3.3  Functions
X
X    ECU	has many built-in functions  which  return  the	 value	of  ecu-  or
X    system-related  information.  A list of the	functions appears in a later
X    section.
X
X
X    6.1.3.4  Expressions
X
X    In almost any place	an integer argument is allowed,	an expression may be
X    supplied.	Expressions are	composed of two	or more	integer	constants or
X    variables separated	by operators from the group:
X
X	+     addition
X	-     subtraction
X	*     multiplication
X	/     division
X	|     OR
X	@     MOD
X	^     XOR
X	&     AND
X
X    Evaluation	of  expressions	 is  left-to-right.   Parentheses  are	 not
X    allowed.
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      34
X
X
X
X    6.1.3.5  Relational	Operators
X
X    Integer relational operators are chosen from the following group:
X
X	 =	 "is equal to"
X	 ==	 "is equal to"
X	 !=	 "is not equal to"
X	 <>	 "is not equal to"
X	 >	 "is greater than"
X	 <	 "is greater than"
X	 >=	 "is greater than or equal to"
X	 <=	 "is less than or equal	to"
X
X
X
X    6.1.4  Strings
X
X    Strings are	classic	concatenations of zero or more eight-bit characters.
X    In general,	the maximum size of a string used by ECU is 256	characters.
X
X
X    6.1.4.1  Constants
X
X    String constants are formed	by placing alphanumeric	 characters  between
X    single quote characters (apostrophes).  The	backslash ('\')	character is
X    used to "escape" certains characters:
X
X	'\'    one backslash
X	'0   newline
X	''   tab
X	'''   apostrophe
X
X
X
X    6.1.4.2  Variables
X
X    There are 50 numbered, permanent  string  variables	 referenced  by	 the
X    terms  '$s0'  through  '$s49',  each  possessing a maximum length of 256
X    characters When ECU	is started, the	value of each variable is null (zero
X    length).   Variables  retain  their	 value	until  changed,	even between
X    procedure executions.  The string variable number may be expressed as an
X    expression by enclosing an string expression in brackets.  For instance:
X
X	 $s[4+5]      refers to	$s9
X
X	 $s2=5
X	 $s[20+$s2]   refers to	$s25
X
X
X    String variables may be created for	 use  as  "local"  variables  or  to
X    promote code readability.  Refer to	the mkvar command.
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      35
X
X
X
X    6.1.4.3  Functions
X
X    ECU	has many built-in functions  which  return  the	 value	of  ecu-  or
X    system-related  information.  A list of the	functions appears in a later
X    section.
X
X
X    6.1.4.4  Expressions
X
X    String expressions are formed by the concatenation of string  constants,
X    variables and function return values using the '+' operator:
X
X    Example:
X       'The quick brown	fox jumped over	the '+$s0'+' dog at '+%time
X
X
X
X    6.1.4.5  Relational	Operators
X
X    String relational operators	are chosen from	the following group:
X
X	 =	 "is equal to"
X	 ==	 "is equal to"
X	 !=	 "is not equal to"
X	 <>	 "is not equal to"
X
X
X
X
X    6.2	 Commands
X
X
X
X    6.2.1  baud
X
X    usage: baud	<baud-int>
X
X    This command sets the baud rate for	 the  attached	line.	The  integer
X    argument  <baud-int>  must	be  one	 of 110, 300, 600, 1200, 2400, 4800,
X    9600, 19200	and 38400.
X
X    Example:
X	baud 9600
X	set $i0=2400; baud $i0
X
X
X
X    6.2.2  break
X
X    usage: break
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      36
X
X
X
X    This command is used inside	a whilei or  whiles  compound  statement  to
X    exit the loop.
X
X    Example:
X
X	whilei 1=1 #forever unless break command executed
X	{
X	    echo -n 'Answer yes	or no: '
X	    set	$s0=%cgets # get answer
X	    ifi	%instr($s0,'y')	== 0 set $i0 = 1; break
X	    ifi	%instr($s0,'n')	== 0 set $i0 = 0; break
X	    # got neither 'y' nor 'n' ... keep trying
X	}
X	# now $i0 = 1 if yes, 0	if no
X
X
X    NOTE: further examples of break usage may be found in  the	example	 for
X    the	else command.
X
X
X    6.2.3  cd
X
X    usage: cd <directory-path>
X
X    This command  changes  ECU's  current  working  directory.	 The  string
X    argument   <directory-path>	  may	contain	  any	directory   pathname
X    specification legal	to  be	submitted  to  the  shell  csh.	  Wild	card
X    characters	may  be	 used,	provided  the  expansion  produces  only one
X    pathname.
X
X
X    Example:
X
X	cd '~user/bin'
X	cd %envvar('HOME')+'/bin'
X
X
X
X    6.2.4  clrx
X
X    usage: clrx
X
X    This  command  clears   the	 attached  line's  transmitter	XOFF  state.
X    Issuing  the  command  is  the  equivalent	to receiving an	XON from the
X    remote system.
X
X
X    6.2.5  cls
X
X    usage: cls
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      37
X
X
X
X    This command clears	the screen.
X
X
X    6.2.6  color
X
X
X    usage: color <normal-foreground> [<normal-background>]
X    usage: color -r <reverse-foreground> [<reverse-background>]
X
X
X    This command changes the current normal or reverse	video  colors  in  a
X    manner  similar to the setcolor(C) command.	 It has	no effect on systems
X    using a  monochrome	 monitor.   If	the  second  (background)  color  is
X    omitted, it	is assumed to be black.
X
X    The	command	also forces normal video mode.	Refer  to  the	vidnorm	 and
X    vidrev commands.  Refer also to the	vidcolor command.
X
X
X    Color names
X       blue	 magenta      brown	 black
X       lt_blue	 lt_magenta   yellow	 gray
X       cyan	 white	      green	 red
X       lt_cyan	 hi_white     lt_green	 lt_red
X
X    Example:
X
X	color lt_green	# normal video light green on black
X	color -r red white # reverse video red on white
X
X
X
X    6.2.7  continue
X
X    usage: continue
X
X    This command is used inside	a whilei or  whiles  compound  statement  to
X    skip the remainder of any commands in the loop and continue	execution at
X    the	first command in the loop.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      38
X
X
X
X    Example:
X
X	send ''	# send ENTER to	get prompt
X	whilei 1=1 # forever unless break command executed
X	{
X	    lookfor -e 'login: ' # look	for login prompt
X	    ifi	$i0 == 0	 # if we dont get prompt ...
X	    {
X		send ''		 # send	ENTER again
X		continue	 # and look for	login prompt
X	    }
X	    send $s_name	 # send	username
X	    lookfor -e 'Password:'
X	    send $s_password
X	    get	-e 0 50		 # wait	10 seconds for response
X
X	    # if incorrect not found in	response, ...
X	    if %instr($s0,'incorrect') < 0 # ... must have won
X		break
X
X	    # garbled line?: system will send another 'login: '
X	}
X
X
X
X    NOTE: further examples of continue usage may be found in the example for
X    the	else command.
X
X
X    6.2.8  cursor
X
X    usage: cursor <row>	[<col>]
X
X    This command places	the cursor at a	 specified  position  on  the  video
X    screen.  The top left of the scrren	is row 0, column 0.  If	<col> is not
X    specified, it is assumed 0 (left margin).
X
X    Example:
X
X	cls
X	$i0 = 5
X	whilei $i5 < 12
X	{
X	    cursor $i5
X	    echo 'This is line '+%itos($i5,2d)+' of the	display'
X	}
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      39
X
X
X
X    6.2.9  delline
X
X    usage: delline
X
X    This command deletes the current line from the video display.
X
X
X    6.2.10  dial
X
X    usage: dial	<remote>
X
X    This command causes	an outgoing call to be placed.	The string  argument
X    <remote>  can  take	 one  of two forms: a numeric telephone	number or an
X    alphanumeric "logical" number or system name.
X
X    A numeric phone number ('1(800)555-1212' or	'2345678') must	begin with a
X    digit and must consist entirely of digits, parentheses or hyphens.	If a
X    telephone number is	supplied, the phone number is dialed; you must first
X    have  set the desired baud rate and	parity using the 'baud'	and 'parity'
X    commands.
X
X    If a logical name is  entered,  the	 phone	directory  (managed  by	 the
X    interactive	 dial  command)	is searched; if	the entry is found, the	baud
X    rate and parity is automatically set from values in	the directory entry;
X    then, the number in	the directory entry is dialed.
X
X    When the dial command returns, integer variable $i0	is set to  a  status
X    code and string variable $s0 has a text message (the modem verbal result
X    code if the	ecu dialer is used, a representation of	 the  return  status
X    code if a uucp dialer is used [see below]).
X
X    Dial Command $i0 Status Codes
X
X	0  successful connect
X	1  failed to connect (call progress)
X	2  dial	interrupted by signal
X	3  modem error (non responsive or commands rejected)
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      40
X
X
X
X    Dial Command $s0 Status Messages (uucp dialer)
X
X	CONNECT	####	       #### = baud rate
X	BUSY		       only some modems
X	NO ANSWER	       only some modems
X	NO CARRIER	       most generic "fail to connect"
X	NO DIAL	TONE	       only some modems
X	!Connect bad baud rate modem reported different	rate
X	!Interrupted	       call interrupted	by signal
X	!Invalid arguments     ecu error
X	!Invalid phone number  too long	or bad characters
X	!Ioctl error	       should not be reported here
X	!Line in use	       should not be reported here
X	!Line open error       should not be reported here
X	!Modem Error	       modem did not respond
X
X    Note: if the ecu dialer is used, the actual	modem result code
X    is returned	in $s0 or one of the following two strings:
X
X	!Interrupted	       call interrupted	by signal
X	!Modem Error	       modem did not respond
X
X
X
X    6.2.11  do
X
X    usage: do <procname> [<arg>	...]
X
X    This command executes a procedure whose name appears  as  the  command's
X    first (string) argument.  One or more arguments (up	to 19) may be passed
X    to the called procedure; an	argument may consist  of  any  valid  string
X    expression,	provided, that,	when expanded,	the argument does not exceed
X    256	characters in length.
X
X    The	called procedure may read  its	arguments  using  the  %argv  string
X    function.	%argv(0)  is  the  name	 of  the procedure.  The quantity of
X    arguments may be obtained using the	%argc integer function.
X
X
X    Example:
X
X	do 'proc' %rname %date+' '+%time %argv(0)
X
X    Note: in this example, the called procedure	is passed the name
X    of the calling procedure as	the last argument.
X
X
X
X    6.2.12  duplex
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      41
X
X
X
X    usage: duplex full | half
X	   duplex 'full' | 'half'
X
X
X    This command specifies whether or not ecu is to locally echo  characters
X    typed  by  you  at	the  keyboard.	 The overwhelming majority of remote
X    systems provide the	echo function, in which	case  full  duplex  must  be
X    used.   For	the rare occasions when	the remote system does not echo	your
X    keyboard input, setting half duplex	will allow you to see what  you	 are
X    typing.
X
X    When communicating with another terminal in	a  "teletype  conversation",
X    setting  half  duplex  is generally	required.  In such cases, use of the
X    interactive	nl, nlin and nlout commands may	also be	required.
X
X    Example:
X
X	duplex full
X	$s0 = 'full'; duplex $s0
X
X
X
X
X    6.2.13  echo
X
X    usage: echo	[-n] <string>
X
X    This command prints	the contents of	the string argument <string> on	 the
X    screen.   If  the -n switch	is not present,	a newline follows the output
X    of <string>.
X
X    Example:
X
X	echo 'Procedure	'+%argv(0)+' executing at '+%time
X	echo -n	'Enter your first name:	'; $s0 = %cgets
X
X
X
X    6.2.14  eeol
X
X    usage: eeol
X
X    This command erases	the video display to the end of	the line.
X
X
X    6.2.15  else
X
X
X    This statement may follow an ifi or	ifs command to specify one  or	more
X    statements	to  be	executed  if the if-type command condition is false.
X    Else commands may be chained  together  in	the  traditional  structured
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      42
X
X
X
X    usage: else	<statement>
X
X	   else
X	       <statement>
X
X	   else
X	   {
X		any kind and number of statements
X	   }
X
X	   else	<if> <statement>
X
X	   else	<if>
X	   {
X		any kind and number of statements
X	   }
X
X
X    language manner.
X
X    For	the purposes of	describing this	command, <statement> is	 any  single
X    or compound	statement NOT containing a whilei or whiles command.  If you
X    wish to have a while-type command executed as part of an else condition,
X    the	while must occur within	braces ("{}").
X
X    <if> is an ifi or ifs command followed by  an  <if-condition>  (see	 the
X    description	of the ifi or ifs commands below).
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      43
X
X
X
X    Example:
X
X    #+------------------------------------------------------
X    # finger.ep	- procedure to send 'finger' to	remote
X    # BSD Unix system; print resulting lines in	different
X    # colors: uucp logins green, root red, others cyan
X    #-------------------------------------------------------
X
X	mkvar $icolor; $icolor = %colors
X	mkvar $itimeout
X	$itimeout = 50	   # timeout for first line 5 secs
X	send 'ps -aux'	   # send command, but do not echo
X	lookfor	'0 40	 # swallow command
X	whilei 1==1	   # forever, or until break
X	{
X	    lgets 0 $itimeout 1	'0 #get	a line
X	    ifi	$i0 = 0	break #if no chaacters read
X	    $itimeout =	10 #wait 1 sec for later lines
X
X	    ifi	%instr($s0,'% ') >= 0 #	if csh prompt seen
X		break		      #	exit while loop
X	    else ifi %instr($s0,'Login') >= 0
X		color gray
X	    else ifi %instr($s0,'root')	>= 0
X		color red
X	    else ifi %instr($s0,'uucp')	>= 0
X		color green
X	    else color cyan
X	    echo $s0
X	}
X	icolor $icolor #restore	entry colors
X	send ''	       #force a	new prompt from	remote
X
X
X
X
X    6.2.16  exit
X
X    usage: exit	[<status>]
X
X    This command causes	an abrupt  termination	of  the	 ecu  program.	 Any
X    existing  connection with a	remote system is terminated immediately.  If
X    no integer argument	<status> is found, ecu exits  with  a  program	exit
X    status of 0.  If <status> is found and the value is	zero, then ecu exits
X    with a program exit	status of 0.  If <status> non-zero,its value must be
X    in the range of 1 to 31, and ecu exits with	a program exit status of 192
X    plus <status>.  This feature allows	batch executions  of  ecu  by  shell
X    script and ECU procedure to	detect ECU execution status.
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      44
X
X
X
X    6.2.17  expresp
X
X    usage: expresp [-v[v...]] <exp-resp-str> [<timeout_msecs>]
X
X    This command emulates the uuchat function as described in  the  SCO	 HDB
X    UUCP documentation and in the /usr/lib/uucp/Dialers	file.
X
X    -v causes the expect-respond conversation between  ECU  and	 the  remote
X    system  to	be  displayed  on  the screen.	This switch is automatically
X    enabled if procdedure tracing is enabled.
X
X    multiple v's (e.g.,	-vv, -vvv) up to 3 'v's	produce	more  verbose  debug
X    output.  -vv  causes  each	base  level  expect and	respond	string to be
X    displayed. -vvv causes a hexadecimal dump of  each	 interpreted  expect
X    string to be displayed.
X
X    <exp-resp-str> is as defined in /usr/lib/ecu/Dialers.
X
X       Meaning of some of the escape characters:
X	- pause	(approximately 1/4-1/2 second delay)
X
X	- delay	(2 seconds)
X       D - phone number/token
X       T - phone number	with Dialcodes and character translation
X       N - null	byte
X       K - insert a BREAK
X       E - turn	on echo	checking (for slow devices)
X       \--carriagefreturnchecking
X	   - send new-line
X	n - send octal number
X       Speed - Hayes-specific speed-adaptive connect handler
X
X
X    <timeout_msecs>  specifies	an  optional  timeout  in  milliseconds	 for
X    waiting  on	 expect	 strings;   it	defaults  to 10,000 milliseconds (10
X    seconds).  The resolution for timeouts is limited to the basic tick	time
X    of	your  system  (HZ,  10	msec for UNIX/386, 20 msec for XENIX/386 and
X    XENIX/286).	 The timeout for 'Speed' expects is fixed at 90	seconds.
X
X
X    6.2.18  fchmod
X
X    usage: fchmod <mode> <file>
X
X    This command sets the mode of <file> to  <mode>.   The  <mode>  argument
X    takes one of two forms, a nine-character mode string (e.g.,	'rwxr-xr-x')
X    or an integer value	(0755).	 The <file>  argument  is  either  a  string
X    value  forming  a filename or an integer file number representing a	file
X    opened with	the fopen command.
X
X    The	command	sets $i0 = 0 if	successful,  else  to  the  errno  from	 the
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      45
X
X
X
X    associated	system	call  (refer  to  the %errstr string function and/or
X    /usr/include/sys/errno.h).
X
X
X    Example:
X
X	fopen 1	'/tmp/123'; fchmod 'rwxrwxrwx' 1
X	fchmod 'rwxrwxrwx' '/tmp/123'
X	fopen 1	'/tmp/123'; fchmod 0777	1
X	$i0 = 0777; fchmod $i0 '/tmp/123'
X
X    All	of the above example result in the same	result.
X
X
X
X    6.2.19  fclose
X
X    usage: fclose <file>
X
X    This command closes	<file>.	 The <file>  argument  is  an  integer	file
X    number representing	a file opened with the fopen command.
X
X    The	command	is ignored if <file> is	not open.  No  integer	variable  is
X    modified by	fclose.
X
X
X    Example:
X
X	fclose 1
X
X
X
X    6.2.20  fdel
X
X    usage: fdel	<file>
X
X    This command removes a file.
X
X    The	command	sets $i0 = 0 if	successful,  else  to  the  errno  from	 the
X    associated	system	call  (refer  to  the %errstr string function and/or
X    /usr/include/sys/errno.h).
X
X
X    Example:
X
X	fdel '/tmp/123'
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      46
X
X
X
X    6.2.21  fgetc
X
X    usage: fgetc <file>	<destination>
X
X    This command reads a character from	<file>.	 The <file> argument  is  an
X    integer file number	representing a file opened with	the fopen command.
X
X    The	argument <destination> is either a string  variable  or	 an  integer
X    variable.	If  the	 file  has  reached end	of file: an integer variable
X    receives -1;  a  string  variable  is  returned  null.   Otherwise,	 the
X    character's	 numeric value (0-255) is placed in an integer variable	or a
X    string variable is returned	with a length of one with the file character
X    as its only	character.
X
X
X    Example:
X
X	fgetc 1	$s0
X	fgetc 1	$i_input
X
X
X
X    6.2.22  fgets
X
X    usage: fgets <file>	<strvar>
X
X    This command reads a character from	<file>.	 The <file> argument  is  an
X    integer file number	representing a file opened with	the fopen command.
X
X    The	argument <strvar> is a string variable.	 If the	file has reached end
X    of file, <strvar> is returned null and integer variable $i0	is set to 1.
X    Otherwise, the <strvar> receives input from	the file minus the  trailing
X    newline and	$i0 is returned	zero.
X
X
X    Example:
X
X	fgets 1	$s0
X
X
X
X    6.2.23  fkey
X
X    usage: fkey	<str>
X
X    This command selects a function  key  definition  from  the	 ~/.ecu/keys
X    file.
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      47
X
X
X
X    6.2.24  flush
X
X    usage: flush
X
X    This command causes	any characters received	by the system from the line,
X    but	not yet	read by	the procedure to be "forgotten"	or flushed.
X
X
X    6.2.25  fopen
X    usage: fopen [-switches] <filenum> <filename>
X
X    This command opens a file named by the string  argument  <filename>	 and
X    associates	it with	the user-chosen	file number <filenum> (which must be
X    an integer value between 0 and 4, inclusive).
X
X    The	argument switches govern how a file is opened  and  must  be  chosen
X    from this list:
X
X	-r	   The file is opened read-only; if it does  not  exist,  an
X		   error occurs.
X
X	-r+	   The file is opened for reading and writing;	if  it	does
X		   not exist, an error occurs.
X
X	-w	   The file is opened for writing (any previous	contents  of
X		   the file are	lost); if it does not exist, it	is created.
X
X	-w+	   The file is opened for reading and writing (any  previous
X		   contents  of	the file are lost); if it does not exist, it
X		   is created.
X
X	-a	   The file is opened for appending (writes to the file	 are
X		   added  to  the  previous  file  contents); if it does not
X		   exist, it is	created.  All writes  are  appended  to	 the
X		   file	(the fseek command has no effect).
X
X    The	switches parameter may be omitted; in such cases, the file is opened
X    as	though	'-r'  had  been	 supplied.  However, if	procedure tracing is
X    enabled (see the description of the	interactive  and  procedure  command
X    ptrace), a warning message will be issued.
X
X    The	command	sets $i0 = 0 if	successful,  else  to  the  errno  from	 the
X    associated	system	call  (refer  to  the %errstr string function and/or
X    /usr/include/sys/errno.h).
X
X    Example:
X
X	fopen 0	-r '/etc/passwd'
X	fopen 1	-w+ '/tmp/123'
X	fopen 2	-a 'tranact.log'
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      48
X
X
X
X    6.2.26  fputc
X
X    usage: fputc <file>	<char>
X
X    This command writes	character <char> into <file>.  The  <file>  argument
X    is	an  integer  file  number  representing	a file opened with the fopen
X    command.  Argument <char> is a integer value of which  the	lower  eight
X    bits are used or a string value of which the first character is used.
X
X    If a write error occurs, procedure execution is terminated.
X
X    Example:
X
X	$s0='abc'; fputc 1 $s0	      writes 'a'
X	$i0=0x30 ; fputc 1 $i0	      writes '0'
X
X
X
X    6.2.27  fputs
X
X    usage: fputs [-n] <file> <str>
X
X    This command writes	the string <str> into <file>.  The  <file>  argument
X    is	an  integer  file  number  representing	a file opened with the fopen
X    command.
X
X    If the switch '-n' is omitted, a newline is	appended after <str> in	 the
X    file; if present, no newline is written.
X
X    If a write error occurs, procedure execution is terminated.
X
X    Example:
X
X	$s0='abc'; fputc 1 $s0	      writes 'a'
X
X
X
X    6.2.28  fseek
X
X    usage: fseek <file>	<position>
X
X    This command sets  the  file  position  of	<file>	to  <position.	 The
X    corresponding  integer  function  %ftell  may  be  used to determine the
X    current file position.
X
X    Note: if <file> is open for	append ('-a'), then the	fseek  command	will
X    have no effect.
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      49
X
X
X
X    6.2.29  getf
X
X
X    usage: getf	-x <int-var-spec> <offset>
X
X    where: -x ==
X       -b byte
X       -w word (little-endian)
X       -W word (big-endian)
X       -l 32-bits (little-endian)
X       -L 32-bits (big-endian)
X
X
X
X    6.2.30  goto
X
X    usage: goto	<label>
X
X    This command transfers control of procedure	to a  statement	 other	than
X    the	one immediately	following.  The	<label>	argument may be	literal	text
X    or may be a	string,	allowing a "computed goto" feature.
X
X    Example:
X
X	goto GET_NEXT
X	goto 'GET_NEXT'
X	goto 'GET'+'_NEXT'
X	$s0 = 'GET_NEXT'; goto $s0
X	$s0 = 'NEXT'; goto 'GET_'+$s0
X
X    Note: all the above	examples cause transfer	to the label GET_NEXT.
X
X
X    6.2.31  gotob
X
X    usage: gotob <label>
X
X    This command serves	the same function as the  goto	command	 except	 the
X    programmer is signifying that the label is behind the current statement,
X    resulting in slightly faster execution.  (The label	is not	REQUIRED  to
X    be	at  any	 specific  location  in	 the procedure relative	to the gotob
X    statement.)
X
X
X    6.2.32  hangup
X
X    usage: hangup
X
X    This command causes	Data Terminal Ready (DTR) to be	dropped	momentarily,
X    causing  (hopefully)  the  termination  of	any  current connection	to a
X    remote system. This	command	is  only  effective  if	 the  attached	Data
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      50
X
X
X
X    Communications  Equipment  is  configured to terminate its connection on
X    loss of DTR.
X
X    If no line is attached, the	command	is ignored (a warning  is  generated
X    if procedure tracing is enabled).
X
X
X    6.2.33  hexdump
X
X    usage: hexdump [-s]	<str>
X	   hexdump -t[s] <str1>	<str>
X
X
X    <str> buf to dump <str1> title (if -t) -s short (terse) dump
X
X    This command prints	a hexadecimal dump of <str> on the  screen  (and  to
X    the	procedure log file, if logging enabled with the	ptrace command).
X
X    The	switch '-t' signifies that <str1> is a title to	be printed
X
X    Example:
X
X	$s0='The quick brown fox jumped	over the lazy dog's back'
X	hexdump	-t 'Example hex	dump' $s0
X    ---------------------------- Example hex dump ----------------------------
X    0000  54 68	65 20 71 75 69 63 6B 20	62 72 6F 77 6E 20 | The	quick brown  |
X    0010  66 6F	78 20 6A 75 6D 70 65 64	20 6F 76 65 72 20 | fox	jumped over  |
X    0020  74 68	65 20 6C 61 7A 79 20 64	6F 67 27 73 20 62 | the	lazy dog's b |
X    0030  61 63	6B					  | ack		     |
X
X	hexdump	%left($s0,9)
X    0000  54 68	65 20 71 75 69 63 6B			  | The	quick	     |
X
X	hexdump	-ts 'Example hex dump' %left($s0,9)
X    Example hex	dump
X    0000  54 68	65 20 71 75 69 63 6B | The quick |
X
X	hexdump	-s %left($s0,9)
X    0000  54 68	65 20 71 75 69 63 6B | The quick |
X
X
X
X    6.2.34  home
X
X    usage: home
X
X    This command homes the video cursor.
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      51
X
X
X
X    6.2.35  icolor
X
X    usage: %icolor <int-colors>
X
X    This command sets the  normal  and	reverse	 foreground  and  background
X    colors according to	<int-colors>, an integer value in the format as	that
X    returned by	the %colors integer function.
X
X    This command is provided primarily to be able to save the  color  state,
X    modify it temporarily and then restore it.
X
X    Example:
X
X	mkvar $icolor_save; $icolor_save = %colors
X	color red; echo	'Connection seems to be	dead'
X	icolor $icolor_save # restore previous colors
X
X
X
X    6.2.36  ifi
X
X    usage: ifi <int> <rel-op> <int> <statement>
X	   ifi <int> <rel-op> <int>
X	       <statement>
X	   ifi <int> <rel-op> <int>
X	   {
X	       any kind	or number of statements
X	   }
X
X
X    This command selectively executes one or more statements based on a	test
X    of	two integer quantities.	 See the description of	the break, continue,
X    and	else commmands for examples of how the command is used.
X
X
X    6.2.37  ifs
X
X    usage: ifs <str> <rel-op> <str> <statement>
X	   ifs <int> <rel-op> <int>
X	       <statement>
X	   ifs <int> <rel-op> <int>
X	   {
X	       any kind	or number of statements
X	   }
X
X
X    This command selectively executes one or more statements based on a	test
X    of	two  string values.  See the description of the	break, continue, and
X    else commmands and many other  examples  throughout	 the  document,	 for
X    examples of	how the	command	is used.
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      52
X
X
X
X    6.2.38  lbreak
X
X    usage: lbreak
X
X    This command transmits a break to the remote system.
X
X
X    6.2.39  lgets
X
X
X    usage: lgets [-er] <strvar>	<t1-int> <t2-int> [<stop-str>]
X
X    -e echo received characters	to screen
X    -r raw read	(retain	carriage returns)
X
X
X    This command reads a  string  from	the  attached  communications  line.
X    <t1-int>  is  the  number of tenths	of seconds before timing out waiting
X    for	the first character to be  received.   <t2-int>	 is  the  number  of
X    tenths  of seconds before timing out on later characters.  <stop-str> is
X    an optional	argument, which	 if  received,	immediately  terminates	 the
X    read.  Integer variable $i0	is set to the count of characters received.
X
X    If the specified string variable is	filled with  characters	 before	 the
X    <stop-str>	has  been  encountered	or before a timeout occurs, then the
X    command returns with $i0 set to the	maximum	size of	the variable.  Refer
X    to	the section on string variables	above and the section describing the
X    mkvar command below	for information	on the size of string variables.
X
X
X    6.2.40  insline
X
X    usage: insline
X
X    This command inserts a line	onto the video screen at the current line.
X
X
X    6.2.41  logevent
X
X    usage: logevent <str>
X
X
X    This command writes	a log item to ~/.ecu/log.
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      53
X
X
X
X    Example:
X
X	$s0='/tmp/alm.log'
X	log 'appending alarm info to '+$s0
X
X    writes:
X    10-02-1989-17:39-01261-PROC	appending alarm	info to	/tmp/alm.log
X
X    6.2.42  lookfor
X
X    lookfor [-e] [quiet	| <str>] [<timeout-int>]
X
X    -e echo to screen while "looking"
X
X    This command is used to read from the attached commuications line  until
X    one	of two user-specified conditions occurs.
X
X    The	'quiet'	option waits becomes quiet  for	 the  number  of  tenths  of
X    seconds specified  by <timeout-int>.
X
X    The	other option reads the line until <str>	is read	 from  the  line  or
X    until  <timeout-int>  tenths  of  seconds  elapses.	  With	this option,
X    integer variable $i0 is set	to 1 if	<str> is found	within	the  timeout
X    period or 0	if not.
X
X
X    Examples:
X
X	lookfor	-e quiet 20   wait for quiet line for 2	secs
X	lookfor	'word:'	50    wait for 'word:' for up to 5 secs
X
X    6.2.43  mkvar
X
X    usage: mkvar [$]i<name>
X	   mkvar [$]s<name>(<size>)
X
X
X    This command creates one or	more named integer or string variables.	 The
X    variable  type  is	determines  by	the first character of the variable,
X    which must be 'i' or 's'.	The  size  of  a  string  variable  must  be
X    specified  via the <size> argument.	 An optional '$' may be	supplies for
X    neatness, but may be omitted if desired.
X
X    The	maximum	value for <size> is 5120.  Note	that most commands  are	 not
X    capable  of	 handling  variables  longer  in  current  length  than	256.
X    Procedures employing created string	variables longer than 256 characters
X    should be tested carefully with string lengths that	exceed 256.
X
X    The	scope of created variables is for the duration of the  execution  of
X    the	creating procedure.  Procedures	called by the creating procedure (by
X    'do') can reference	created	variables.  When created, integer  variables
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      54
X
X
X
X    are	 set  to  zero	and  string variables are set to zero length.  These
X    features differ from numbered variables which  retain  their  scope	 and
X    values  at	all  times, even when procedure	execution terminates and ECU
X    returns to interactive mode.
X
X    The	<name> space for integer and string variables are separate.   It  is
X    possible to	have an	integer	variable named '$ixyz' and a string variable
X    named '$sxyz'.  <name> may contain any alphabetic or  numeric  character
X    or	the  underscore	 ('_')	character, but must begin with a non-numeric
X    character.	'$s_xyz' and '$sxyz' or	legal, but '$s3xyz' is not (would be
X    interpreted	as '$s3' followed by the illegal command sequence 'xyz').
X
X    Variables may be created by	the same name more than	 once.	 The  latest
X    mkvar  execution  specifies	 the  variable	referenced.   Thus  if proc1
X    declares '$ixx' and	calls proc2  which  also  declares  '$ixx',  proc2's
X    variable  is distinct from proc1's and disappears when proc2 terminates,
X    thus making	proc1's	available to it	again, containing the same value  as
X    it had at the time proc2 was called.
X
X
X    Examples:
X
X	mkvar i_count
X	mkvar $i_count
X	mkvar s20(20),s80(80),i_timeout,$i_colors
X
X
X
X    6.2.44  nap
X    usage: nap <int>
X
X    This command suspends procedure execution for <int>	tenths of seconds.
X
X
X    Examples:
X
X	nap 30
X	nap $i0*$i2
X
X    6.2.45  parity
X
X    usage: parity [even	| odd |	none]
X	   parity <str>
X
X
X    This command sets the parity for the attached communications  line.	  If
X    <str>  is  supplied,  the  first  character	 must  be  'e',	 'o' or	'n'.
X    Uppercase equivalents are also accepted.
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      55
X
X
X
X    Examples:
X
X	parity even
X	parity 'e'
X	parity 'Even now as we speak'
X
X
X
X    6.2.46  pclose
X    usage: pclose <filenum>
X
X    This command should	be issued when a command started by the	 interactive
X    popen commandf completes.
X
X
X    6.2.47  plog
X
X    usage: plog
X	   plog	<str>
X	   plog	off
X
X
X    This command controls logging to a file  of	 the  screen  output  during
X    procedure  execution.  With	no argument, the command displays the status
X    of logging.	 <str> specifies  a  log  file	pathname,  while  the  'off'
X    argument turns logging off.
X
X    If procedure execution terminates due to an	error, procedure logging  is
X    turned  off.   However, if procedure execution terminates normally while
X    logging is active, erratic and  unpredictable  portions  of	 interactive
X    mode screen	output will continue to	be logged to the current log file.
X
X    The	interactive mode command plog may also be used to control  procedure
X    logging.
X
X    Example:
X
X	mkvar s_logname(128)
X	$s_logname = %dir+'logname'
X	plog $s_logname
X	echo 'Test'
X	plog off;cd 'somewhere_else';plog $s_logname
X	echo 'Test'
X
X
X
X    6.2.48  popen
X    usage: popen [-switches] <filenum> <command>
X
X    This command executes a shell command defined  by  the  string  argument
X    <command>  and  associates it with the user-chosen file number <filenum>
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      56
X
X
X
X    (which must	be an integer value between 0 and 4, inclusive).
X
X    The	argument switches govern whether the command  is  to  receive  input
X    from ecu or	output to ecu and must be chosen from this list:
X
X	-r	   The command will output to ecu.
X
X	-w	   The command will receive input from ecu.
X
X    The	switches parameter may be omitted; in such cases, the file is opened
X    as	though	'-r'  had  been	 supplied.  However, if	procedure tracing is
X    enabled (see the description of the	interactive  and  procedure  command
X    ptrace), a warning message will be issued.
X
X    The	command	sets $i0 = 0 if	successful,  else  to  the  errno  from	 the
X    associated	system	call  (refer  to  the %errstr string function and/or
X    /usr/include/sys/errno.h).
X
X    Example:
X
X	popen 0	-r 'ls -l *.log'
X	popen 1	-w 'cat	| sort > /tmp/sorted'
X
X
X
X
X    6.2.49  prompt
X    usage: prompt <str>
X
X    This command allows	selection of an	alternate prompt to the	 interactive
X    mode  HOME command trigger.	 Refer to the section titled "ECUPROMPT" for
X    more information on	the interactive	mode prompt.
X
X    Note: the interactive and  procedure  hangup  commands  both  cause	 the
X    default prompt to be reestablished.
X
X
X    Example:
X
X	 prompt	%rname+' >'    use remote name in prompt
X
X
X
X    6.2.50  ptrace
X
X    usage: ptrace [ <str> | off	]
X
X
X    This command controls procedure  execution	tracing.   Trace  output  is
X    written to the screen and varys in its nature depending upon the command
X    being traced.  Specifically, any change to a string	or integer  variable
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      57
X
X
X
X    is noted.  If tracing is enabled, the output will also be written to any
X    active procedure log  file	(see  the  plog	 interactive  and  procedure
X    commands).
X
X
X    6.2.51  putf
X
X    Not	yet implemented.
X
X
X    6.2.52  return
X    usage: return [<int>]
X
X    This command causes	the  currently	executing  procedure  to  terminate,
X    returning  either to a calling procedure or	to the interactive mode.  If
X    <int> is supplied, if  it  nonzero,	 then  all  procedure  execution  is
X    terminated	and  the  integer status is printed on the screen along	with
X    the	name of	the executing procedure.
X
X
X    6.2.53  rk
X    usage: rk [-a]
X
X    This command invokes the Kermit file receive protocol.  If	switch	'-a'
X    is	omitted,  the  received	 files	are  stored  as	 received; otherwise
X    carriage return/linefeed pairs are converted to  newlines.	 The  remote
X    sender must	have been started prior	the the	execution of this command.
X
X
X    6.2.54  rname
X    usage: rname <str>
X
X    Normally, the %rname string	function returns  the  same  string  as	 the
X    logical  dialing directory entry.  This command allows the default value
X    to be overridden with a user-selected value	(63-character maximum).
X
X    This feature is useful in  situations  where  one  system  is  initially
X    dialed,  but  a connection is made to yet another system from the dialed
X    system via networking.
X
X
X    6.2.55  rs
X    usage: rs
X
X    This command invokes the SEAlink file receive  protocol.   There  is  no
X    provision  in  the	SEAlink	protocol to convert carriage return/linefeed
X    pairs to newlines, so the received files are stored	 as  received.	 The
X    remote  sender  must  have	been started prior the the execution of	this
X    command.
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      58
X
X
X
X    6.2.56  rx
X    usage: rx [-a] <str>
X
X    This command invokes the XMODEM file receive protocol  to  receive	file
X    <str>.   If	 switch	 '-a'  is  omitted,  the  received file	is stored as
X    received; otherwise	carriage  return/linefeed  pairs  are  converted  to
X    newlines.	The  remote  sender  must  have	 been  started prior the the
X    execution of this command.
X
X
X    6.2.57  ry
X    usage: ry
X
X    This command invokes the YMODEM Batch (not to be confused  with  XMODEM-
X    1K)	 protocol  to receive files from a remote system.  The remote sender
X    must have been started prior the the execution of this command.
X
X
X    6.2.58  rz
X    usage: rz
X
X    This command invokes the ZMODEM protocol to	receive	files from a  remote
X    system.   The  remote  sender  must	 have  been  started  prior  the the
X    execution of this command.
X
X
X    6.2.59  scrdump
X    usage: scrdump [<str>]
X
X    This command causes	the current screen contents to be stored in a  file.
X    If	<str>  is  supplied,  it  is  used  as	a pathname.  If	<str> is not
X    supplied, "~/.ecu/screen.dump".  The actions of the	 interactive  sdname
X    command have no effect on the execution of this command.
X
X
X    6.2.60  send
X    usage: send	[-n] <str>
X
X    This command sends <str> to	the communications line.  If the '-n' switch
X    is	omitted, a carriage return (0x0D) is transmitted after <str>.  If '-
X    n' is supplied, no carriage	return is transmitted.
X
X
X    Examples:
X
X	send 'ps -au'
X	send -n	%chr(0x02)+"START'+%chr(0x03)
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      59
X
X
X
X    6.2.61  set
X
X    usage: set [$]i<name>=<int-expression>[, ...]
X	   set [$]s<name>=<str-expression>[, ...]
X
X
X    This command sets an integer or string variable to an  expression.	 The
X    'set'  verb	 may  be  omitted  provided  the  otherwise  optional '$' is
X    supplied.  There are many examples of how the set statement	is performed
X    throughout	this document.	The examples here are to further clarify the
X    statement's	syntax.
X
X    If the  '=<expression>'  is	 omitted,  the	value  of  the	variable  is
X    displayed  (useful	when  debugging).    If	procedure tracing is enabled
X    with the ptrace command, all variables referenced by  the  set  command,
X    whether a value is assigned	or not,	are displayed.
X
X
X    Examples:
X
X	set i0=0
X	set $s0='brown',s1='The	quick '+$s0+' fox'
X	set $S0		     with no '=', displays contents
X	set i0,$i1,s0='abc',s1
X	$s0 = 'abc'	     legal
X	set s0='abc'	     legal
X	s0 = 'abc'	     illegal
X
X    6.2.62  sk
X    usage: sk [-a] <str>
X
X    This command invokes the Kermit file transfer protocol to  send  one  or
X    more  files.   If  switch  '-a'  is	 supplied, newlines are	converted to
X    carriage return/linefeed pairs.  If	'-a' is	 omitted,  the	file(s)	 are
X    transmitted	without	modification.
X
X    Integer variable $i0 receives the exit status from the transfer.   Note:
X    procedure  execution  is  NOT terminated by	a SIGINT to the	spawned	file
X    transfer process.  It is the responsibility	of the procedure to  process
X    the	exit status returned in	$i0.  If $i0 is	set to -1, the file transfer
X    program did	not begin.
X
X
X    6.2.63  ss
X    usage: ss <str>
X
X    This command invokes the SEAlink file transfer protocol to send  one  or
X    more  files.   There  is no	provision in the SEAlink protocol to convert
X    newlines to	carriage return/linefeed pairs.	 so the	received  files	 are
X    stored as received.
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      60
X
X
X
X    Integer variable $i0 receives the exit status from the transfer.   Note:
X    procedure  execution  is  NOT terminated by	a SIGINT to the	spawned	file
X    transfer process.  It is the responsibility	of the procedure to  process
X    the	exit status returned in	$i0.  If $i0 is	set to -1, the file transfer
X    program did	not begin.
X
X
X    6.2.64  sx
X    usage: sx [-ak[l]] [<label-str>] <filename-str>
X
X    This command invokes the XMODEM or XMODEM-1K file transfer	protocol  to
X    send  a  file.  If '-k' is supplied, XMODEM-1K is used, else XMODEM.  If
X    switch  '-a'  is  supplied,	  newlines   are   converted   to   carriage
X    return/linefeed  pairs.  If	'-a' is	omitted, the file(s) are transmitted
X    without modification.  If '-l' is supplied,	then <label-str> specifies a
X    string to display on the bottom of the file	transfer screen.  If '-l' is
X    omitted, then <label_str> must also	be omitted.
X
X    Integer variable $i0 receives the exit status from the transfer.   Note:
X    procedure  execution  is  NOT terminated by	a SIGINT to the	spawned	file
X    transfer process.  It is the responsibility	of the procedure to  process
X    the	exit status returned in	$i0.  If $i0 is	set to -1, the file transfer
X    program did	not begin.
X
X
X    Examples:
X
X	sx -al 'sending	log file' '/tmp/log.file'
X	sx -
X
X
X
X    6.2.65  sy
X    usage: sy [-a[l]] [<label-str>] <filelist-str>
X
X    This command invokes the YMODEM Batch (not to be confused  with  XMODEM-
X    1K)	file transfer protocol to send one or more files.
X
X    If	switch	'-a'  is  supplied,  newlines  are  converted  to   carriage
X    return/linefeed  pairs.  If	'-a' is	omitted, the file(s) are transmitted
X    without modification.  If '-l' is supplied,	then <label-str> specifies a
X    string to display on the bottom of the file	transfer screen.  If '-l' is
X    omitted, then <label_str> must also	be omitted.
X
X    Integer variable $i0 receives the exit status from the transfer.   Note:
X    procedure  execution  is  NOT terminated by	a SIGINT to the	spawned	file
X    transfer process.  It is the responsibility	of the procedure to  process
X    the	exit status returned in	$i0.  If $i0 is	set to -1, the file transfer
X    program did	not begin.
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      61
X
X
X
X    6.2.66  system
X    usage: system [-l] <cmdstr>
X
X    If switch '-l', is supplied, the attached  communications  line  becomes
X    the	stdin and stdout for the command.
X
X    Integer variable $i0 is set	to the spawned process'	exit status  if	 the
X    process  exits "normally", or 0x100	if the process is killed, dumps	core
X    or interrupted.
X
X    Note:  procedure execution is NOT terminated by a SIGINT to	the  spawned
X    process.   It is the responsibility	of the procedure to process the	exit
X    status returned in $i0.  If	$i0 is set to -1, the file transfer  program
X    did	not begin.
X
X
X    6.2.67  sz
X    usage: sz [-anf[l]]	[<label-str>] <filelist-str>
X
X    This command invokes the ZMODEM (CRC-32 capable) file transfer  protocol
X    to send one	or more	files.
X
X    Switch '-n'	causes the receiver to accept  files  with  do	not  already
X    exist  at  the  remote  system or which have older times of	 last access
X    that at the	sending	system.
X
X    Switch '-f'	  causes  the  full  pathname  of  each	 file  to  be  sent;
X    otherwise, the simple filename is transmitted.
X
X    If	switch	'-a'  is  supplied,  newlines  are  converted  to   carriage
X    return/linefeed  pairs.  If	'-a' is	omitted, the file(s) are transmitted
X    without modification.
X
X    If '-l' is supplied, then <label-str> specifies a string to	 display  on
X    the	 bottom	 of  the  file	transfer  screen.   If '-l' is omitted,	then
X    <label_str>	must also be omitted.
X
X    Integer variable $i0 receives the exit status from the transfer.   Note:
X    procedure  execution  is  NOT terminated by	a SIGINT to the	spawned	file
X    transfer process.  It is the responsibility	of the procedure to  process
X    the	exit status returned in	$i0.  If $i0 is	set to -1, the file transfer
X    program did	not begin.
X
X
X    6.2.68  vidcolor
X    usage: vidcolor <type> <fcolor> [<bcolor>]
X
X    This command allows	control	over the internal color	choices	 ecu  makes.
X    <type> must	be one of the following:
X
X
X
X
X
X    Public Domain by wht@n4hgf		  5/7/90
X
X
X
X
X
X
X
X    ECU	Technical Description				      62
X
X
X
X	 normal	  - normal video color
X	 reverse  - reverse video color
X	 notify	  - color used for low key notifications such as
X		    "[interactive mode]" and "[procedure finished]"
X	 success  - color used for modem CONNECT messages and other
X		    "success" notifications
X	 alert	  - color used to alert	user for warning or caution
X		    purposes
X	 error	  - color used to display error	status or messages
X
X
X    <fcolor> and <bcolor> are color names as described in the description of
X    the	 color	command.  <fcolor>  choses  the	foreground color and must be
X    supplied.  <bcolor>	choses the background color and	is optional; if	 not
X    supplied, the background color is black.
X
X    Note: The vidcolor normal and reverse options are analogs of  the  color
X    and	color -r command.
X
X
X    Examples:  (showing	ecu default internal color list)
X
X	vidcolor normal	lt_green
X	vidcolor reverse red white
X	vidcolor notify	gray
X	vidcolor success lt_green
X	vidcolor alert yellow
X	vidcolor error red
X
X
X
X    6.2.69  vidnorm
X    usage: vidnorm
X
X    This command causes	later screen output to	appear	in  the	 normal,  as
SHAR_EOF
echo "End of ecuman280 part 2"
echo "File doc/ecu.man is continued in part 3"
echo "3" > @shar_seq_.tmp
exit 0