Usenet 1994 October/usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso/misc/volume21/ecuman/part02

Text File | 1991-08-09 | 55KB | 2,093 lines

Newsgroups: comp.sources.misc
From: Warren Tucker <[e-mail]>
Subject:  REPOST: v21i091:  Manual for ECU comm package rev 3.10, Part02/04
Message-ID: <[e-mail]>
X-Md4-Signature: 15b71571fc1f2c98a29aad62d3d58733
Date: Fri, 9 Aug 1991 18:11:51 GMT
Approved: [e-mail]

Submitted-by: Warren Tucker <[e-mail]>
Posting-number: Volume 21, Issue 91
Archive-name: ecuman/part02
Environment: SCO, XENIX, ISC
Supersedes: ecuman3: Volume 16, Issue 22-24

[ Trouble with this getting out so lets try again... -Kent+ ]

---- Cut Here and feed the following to sh ----
#!/bin/sh
# this is ecuman310.02 (part 2 of ecuman310)
# 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
if test ! -f _shar_wnt_.tmp; then
    echo 'x - still skipping doc/ecu.man'
else
echo 'x - continuing file doc/ecu.man'
sed 's/^X//' << 'SHAR_EOF' >> 'doc/ecu.man' &&
X    run    ECU, try setting it to your name, e. g.,
X
X     setenv    ECUPROMPT Ralph       if you use csh
X
X     ECUPROMPT=Ralph       if you use sh, ksh, etc.
X     export    ECUPROMPT
X
X    Then, when you see how it used, you    may wish to establish a    more
X    permanent choice in    your .login or .profile.
X
X
X    3.3.2  ECUHELP
X
X    Ordinarily,    ECU looks for interactive command help information in
X    "/usr/lib/ecu/ecuhelp.data".  The ECUHELP environment may be set to    the
X    complete pathname of the ecu help file if an alternate file    is to be
X    used.
X
X    The    help file is explained later in    the section titled "Online Command
X    Dictionary".
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                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      28
X
X
X
X    4.    Interactive Mode Commands
X
X
X    The    following is a partial list of commands    available in the interactive
X    (non-procedure) mode.  It is not necessary to to enter the entire
X    command in most cases.  The    portion    of each    command    which must be
X    entered is capitalized in the following section headers.
X
X    Refer to the sections titled Interactive Command History and Line
X    Editing for    more information.
X
X
X    4.1     AX : ascii char to hex/oct/dec
X
X    usage: ax [<param>]
X
X
X    <param> may    be a single ASCII character, a standard    ASCII identifier
X    (such as ETX), or a    two-character control character    identifier (such as
X    ^C,    typed as a caret followed by a C).
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    4.2     BAud :    set/display line baud rate
X
X    usage: baud    [<baud-rate>]
X
X
X    <baud-rate>, if specified, must be taken from the values 110, 300, 600,
X    1200, 2400,    4800, 9600, 19200 and 38400.  On some systems, 19200 and
X    38400 may not be supported.     If baud rate 110 is selected, 2 stop bits
X    are    automatically specified; other baud rates set 1    stop bit.  If
X    <baud-rate>    is not supplied, the current baud rate is displayed.
X
X    The    setting    may be automatically changed as    the result of a    'dial'
X    command.  See also the dial    and parity command descriptions.
X
X
X
X    4.3     BN : all console event    alarm
X
X    usage: bn [    0 | 1 |    2 ]
X
X
X    "bell notify": If no argument is supplied, the current setting is
X    displayed.    Specifying 0 disables the facility; 1 causes an    audible
X    alarm to be    sounded    on all of the XENIX virtual consoles upon receipt of
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      29
X
X
X
X    a bell (0x07) character from the remote system; 2 causes an    audible
X    alarm to be    sent to    all consoles upon receipt of ANY characters from the
X    remote system.  A non-zero value also causes an audible alarm to be    sent
X    to all console upon    the successful completion of a 'redial'    command
X    which must retry more than one redial attempt or upon completion of    a
X    file transfer operation.
X
X    Different alarms are sent depending    upon the the type of event causing
X    the    alarms.
X
X    BN is set to 1 when    ECU begins executing.
X
X    The    setting    of this    command    has no effect if ECU is    not run    from a
X    multiscreen.
X
X
X    4.4     BReak : send break to remote
X
X    usage: break
X
X
X    This command sends a break signal to the remote system.
X
X
X
X    4.5     CD : change current directory
X
X    usage: cd [<dir-path>]
X
X
X    This command allows    you to change the working directory of the ECU
X    process.  If <dir-path> is supplied, the previous working directory    is
X    displayed, and <dir-path> is made the new working directory.  A history
X    of previous    directory changes is maintained.  Entering the cd command
X    shows the numbered history list and    allows you to select a new directory
X    by entering    the number.  Other commands allow deletion of directories
X    from the list or saving the    list to    file ~/.ecu/dir.  This file is
X    automatically read at ECU startup, providing a convenient list of
X    directories    available for quick selection.    If you edit this file by
X    hand, you may force    ECU to re-read the file    using the %read    option.
X
X    The    %xmitcd    option transmits "cd "+current_directory+CR to the remote, a
X    convenience    to set the remote current directory to the same    as your
X    local one.
X
X    The    %pushd # option    pushes the current directory onto the same stack
X    used by the    pushd interactive command and changes the current directory
X    to the numbered directory specified    by #.  Use the popd interactive
X    command to return to the previous directory.
X
X    Other %options have    usage information by entering them with    no
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      30
X
X
X
X    arguments.
X
X    4.6     DA : decimal to ascii char
X
X    usage: da [<decimal-val>]
X
X
X    <decimal-val> is a decimal value between 0 and 0377; the parity (sign)
X    bit    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    4.7     Dial :    dial remote destination
X
X    usage: dial    [<dial-param>]
X
X
X    <dial-param> may take one of two forms, a telephone    number to dial or a
X    logical name which can be found in the user    phone directory    (in file
X    ~/.ecu/phone).
X
X    If a telephone number is supplied, the phone number    is dialed; you must
X    first have set the desired baud rate and parity using the baud and
X    parity commands.
X
X    If a logical name is entered, the phone directory is searched; if the
X    entry is found, the    baud rate and parity is    automatically set.  if a
X    procedure file can be found    in the current directory, the user's home
X    .ecu subdirectory or the ECU library directory (normally
X    /usr/local/lib/ecu)    whose name matches the logical name, then the
X    procedure is executed with the argument '!INTERACTIVE'.
X
X    If <dial-param> is not supplied, then a screen-oriented self-documenting
X    <:-)> directory manager is executed; you may scan the the directory    to
X    select a number to dial, as    well as    add, remove and    edit entries.
X
X    4.7.1  Alternate Dialing Directory
X
X    The    default    dialing    directory is ~/.ecu/phone.  You    may change to
X    another directory by issuing the interactive dial command with no
X    arguments to enter the dialing directory menu, selecting 'c'hange dial
X    directory, and entering the    name of    a new directory.  The specified
X    pathname must either be a fully qualified pathname or a pathname
X    relative to    the current working directory.    Once an    alternate directory
X    has    been selected, it will be used by both the interactive command 'dial
X    <logical>' and the dialing directory menu.
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      31
X
X
X
X    See    the section below titled "Choosing a Dialout Line" for more
X    information    on using "Any" in the "tty" field of a directory entry.
X
X
X    4.7.2  Multi-Number    Redial Cycle
X
X    While in the  dialing directory, you may "mark" one    or more    entries    for
X    a cyclical redial attempt.    When any entry is marked, typing ENTER
X    (carriage return or    line feed/newline) causes each marked entry to be
X    dialed in turn until one of    the remote systems is successfully
X    connected.    When a successful connection occurs, ECU unmarks the
X    associated entry, leaving the others marked.  Thus,    you may    mark several
X    entries and    merely reenter the dialing directory after each    connection
X    is finished    and press ENTER    to reenter the redial cycle.  If a single
X    entry is marked, ECU pauses    15 seconds between each    dialing    attempt,
X    otherwise 5    seconds.  Presing 'c' will cause the pause to be prematurely
X    terminated and the next attempt to be made.     Pressing your interrupt key
X    (DEL, ^C or    whatever) aborts the cycle.  If    you interrupt an active
X    dialing attempt, you will be prompted as to    whether    or not you wish    to
X    cycle to the next entry or abort the cycle.
X
X    If no entries are marked for redial, the current, highlighted directory
X    entry is used for dialing.
X
X    To unmark a    single entry, press 'M'    (uppercase M).    To unmark all
X    entries, press 'U'.
X
X
X    4.7.3  Automatic Dialing/Login Procedure
X
X    Upon dialing from the menu,    if a procedure file can    be found in the
X    current directory, the user's home .ecu subdirectory or the    ECU library
X    directory (normally    /usr/local/lib/ecu) whose name matches the logical
X    name, then the procedure is    executed with the argument '!MENU'.  It    is
X    the    responsibility of the automatically executed procedure to establish
X    connection with the    remote system (by using    the procedure dial command).
X    An example of an automatic login procedure can be found in the
X    distribution subdirectory 'models' named 'sysname.ep'.  A companion
X    procedure is 'unixlogin.ep'.
X
X    For    example,
X
X    | entry name | telephone number | tty | baud P | ...
X    | sysname     | 555-1234        | Any | 2400 N | ...
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      32
X
X
X
X    #-----------------------------------------------------------
X    # sysname.ep - procedure to    call UNIX-like system 'sysname'
X    #
X    # CONFIDENTIAL - This function should be chmod 0600    because
X    # it contains a password which you probably    don't want to be
X    # common knowledge.
X    #
X    # This procedure calls 'unixlogin.ep' to do    the hard work.
X    #-----------------------------------------------------------
X
X    mkvar $s_pwd(20)    # local variable preserves password
X    $s_pwd = 'password' # security by disappearing when the
X                # procedure    terminates
X
X    #    also, by keeping the password text off the following line,
X    #    the password will not be displayed if you abort    (interrupt)
X    #    the procedure
X
X    do 'unixlogin' %argv(0)    'username' $s_pwd 'ansi-or-whatever'
X
X
X
X    4.8     DO : perform procedure
X
X    usage: do <procname> [<arg>    ... ]
X
X
X    Perform ECU    procedure.  Ecu    searches for <procname>.ep in the current
X    directory.    If the file is not found, the program looks for    the file in
X    the    ~/.ECU directory.  One or more arguments may be    passed to the
X    procedure.    Arguments aare made available in the called procedure by use
X    of the %argc integer function and %argv string function.
X
X    Unlike arguments to    the do procedure command, arguments to the do
X    interactive    command    are not    quoted and may not contain embedded spaces
X    or tabs.
X
X
X
X    4.9     DUplex    : set/display duplex
X
X    usage: 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
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      33
X
X
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    nl,    nlin and nlout commands    may also be required.
X
X    The    default    setting    for duplex is full.
X
X
X
X    4.10  EXit : drop carrier, exit program
X
X    usage: exit
X
X
X    This command terminates ECU    promptly.  If your modem does not drop
X    carrier upon loss of Data Terminal Ready (DTR), the    command    will
X    terminate ECU, but may leave the communications line off hook.  It is
X    strongly recommended that you configure your modem to hang up the phone
X    line when DTR drops.  A shorthand version of this command exists: '.' is
X    equivalent to exit.
X
X
X
X    4.11  FI : send text file to line
X
X    usage: fi [<filename>]
X
X
X    "file insert": This    command    causes file characters to be inserted into
X    the    transmit data stream as    though they had    been entered at    the
X    keyboard.  No error    correction is provided,    although XON/XOFF flow
X    control is obeyed.
X
X    If <filename> is not entered on the    command    line, a    prompt for the
X    filename is    made.  Once the    filename has been entered and file has been
X    opened, you    are asked whether the file should be transmitted at full
X    speed, by "echo pacing" or by a single line    at a time.  You    may also
X    append an 'f', 'e' or 's' argument to the command line.
X
X    If your remote can tolerate    it, full speed transmission is the fastest.
X    Some systems are not capable of receiving large amount of data
X    ("streaming    data") without pauses.    Even with "full" speed transmission,
X    some "pacing" (inter-character delay) is introduced    to ease    loading    on
X    the    remote system.    Pressing the interrupt key (DEL) stops a full speed
X    transmission.
X
X    By specifying echo pacing, it is possible to increase the likelihood of
X    proper receipt.  Echo pacing reads the return data stream to attempt to
X    keep from overloading the remote.  Pressing    the interrupt key (DEL)
X    stops an echo paced    transmission.
X
X    As a last resort, if echo pacing is    not working for    you, (i.e., you    are
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      34
X
X
X
X    using the command in an environment    where the remote does not echo your
X    characters), single    line at    a time transmission is available.  With
X    "single" line transmission,    you must press the space key to    initiate
X    sending each line.    Pressing the 'ESC' or 's' key stops the    transfer.
X
X
X    4.12  FKey : function key definition
X
X    usage: fkey    [<keyset_name>]
X
X
X    This command allows    the mapping of function    keys F1-F12, PgUp, PgDn, End
X    and    Ins and    the cursor up, down, left and right keys to emit a desired
X    sequence of    characters when    a function key is pressed.  <keyset_name>
X    specifies which key    set in ~/.ecu/keys is to be selected. Sample entry:
X
X     hayes
X         F1:escape:+ + +
X         F2:autoans:A T S 0    = 1 cr
X         F3:dial:A T D T
X     bbs
X         F1:cancel:^K
X         F2:yes:y cr
X
X
X    If a keyset_name matches a logical dial directory name, it is loaded
X    when the number is dialed.
X
X    The    characters in the mapped string    may be any printable character or
X    one    of the following:
X
X     map ->    character    map -> character
X     ---    -----------    ---    ------------
X     nul    0 000 00 ^@  |    dle    16 020 10 ^P
X     soh    1 001 01 ^A  |    dc1    17 021 11 ^Q
X     stx    2 002 02 ^B  |    dc2    18 022 12 ^R
X     etx    3 003 03 ^C  |    dc3    19 023 13 ^S
X     eot    4 004 04 ^D  |    dc4    20 024 14 ^T
X     enq    5 005 05 ^E  |    nak    21 025 15 ^U
X     ack    6 006 06 ^F  |    syn    22 026 16 ^V
X     bel    7 007 07 ^G  |    etb    23 027 17 ^W
X     bs    8 010 08 ^H  |    can    24 030 18 ^X
X     ht    9 011 09 ^I  |    em     25 031 19 ^Y
X     nl    10 012 0a ^J  |    sub    26 032 1a ^Z
X     vt    11 013 0b ^K  |    esc    27 033 1b ^[
X     ff    12 014 0c ^L  |    fs     28 034 1c ^(
X     cr    13 015 0d ^M  |    gs     29 035 1d ^]
X     so    14 016 0e ^N  |    rs     30 036 1e ^^
X     si    15 017 0f ^O  |    us     31 037 1f ^_
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      35
X
X
X
X    4.13  HAngup : hang    up modem
X
X    usage: hangup
X
X
X    This causes    DTR to be momentarily interrupted, terminating any
X    outstanding    connection.  Your DCE (modem) must be able to drop carrier
X    upon loss of DTR.
X
X
X    4.14  HElp : invoke    help
X
X    usage: help    [<cmd-name>]
X
X
X    Issuing this command with no argument displays a list of commands
X    followed by    a request for a    command    for further information.
X
X
X    4.15  LLp :    set session log    to /dev/lp
X
X    usage: llp
X
X
X    This command is a shorthand    version    of 'log    /dev/lp'.  /dev/lp must    not
X    be under the control of a print spooler.
X
X
X    4.16  LOFf : turn off session logging
X
X    usage: loff
X
X
X    This command is shorthand for 'log off'.  If session logging is active,
X    it is turned off.
X
X
X    4.17  LOG :    session    logging    control
X
X    usage: log [-s] [-r] [ | off | filename ]
X    -s "scratch" previous file contents; otherwise append
X    -r "raw" logging; otherwise non-printable characters
X        other than tab and newline are omitted from    the log
X
X
X    This command controls session logging; issuing the command with no
X    argument causes the    status of session logging to be    displayed.  The
X    special argument 'off' causes active logging to be terminated.  Other
X    argument values cause logging to start using the argument as a filename.
X    Issuing a log command with a filename when logging is already active
X    causes the previous    file to    be closed and the new file to be opened.
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      36
X
X
X
X    Switches are meaningful only when used in conjunction with a filename to
X    start logging.
X
X
X
X    4.18  NL : display CR/LF mapping
X
X    usage: nl
X
X
X    Display the    current    setting    of CR/LF mapping.  For more information,
X    refer to the nlin and nlout    command    descriptions.
X
X
X
X    4.19  NLIn : set receive CR/LF mapping
X
X    usage: nlin    [<y-n>]
X
X
X    This command controls whether or not a newline (NL/LF) character is    sent
X    to the screen upon receipt of a carriage return (CR) from the remote
X    system.  Most remote computers supply a NL after CR.  When communicating
X    with another terminal in a "teletype conversation",    this is    generally
X    not    the case (see also the duplex command).
X
X    Issuing the    command    without    <y-n> causes the current setting to be
X    displayed.    The format of <y-n> is flexible: 'y' or    '1' enables
X    appending NL to CR,    'n' or '0' causes the feature to be disabled.
X
X
X
X    4.20  NLOut    : set transmit CR/LF mapping
X
X    usage: nlout [<y-n>]
X
X
X    This command controls whether or not a newline (NL/LF) character is    sent
X    to the remote system upon transmission of a    carriage return    (CR) entered
X    by the keyboard.  Most remote computers do not require (indeed
X    "dislike") a NL after CR.  When communicating with another terminal    in a
X    "teletype conversation", this is generally not the case (see also the
X    duplex command).
X
X    Issuing the    command    without    <y-n> causes the current setting to be
X    displayed.    The format of <y-n> is flexible: 'y' or    '1' enables
X    appending NL to CR,    'n' or '0' causes the feature to be disabled.
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      37
X
X
X
X    4.21  OA : octal to    ascii char
X
X    usage: oa [<octal-val>]
X
X
X    <octal-val>    is a octal value between 0 and 0377; 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    4.22  PARity : set/display line parity
X
X    usage: parity [ None | Even    | Odd ]
X
X
X    This command controls the parity of    characters transmitted by the
X    keyboard.  Issuing the command with    no argument displays the current
X    setting.  When the argument    is supplied, only the first character is
X    required.  Even or odd parity implies seven    data bits; no parity implies
X    eight data bits.  Parity of    incoming characters is not checked.
X
X    The    setting    may be automatically changed as    the result of an interactive
X    or procedure dial command.    See the    baud and dial command descriptions.
X
X
X
X    4.23  PId :    display    process    ids
X
X    usage: pid
X
X
X    This command displays the process id of the    ECU transmitter    process, the
X    ECU    receiver process and the process ids of    ECU's parent and group.
X
X
X    4.24  PLog : procedure logging
X
X    usage: plog    [ <filename> | off]
X
X
X    This command enables or disbles procedure logging.
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      38
X
X
X
X    4.25  POpd : pop to    previous directory
X
X    usage: popd    [ | <#>    | all]
X
X
X    This command returns to a previous directory after a pushd command has
X    been previously executed.
X
X    If no argument is supplied,    the directory at the immediately previous
X    level is restored.
X
X    If a numeric argument is supplied, the directory at    the specified level
X    is restored; the level numbers may be obtained by issuing a    pushd
X    command with no arguments.
X
X    If the 'all' argument is supplied, it is treated as    a numeric argument
X    of 0; that is the directory    stack is cleared and the directory at level
X    0 is restored.
X
X    The    directory stack    is shared between interactive and procedure
X    commands.  Neither beginning nor ending a procedure    affects    the
X    directory stack level.
X
X
X    Examples:
X       popd
X       popd 3
X       popd all
X
X
X
X    4.26  PTrace : control procedure trace
X
X    usage: ptrace [ 0 |    1 | on | off]
X
X
X    This command controls whether or not procedure execution is    to be
X    traced. Trace output is written to the screen and varys in its nature
X    depending upon the command being traced.  Specifically, any    change to a
X    string or integer variable is noted.  If tracing is    enabled, the output
X    will also be written to the    procedure log file (see    the interactive    and
X    procedure commands).  Issuing the command with no argument shows current
X    status.
X
X
X    4.27  PUshd    : push to new directory
X
X    usage: pushd [ | <dir>]
X
X
X    This command either    1) saves the current directory pathname    on a stack
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      39
X
X
X
X    and    establishes a new current directory or 2) displays the current stack
X    and    current    directory.  The    stack size is 10.
X
X    If no argument is supplied,    the directory stack is displayed.
X
X    The    directory stack    is shared between interactive and procedure
X    commands.  Neither beginning nor ending a procedure    affects    the
X    directory stack level.
X
X
X    Examples:
X       pushd
X       pushd /tmp
X
X
X
X    4.28  PWd :    print working directory
X
X    usage: pwd
X
X
X    This command prints    the current working directory of the ECU process.
X
X
X
X    4.29  REDial : redial last number
X
X    usage: redial [<retry-count> [<pause-interval>]]
X
X
X    This command redials a number previously dialed with the 'dial' command.
X    Modem status is tested and multiple    retries    may be made.  <retry-count>
X    specifies how many retries are to be made.    <pause-interval> specifies
X    how    many seconds the program pauses    after a    failure    to connect.  You
X    must specify <retry-count> in order    to specify <pause-interval>.  The
X    default value for <retry-count> is 10, for <pause-interval>    is 60.
X
X    You    should know that in some jurisdictions,    it is ILLEGAL to dial the
X    same telephone number more than a specified    number of times    during some
X    interval of    time.  In any case, a <pause-interval> less than 15 seconds
X    is silently    changed    to 15 seconds.
X
X
X    4.30  REV :    ECU revision/make date
X
X    usage: rev
X
X
X    This command displays ECU's    revision, the transmitter process id' and
X    the    date and time ECU was made.
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      40
X
X
X
X    4.31  RK : receive via C-Kermit
X
X    usage: rk
X
X
X    This command searches the PATH list    for 'ckermit' (Columbia    University
X    C-Kermit) and invokes it to    receive    files.
X
X    The    file ~/.kermrc must be set up to have any desired initialization
X    paraeters you desire.  Refer to C-Kermit documentation for more
X    information.
X
X
X
X    4.32  RS : receive via SEAlink
X
X    usage: rs
X
X
X    This command invokes a SEAlink receive protocol.
X
X
X    4.33  RTScts : control RTS/CTS flow    control
X
X    usage: rtscts [ off| on | no | yes | 0 | 1 | 2 | 3 ]
X
X
X    This SCO-only command controls the RTS/CTS flow control feature of the
X    SCO    UNIX/XENIX line    driver (which may or may not work).
X
X    If no argument is supplied,    the current setting is displayed.
X    Specifying 0 or n disables the facility; 1 or y causes RTS/CTS flow
X    control to be enabled.
X
X    What the command does is to    manipulate the RTSFLOW and CTSFLOW bits    of
X    the    termio c_cflag word (see termio(S)).
X
X    As of this writing,     SCO's driver does half    duplex (traditional, brain
X    damaged) flow control if RTSFLOW is    enabled.  FAS does hardware flow
X    control based on the device    magic number, but if you use a device number
X    specifying no hardware flow    control, RTSFLOW and CTSFLOW can be used to
X    specify SCO-style flow control.  Advice: use rts on    or off for SCO,    use
X    appropriate    magic numbered device for FAS.
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      41
X
X
X
X     argument | RTSFLOW | CTSFLOW    argument | RTSFLOW | CTSFLOW
X     ---------+---------+---------    ---------+---------+---------
X       off      |   0        |    0      0     |   0       |   0
X       on      |   0        |    1      1     |   0       |   1
X       no      |   0        |    0      2     |   1       |   0
X       yes      |   1        |    1      3     |   1       |   1
X
X
X
X    4.34  RX : receive via XMODEM/CRC
X
X    usage: rx
X
X
X    This command invokes ecurz to receive files    from the remote    system using
X    XMODEM/CRC.
X
X    After entering the command,    you are    prompted as to whether or not file
X    CR/LF characters are to be converted to newlines.  If you are
X    transferring text files from a system which    contain    CR/LF line
X    terminators, you must answer yes to    this question.    You should answer no
X    when transferring binary files, such as executables, .arc files and    the
X    like.  File    transfer progress is presented on a visual display.  To
X    abort the transfer,    press your interrupt key (usually DEL unless reset
X    with stty(C)).
X
X
X
X    4.35  RY : receive via YMODEM Batch
X
X    usage: ry
X
X
X    This command invokes ecurz to receive files    from the remote    system using
X    YMODEM batch with CRC-16 error correction.    The YMODEM is "true YMODEM",
X    not    XMODEM-1k.  File transfer progress is presented    on a visual display.
X    To abort the transfer, press your interrupt    key (usually DEL unless
X    reset with stty(C)).
X
X
X
X    4.36  RZ : receive via ZMODEM/CRC32
X
X    usage: rz
X
X
X    This command invokes ecurz to receive files    from the remote    system using
X    ZMODEM/CRC32.  File    transfer progress is presented on a visual display.
X    To abort the transfer, press your interrupt    key (usually DEL unless
X    reset with stty(C)).
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      42
X
X
X
X    4.37  SDNAME : select screen dump file name
X
X    usage: sdname [<filename>]
X
X
X    When the "cursor 5"    key is pressed,    the screen contents are    dumped to a
X    file.  By default, this file is named '~/.ecu/screen.dump'.     This
X    command either displays or changes the current screen dump file name,
X    depending upon whether or not a argument is    supplied.
X
X    The    actions    of this    command    have no    effect on the operation    of the
X    procedure command.
X
X    See    the section titled "Screen Dump" for more information.
X
X
X    4.38  SK : send via    C-Kermit
X
X    usage: sk [<file-list>]
X
X
X    This command searches the PATH list    for 'ckermit' (Columbia    University
X    C-Kermit) and invokes it to    send files.  The file ~/.kermrc    must be    set
X    up to have any desired initialization paraeters you    desire.
X
X    After entering the command,    you are    prompted as to whether or not file
X    newline characters are to be converted to CR/LF.  If you are
X    transferring text files to a system    which requires CR/LF line
X    terminators, you must answer yes to    this question.    You should answer no
X    when transferring binary files, such as executables, .arc files and    the
X    like.  You are prompted to enter a list of files to    send, which may
X    contain one    or more    wildcard specifications.
X
X    The    file ~/.kermrc must be set up to have any desired initialization
X    arguments you desire.  Refer to C-Kermit documentation for more
X    information.
X
X
X
X    4.39  SS : send via    SEAlink
X
X    usage: ss [<file-list>]
X
X
X    This command invokes a SEAlink file    transmission protocol.
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      43
X
X
X
X
X     .--[ Send SEAlink ]-------- dir: /u1/src/ecu ------------------.
X     |                                    |
X     |    File(s)    to send:                        |
X     |    ___________________________________________________________ |
X     |                                    |
X     |      TAB:next  ^B:prev  END:perform transfer  ESC:abort        |
X     `-- enter file(s) to send -------------------------------------'
X
X
X
X    4.40  STat : connection status
X
X    usage: stat
X
X
X    This command displays statistics about ECU usage.  Example display:
X
X    Date/time: 06-14-1988 11:40:35 (UTC    15:40)
X    Total chars    transmitted: 178
X    Total chars    received:    3681
X
X    Date/time: 06-14-1988 14:41:24 (UTC    18:41)
X    Connected to CompuHost (555-1234) at 14:40:57
X    Parameters:    2400-N-1 Connect time: 00:01:27
X    Total chars    transmitted: 234 (since    CONNECT    142)
X    Total chars    received:    2278 (since CONNECT 1478)
X
X
X
X    4.41  SX : send via    XMODEM/CRC
X
X    usage: sx [<file-name>]
X
X
X    This command invokes ecusz to send a file to the remote system using
X    XMODEM/CRC.
X
X    After entering the command,    you are    prompted as to whether or not file
X    CR/LF characters are to be converted to newlines.  If you are
X    transferring text files from a system which    contain    CR/LF line
X    terminators, you must answer yes to    this question.    You should answer no
X    when transferring binary files, such as executables, .arc files and    the
X    like.
X
X    You    are prompted to    enter a    filename to send.  File    transfer progress is
X    presented on a visual display.  To abort the transfer, press your
X    interrupt key (usually DEL unless reset with stty(C)).
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      44
X
X
X
X     .--[ Send XMODEM/CRC ]----- dir: /u1/src/ecu -----------.
X     |                                 |
X     |    File to    send:                         |
X     |    ____________________________________________________ |
X     |                                 |
X     |    Binary:    Y (no NL-CR/LF translation)             |
X     |                                 |
X     |     TAB:next  ^B:prev  END:perform    transfer  ESC:abort  |
X     `-- enter file(s) to send ------------------------------'
X
X
X
X    4.42  SY : send via    YMODEM Batch
X
X    usage: sy [<file-list>]
X
X
X    This command invokes ecusz to send file(s) to the remote system using
X    YMODEM/CRC.
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     .--[ Send YMODEM/CRC ]----- dir: /u1/src/ecu -----------.
X     |                                 |
X     |    File to    send:                         |
X     |    ____________________________________________________ |
X     |                                 |
X     |    Binary:    Y (no NL-CR/LF translation)             |
X     |                                 |
X     |     TAB:next  ^B:prev  END:perform    transfer  ESC:abort  |
X     `-- enter file(s) to send ------------------------------'
X
X
X
X    4.43  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
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      45
X
X
X
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    |  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    4.44  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    4.45  TTy :    console    tty name
X
X    usage: tty
X
X
X    This command displays the current console tty name.
X
X
X
X    4.46  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    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      46
X
X
X
X    4.47  XON :    xon/xoff flow control
X
X    usage: xon [<arg>]
X    where <arg>    is on     input and output flow control
X           off     no flow control
X           in     input flow control
X           out     output    flow control
X
X
X    This command enables or disables xon/xoff flow control.  If    the argument
X    is omitted,    the current flow control state is displayed.
X
X
X    4.48  ! : 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    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      47
X
X
X
X    5.    Procedures
X
X
X    Procedures are "programs" or "scripts" written in an addled    but adequate
X    language which ECU executes    upon demand.  An "initial procedure" may be
X    executed when ECU starts up    (see the description of    the -p command line
X    switch).  Certain special procedures are executed automatically as
X    described below in the section "Special Procedures."
X
X
X    5.1     Procedures
X
X
X    The    procedures themselves are source files consisting of the procedure
X    "name" with    an extension of    ".ep".    When executing a procedure by name,
X
X     do name       interactive
X     -or-
X     do 'name'     from insikde a procedure
X
X    is sufficient if the procedure is in the current directory,    the user's
X    ~/.ecu directory or    in the ECU library directory (normally
X    /usr/local/lib/ecu).  Procedure files are search for in the    above order,
X    so you may have a system default in    the lib    directory, a user default in
X    the    ~/.ecu directory and a specific    version    in the current directory all
X    by the same    name.
X
X    Many example procedures, some useful, some not so, are found in the
X    models subdirectory    of the release.     There are also    several    complrete
X    procedures and many    fragments used as examples throughout the following
X    sections.
X
X
X    5.2     Line Syntax (Labels, Commands and Comments)
X
X    Lines in a procedure consist of an optional    label, followed    by optional
X    commands and arguments.  Anything on a line    after an octothorpe (#)
X    outside of quote marks is ignored (read "# is the comment character.")
X
X    Labels must    begin in column    one.  Commands must have white space before
X    them.  A label may appear on a line    by itself or with a comment
X    appended.  A common    mistake    I make (from writing too much C) is to
X    append a colon to a    label derclaration; this does not work unless you
X    also "goto LABEL:".     Labels    are not    allowed    inside braces (inside if
X    compound statements).  You may get away with it sometimes because the
X    procedure language processor is written for    speed, not political
X    correctness.
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      48
X
X
X
X    5.3     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    5.3.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    5.3.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    5.3.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    5.3.3.1  Constants
X
X    Integer constants are numeric strings, optionally with an initial minus
X    sign, the absolute value of    which must be less than    2147483648.  If    the
X    constant begins with the string "0x", it is    interpreted as hexadecimal.
X    Octal, like    FORTRAN    and COBOL will be dead soon; until then, however,
X    octal constants may    be denoted by a    leading    "0o".
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      49
X
X
X
X    Examples:
X        123      --> 123(10)
X        0123  --> 123(10)
X        0x123 --> 291(10)
X        0o123 -->  83(10)
X
X
X
X    5.3.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    5.3.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    5.3.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    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      50
X
X
X
X    5.3.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    5.3.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    The    absolute maximum size is 5120 characters.
X
X    Null in strings are    poorly handled.     You may be able to get    away with
X    using them,    but it is not recommended.
X
X
X    5.3.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 (I am no nroff    guru and backslashes
X    give it gas, so):
X
X    backslash-backslash    one backslash
X    backslash-n        newline
X    backslash-t        tab
X    backslash-apostrophe    apostrophe
X
X
X    NOTE: ecu converts every tab in a procedure    line to    one space when the
X    procedure file is read in.    Therefore, if you wish to place    a tab in a
X    string constant, you must place it there with the \t escape    sequence.
X
X
X    5.3.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
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      51
X
X
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. Created variables
X    have a life    equal to the duration of the procedure which created them.
X    Regardless of the declared size of a created string    variable, ECU will
X    automatically grow it to a maximum of 5120 characters as necessary.
X    Numbered (permanent) string    variables have a maximum size of 256 bytes.
X
X
X    5.3.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    5.3.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    5.3.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    5.4     Commands
X
X
X
X    5.4.1  baud
X
X    usage: baud    <baud-int>
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      52
X
X
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    5.4.2  break
X
X    usage: break
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    5.4.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
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      53
X
X
X
X    5.4.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    5.4.5  cls
X
X    usage: cls
X
X    This command clears    the screen.
X
X
X    5.4.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    5.4.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
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      54
X
X
X
X    the    first command in the loop.
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    5.4.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    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      55
X
X
X
X    5.4.9  delline
X
X    usage: delline
X
X    This command deletes the current line from the video display.
X
X
X    5.4.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    See    the section on the interactive "Dial" command and the section titled
X    "Choosing a    Dialout    Line" for more information.
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    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      56
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    5.4.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    5.4.12  duplex
X
X
X
X
X
X    Public Domain by wht@n4hgf                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      57
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    5.4.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    5.4.14  eeol
X
X    usage: eeol
X
X    This command erases    the video display to the end of    the line.
X
X
X    5.4.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                 7/25/91
X
X
X
X
X
X
X
X    ECU    Technical Description                      58
SHAR_EOF
true || echo 'restore of doc/ecu.man failed'
fi
echo 'End of ecuman310 part 2'
echo 'File doc/ecu.man is continued in part 3'
echo 3 > _shar_seq_.tmp
exit 0
--------------------------------------------------------------------
Warren Tucker, TuckerWare emory!n4hgf!wht or [e-mail]
Hacker Extraordinaire  d' async PADs,  pods,  proteins and protocols

exit 0 # Just in case...
--
Kent Landfield                   INTERNET: [e-mail]
Sterling Software, IMD           UUCP:     uunet!sparky!kent
Phone:    [phone]         FAX:      [phone]
Please send comp.sources.misc-related mail to [e-mail].