Usenet 1994 October/usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso/misc/volume12/ecuman2.80/part02

Text File | 1990-05-11 | 54KB | 2,231 lines

Newsgroups: comp.sources.misc
subject: v12i084: ECU 2.80 manual part 02/03
from: [e-mail] (Warren Tucker)
Sender: [e-mail] (Brandon S. Allbery - comp.sources.misc)

Posting-number: Volume 12, Issue 84
Submitted-by: [e-mail] (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