Source Code 1994 March/Source_Code_CD-ROM_Walnut_Creek_March_1994.iso/compsrcs/misc/volume32/ecuman/part02

Text File | 1992-09-15 | 57.3 KB | 2,081 lines

Newsgroups: comp.sources.misc
From: [e-mail] (Warren Tucker)
Subject:  v32i078:  ecuman - Manual for ECU comm package rev 3.20, Part02/05
Message-ID: <[e-mail]>
X-Md4-Signature: e3d1d09376c2ce047e998870e716d0e2
Date: Tue, 15 Sep 1992 16:56:10 GMT
Approved: [e-mail]

Submitted-by: [e-mail] (Warren Tucker)
Posting-number: Volume 32, Issue 78
Archive-name: ecuman/part02
Environment: SCO,XENIX,ISC,SUNOS,SYSVR4,HDB,Curses
Supersedes: ecuman: Volume 21, Issue 90-93

---- Cut Here and feed the following to sh ----
#!/bin/sh
# this is ecuman320.02 (part 2 of ecuman320)
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/ecu.man continued
#
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
X
X
X    4.1.2  Other Fields
X
X    The    'tty' field may    be used    to select an outgoing line other than the
X    default.  For important considerations on line choice, see the sections
X    titled "Choosing a Dialout Line" and "DCDwatch".
X
X    The    'duplex' field may be used to select a duplex value other than the
X    default 'F'    (full).
X
X    The    'baud' field may be used to select a baud rate value other than    the
X    default selected at    Configure time.
X
X    The    'parity' field may be used to select a parity value other than the
X    default selected at    Configure time.
X
X
X    The    'Add NL    to transmitted CR' and 'Add NL to received CR' fields are
X    usually left defaulted to 'N' (no).     If you    will be    communicating with a
X    terminal (as in a chat with    a human), you will usually need    to set both
X    of these fields to 'Y' as well as to select    'H'alf duplex.
X
X
X    4.1.3  Keyboard Functions
X
X    Special keyboard characters    while filling in the startup screen are:
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      29
X
X
X
X      Enter           terminate entry in a field (or skip to
X               the next    field if you do    not modify it)
X
X      ^B           back up to previous field
X
X      Cursor Up    same as ^B (if the key is available on
X               your terminal and environment).
X
X      TAB           move to next field ... if nothing typed in
X               the field, do not disturb contents
X
X      Cursor Down  same as TAB (if the key is available on
X               your terminal and environment).
X
X      END           proceed with session, dialing remote if
X               logical directory entry name or literal
X               telephone number    enetered
X
X      ^D           enter phone directory
X
X      ESC           quit ecu    without    starting a session
X
X
X    When editing a multicharacter field, such as "tty",    you may    use the
X    backspace key in the traditional fashion.  Depending on the    terminal,
X    ECU    version    in use (OS in use), and    configuration, you may also be able
X    to use the cursor left and right keys and the insert key (to toggle
X    insert mode).
X
X
X    4.2     Command Line Switches and Arguments
X
X
X    ECU    can be started in a number of ways:
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                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      30
X
X
X
X     o  with no switches or    arguments
X        select options interactively; manual command to    begin
X        connection
X
X     o  with switches (excluding -p) and no    arguments
X        override some defaults for options but still enter
X        interactive option selection; manual command to    begin
X        connection
X
X     o  zero or more switches (excluding -p) and one argument
X        fully automatic    startup    to connect to the remote
X        specified by the argument (a telephone number
X        or dialing directory entry)
X
X     o  zero or more switches, with    -p the last switch
X        fully automatic    startup    by executing procedure whose
X        name is    specified by the first argument; the initial
X        procedure receives the remainder of the    command    line
X        arguments
X
X
X
X    4.2.1  Usage Summary
X
X
X     usage:    ecu [-l    <ttyname>] [-b <baud_rate>] [-eon]
X            [-h] [-t] [-P <phonedir>]
X            [-F    name] [-T <trace-level>]
X            [-p    <initial_proc> [-d] [-D] | <phone_number>]
X     -D unconditionally stop execution when    -p initial
X        procedure is done
X     -F sets an alternate funckeymap name for the *keyboard*
X     -P choose alternate phone directory (<phonedir> must be
X        a full pathname)
X     -T set    procedure tracing to level: 0=none, 1=standard,
X        2=ECU-debugging
X     -b choose baud    rate (any UNIX rate 110-38400)
X     -d stop execution if -p initial procedure fails
X     -e even parity      -o odd parity      -n no    parity
X     -h half duplex    ... default is full duplex
X     -l choose line    (/dev/<ttyname>)
X     -p execute an initial procedure
X     -t append NL to incoming and outgoing CR characters
X     <phone_number>    is either an actual number or a    dialing
X        directory entry name
X
X
X
X    4.2.2  Switches
X
X    Many switches are used to override defaults    specified at the time the
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      31
X
X
X
X    Confifgure procedure was used.  Note these defaults    may also be
X    overriden interactively if the command does    not specify automatic
X    startup option (-p or dialing argument).  Also, the    value chosen by    a
X    dialing directory entry or an initial procedure will override the
X    Configured default and/or the value    specified by this switch.
X
X
X    4.2.2.1  -b    <baud>
X
X    This switch    overrides the default baud rate.  Any valid UNIX rate may be
X    chosen. ECU    chooses    the number of stop bits    based on the baud rate.
X    Rates below    300 baud get 2 stop bits.  Rates 300 baud and above get    one
X    stop bit.
X
X
X    4.2.2.2  -d
X
X    The    -d switch instructs ECU    to "die" (terminate with error status) if an
X    initial procedure (-p) fails.  This    switch ensures a batch ECU execution
X    will hang up any connection    and terminate if a procedure error occurs.
X    See    also -D    below.
X
X    Absence of the -d and -D switches causes ecu (upon any completion of the
X    initial procedure) to enter    the 1) interactive mode    if a line was
X    successfully attached by the procedure or 2) the setup screen if no    line
X    was    attached.
X
X
X    4.2.2.3  -e, -o, -n
X
X    Normally, ECU starts up with data bits and parity chosen at    Configure
X    time.  The -e, -o and -n switches allow you    to override the    default.
X
X    Since combinations like eight data bit and even parity or seven data
X    bits and no    parity are not in  ECU's capability to use, the    parity
X    selection also dictates the    choice of data bits. Even or odd parity
X    implies seven data bits.  No parity    implies    eight data bits.
X
X
X    4.2.2.4  -h
X
X    Normally, ECU starts up in the full    duplex mode.  If half duplex is
X    desired, the -h switch is used.
X
X
X    4.2.2.5  -l    ttyspec
X
X    When ECU starts up,    it normally chooses a line as described    later in the
X    section titled "Choosing a Dialout Line".  Specifying the -l switch
X    overrides the default tty specified    at Configure time.  Depending upon
X    other command line options,    this switch may    be nothing more    than a hint.
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      32
X
X
X
X    The    argument to the    switch is the base name    of the tty (e.g., "tty1a" or
X    "acu0").  On SCO, since ttys are all named consistently according to the
X    "/dev/ttyxx" form, you may omit the    "tty" (e.g., "1a" or "4g").
X
X    For    important considerations on line choice, see the sections titled
X    "Choosing a    Dialout    Line" and "DCDwatch".
X
X
X    4.2.2.6  -p    <proc>
X
X    The    -p switch causes ECU to    execute    the procedure <proc> ("<proc>.ep")
X    immediately    upon startup.  Such a procedure    is termed the initial
X    procedure.    It is recommended that,    when used, -p be the last switch on
X    the    command    line.  All non-switch arguments    after <proc> are passed    as
X    arguments to the initial procedure (see the    descriptions of    the integer
X    function %argc and the string function %argv in the    Procedure Manual).
X
X    For    example,
X
X    ecu -p batchjob    remsys 22
X    automatically executes the procedure command equivalent
X    do 'batchjob' 'remsys' '22'
X
X
X    The    initial    procedure may read command line    options    with functions like
X    %line, %baud and %parity.  It is also free to override any of these
X    values it wishes.  See the procedure manual    for more information.
X
X
X    4.2.2.7  -t
X
X    The    -t switch instructs ECU    to map incoming    and outgoing carriage
X    returns to carriage    return/line feed pairs.     This is helpful if the
X    remote connection will be to a display terminal rather than    a computer.
X    Use    of the -h switch may also be necessary.
X
X    The    interactive commands nlin and nlout also control this feature.
X
X
X    4.2.2.8  -D
X
X    The    -D switch instructs ECU    to unconditionally terminate when an initial
X    procedure finishes.     Contrast with the -d switch.
X
X
X    4.2.2.9  -F    name
X
X    Normally, the TERM environment variable is used to determine the
X    funckeymap entry (keyboard configuration) to be used.  Sometimes, the
X    TERM variable is not adequate for identifying your keyboard    arrangement.
X    The    -F switch switch, like the $ECUFUNCKEY environment variable, allows
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      33
X
X
X
X    you    to use override    the funckeymap entry used.  For    more information,
X    see    the section titled "Function Key Mapping (Recognition)".
X
X
X    4.2.2.10  -P phonedir
X
X    The    -P switch causes ECU to    begin execution    using an alternate phone
X    directory.    The default is ~/.ecu/phone.  You should specify a full
X    pathname if    you anticipate using the change    directory command once ecu
X    starts.
X
X
X    4.2.2.11  -T level
X
X    The    -T switch sets the procedure language trace level.  <level> is a
X    decimal digit.  0 is for no    tracing    (the default) and 1 is for tracing.
X    Values higher than 1 are for debugging ECU and have    varying    effects    from
X    revision to    revision.
X
X
X    4.2.3  Non-Switch Arguments
X
X    Aguments are optional.  <tel-number> or <logical> may appear when the -p
X    switch is absent.  One or more <arg> arguments may appear when the -p
X    switch is used.  These arguments are handled as described by "-p" above.
X
X
X    4.2.3.1  <tel-number>
X
X    This type of argument has a    digit as its initial character and
X    represents an actual telephone number to be    passed to a modem dialer
X    program or Dialers chat script.  The string    may contain non-numeric
X    characters if appropriate for a dialer program, such as dialTBIT or
X    dialgT2500 (see the    gendial    subdirectory).    For example:
X
X    ecu -ltty2a -b 19200 -e    5551212C
X
X    uses tty2a (assumed    to be connected    to a Trailblazer modem because of
X    the    dialer-specific    telephone number) and establishes a 19200 baud,    even
X    parity PEP Compressed connection after dialing 5551212.
X
X
X    4.2.3.2  <logical>
X
X    This type of argument has an alphabetic initial character and causes the
X    dialing directory entry by that name to be dialed.    The line may be
X    specified by '-l', but if the dialing directory specifies a    line (tty
X    field contains other than 'Any'), the dialing directory entry will
X    override it.  The '-b', '-e' and '-o' switches are ignored;    the values
X    specified by the dialing directory entry are used.    The '-t' and '-h'
X    switches are valid and honored if present.
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      34
X
X
X
X    4.2.3.3  <arg>
X
X    This type of argument is passed to an initial procedure when the -p
X    switch is present.
X
X
X    ecu    -p unixlogin user pwd ansi43
X
X    executes unixlogin.ep with arguments 'user'    'pwd' 'ansi43'
X
X    For    more detail, refer to the description of -p, -d    and -D below.
X
X
X    4.3     Environment Variables
X
X
X    Prior to starting ECU, it is useful, but not necessary, to establish two
X    environment    variables, ECUPROMPT and ECUHELP.
X
X
X    4.3.1  ECUPROMPT
X
X    The    ECUPROMPT environment variable determines the prompt printed by    ECU
X    when the interactive command key ("HOME") is pressed.  When    you first
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    4.3.2  ECUHELP
X
X    Ordinarily,    ECU looks for interactive command help information in
X    "ecuhelp.data" (in the ecu library directory, normally
X    /usr/local/lib/ecu).  The ECUHELP environment may be set to    the complete
X    pathname of    the ecu    help file if an    alternate file is to be    used.
X
X    The    help file is explained later in    the section titled "Online Command
X    Dictionary".
X
X
X    4.3.3  ECUFUNCKEY
X
X    See    the description    of the -F command line switch and the section titled
X    "Function Key Mapping (Recognition)".
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      35
X
X
X
X    5.    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 enter    the entire command
X    in most cases.  The    portion    of each    command    which must be entered is
X    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    5.1     AUTORZ    : Automatic ZMODEM Receive
X
X    Usage: autorz [off | on | ]
X
X    ECU    in the interactive mode    (no procedure executing) can interpret a
X    SUB, 'B', '0', '0' receive data sequence as    a ZMODEM ZRQINIT frame and
X    automatically begin    a ZMODEM receive operation.  This command controls
X    or displays    this feature.  By default, this    feature    is turned on.
X
X
X    5.2     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    5.3     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 a baud rate    less than 300 is selected, 2
X    stop bits are automatically    specified; other baud rates set    1 stop bit.
X    If <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
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      36
X
X
X
X    5.4     BN : all console event    alarm
X
X    Usage: bn [    off | on | alert ]
X       bn [    0 | 1 |    2 ]
X
X
X    "bell notify": If no parameter is supplied,    the current setting is
X    displayed.    Specifying 0 or    off disables the facility; 1 or    on causes an
X    audible alarm to be    sounded    upon receipt of    a bell (0x07) character    from
X    the    remote system; 2 or alert causes an audible alarm upon receipt of
X    ANY    characters.  This command may not be functional    in the version for
X    your system.
X
X    On SCO, different alarm styles are sent depending upon the type of event
X    causing the    alarms.     The alarms consist of Morse characters.  Even if
X    you    do not understand Morse, the patterns of the alarm tones are
X    distinct enough to be distinguishable.
X
X    Additionally on SCO, if you    are running ECU    from a multiscreen, the
X    alarms will    be signalled even if you have temporarily switched to
X    another screen.
X
X    BN is set to 1 (on)    when ECU begins    executing.
X
X
X    5.5     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    5.6     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
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      37
X
X
X
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    arguments.
X
X    5.7     DA : decimal to ascii char
X
X    usage: da [<decimal-val>]
X
X
X    <decimal-val> is a decimal value between 0 and 256;    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    5.8     DCDwatch
X
X    usage: dcdwatch [<dcdwatch-param>]
X
X
X    This command controls the DCD watcher.  The    optional parameter may be:
X
X       y  yes -    enable DCD watcher
X       n  no - disable DCD watcher
X       t  terminate - terminate    ECU on loss of DCD
X
X    Entering the command without an argument shows the current status.
X
X    The    DCD watcher when enabled causes    ECU to monitor the DCD line (within
X    the    limits imposed by the OS with its CLOCAL=0 functionality).  When the
X    watcher is on and DCD drops, ecu automatically performs the    action of
X    the    interactive or procedure hangup    command.  If the 't'erminate option
X    is chosen, then after hangup processing is complete, the ECU program
X    will terminate.
X
X    The    state of the watcher may be changed by the use of the dial command
X    which uses a directory entry that changes the DCD watcher status.
X
X    The    DCD watcher depends upon the tty driver    to return zero on a read
X    when DCD is    low when the termio flag CLOCAL    is reset.  The tty driver
X    must ignore    DCD if CLOCAL is set.  If your system offers a "modem" and
X    "direct" choice (by    choice of filename), you probably need to use the
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      38
X
X
X
X    "modem" choice for this to work properly.  However,    the choice depends
X    upon the needs of the underlying driver you    are using.  For    instance, if
X    you    are using FAS in a shared modem    application, your getty    should use
X    the    "modem"    choice and ECU should use the "direct" choice.    Some
X    experimentation may    be required.
X
X
X    5.9     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
X    (initial digit) or a logical name (initial letter) which can be found in
X    the    user phone directory (in file ~/.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.  (If the last character of    a telephone number is a
X    dollar sign, it is removed and is replaced with the    contents of the
X    first line in ~/.ecu/credit.  See the description of the dialing
X    directory.)
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 "ep"    (normally
X    /usr/local/lib/ecu/ep) 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 directory to
X    select a number to dial, as    well as    add, remove and    edit entries.
X
X    5.9.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    Using the dial command with    a directory entry may change the DCD watcher
X    (dcdwatch) status.    See the    section    on the dcdwatch    command    for more
X    information.
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
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      39
X
X
X
X    5.9.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.  Pressing 'c' will cause the pause to be
X    prematurely    terminated and the next    attempt    to be made.  Pressing your
X    interrupt key (DEL,    ^C or whatever)    aborts the cycle.  If you interrupt
X    an active dialing attempt, you will    be prompted as to whether or not you
X    wish to 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    5.9.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    subdirectory "ep" (normally    /usr/local/lib/ecu/ep) whose name matches
X    the    logical    name, then the procedure is executed with the argument
X    '!MENU'.  It is the    responsibility of the automatically executed
X    procedure to establish connection with the remote system (by using the
X    procedure dial command).  An example of an automatic login procedure can
X    be found in    the distribution subdirectory 'models' named 'sysname.ep'.
X    A companion    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
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      40
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    5.10  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 and in    the ep subdirectory of the library directory
X    (usually /usr/local/lib/ecu/ep).  One or more arguments may    be passed to
X    the    procedure.  Arguments are made available in the    called procedure by
X    use    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    5.11  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    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      41
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    5.12  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    5.13  FI : send text file to line
X
X    usage: fi [<filename>]  [ |    f | e |    s]
X                f full speed transmission
X                e echo pacing
X                s single line transmission
X
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
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      42
X
X
X
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    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    5.14  FKEy : function key definition
X
X    usage: fkey    [<keyset_name>]
X       fkey    -r
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    -r resets the key handler to the same state    as when    ECU was    started.
X    See    the section above titled "Standard Function Keys".
X
X    If a keyset_name matches a logical dial directory name, it is loaded
X    after a connection is established.
X
X    The    characters in the mapped string    may be any printable character or
X    one    of the following:
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      43
X
X
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    5.15  FKMap    : funckeymap (function key recognition)    management
X
X    usage: fkmap
X       fkmap <keyname>
X       fkmap <keyname> <keylist>
X       fkmap -r
X       fkmap -s <file>
X
X
X    This command manages the mechanism ECU uses    to recognize function keys
X    when they are entered at the console.  Entering the    command    with no
X    arguments displays the current mapping in funckeymap format.
X
X    If supplied, the first argument to the command must    be the recognized
X    name of a function key from    the list:
X
X     F1    F2 F3 F4 F5 F6 F7 F8 F9    F10 F11    F12
X     Home End PgUp PgDn    CUP CUL    CU5 CUR    CUD
X
X    The    case of    the entered argument is    unimportant.
X
X    If only one    argument is supplied, the mapping for the specified key    is
X    displayed.    If more    than one argument is supplied, the keyboard mapping
X    is changed.     Arguments 2-n are character code specifiers in    the format
X    used to define a funckeymap    entry.
X
X    WARNING: If    found to be syntactically correct, a mapping change is
X    installed immediately.  If incorrect mapping of the    HOME key is
X    requested, you may lose control of ECU.
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      44
X
X
X
X    The    -r form    rereads    the original funckeymap    definition (as at program
X    invocation), reseting the mapping.    The -s switch saves the    current
X    mapping to <file>.
X
X
X    Examples:
X
X    fkmap f10    display    F10 mapping
X    fkmap Home ^Z    map Home to ^Z
X            after this command, type ^Z for    Home
X
X
X
X    5.16  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    5.17  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    5.18  KBDTest : test keyboard mapping
X
X    usage: kbdtest
X
X
X    This command runs a    keyboard test which asks you to    press function keys
X    (e.g., F1).     For each key pressed, ECU gives you the actual    character
X    sequence generated by the key.  It also tells you which function key it
X    recognizes (if any).  mapping of keyboard generated    character sequences
X    to ECU internal key    codes.    The command is useful for verifying and
X    debugging a    "funckeymap" entry.  To    exit the test at any time, press the
X    escape key.
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      45
X
X
X
X    5.19  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
X    5.20  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    5.21  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    Switches are meaningful only when used in conjunction with a filename to
X    start logging.
X
X
X
X    5.22  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
X
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      46
X
X
X
X    5.23  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    5.24  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    5.25  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
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      47
X
X
X
X    5.26  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    5.27  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    5.28  PLog : procedure logging
X
X    usage: plog    [ <filename> | off]
X
X
X    This command enables or disables procedure logging.
X
X
X    5.29  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
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      48
X
X
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    5.30  PTrace : control procedure trace
X
X    usage: ptrace [ on | off | #]
X     on  - set trace state to 1
X     off - set trace state to 0
X     #   - set trace to numeric value #
X
X
X    This command controls whether or not procedure execution is    to be
X    traced. Trace output is written to the screen and varies 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).
X
X    The    majority of procedure tracing features use the current trace state
X    as a binary    condition.  That is, either tracing is done or not.
X    However, the procedure command expresp emits varying levels    of debugging
X    output in a    manner similar to the uucico -x    flag.
X
X    Issuing the    command    with no    argument shows current status.
X
X
X    5.31  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    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
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      49
X
X
X
X    Examples:
X       pushd
X       pushd /tmp
X
X
X
X    5.32  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    5.33  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    5.34  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    5.35  RK : receive via C-Kermit
X
X    usage: rk
X
X
X    This command invokes C-Kermit to receive files. ECU    searches the PATH
X    list for 'kermit' or 'ckermit', expecting to find Columbia University
X    C-Kermit version 5A(173) or    later.    The file ~/.kermrc must    be set up to
X    have any desired initialization parameters you desire (refer to C-Kermit
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      50
X
X
X
X    documentation for more information).  The remote protocol must have    been
X    started prior to the execution of this command.
X
X    WARNING: until further notice, avoid suspending Kermit with    ^Z.  ECU is
X    totally unprepared to act as a job control process group leader.
X
X
X    5.36  RS : receive via SEAlink
X
X    usage: rs
X
X
X    This command invokes a SEAlink receive protocol.
X
X
X    5.37  RTScts : control RTS/CTS flow    control
X
X    usage: rtscts [ off    | on | no | yes    | 0..7 ]
X
X
X    This command controls the RTS/CTS flow control feature of the line
X    driver (which may or may not work).     This is a very    confusing area
X    though it should not be.
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    SCO's sio driver before UNIX 3.2v4/ODT 2.0 does half duplex    flow
X    control.  FAS does hardware    flow control based on the device magic
X    number, but    if you use a device number specifying no hardware flow
X    control, RTSFLOW and CTSFLOW can be    used to    specify    SCO-style flow
X    control.  CRTSFL offers full duplex    line control on    3.2v4 and later    ONLY
X    for    SCO's sio driver.
X
X
X      arg |    RTSFLOW    | CTSFLOW    arg | RTSFLOW | CTSFLOW | CRTSFL
X     -----+---------+---------  -----+---------+---------+--------
X      off |      0    |   0          0     |   0       |   0     |
X      on  |      0    |   1          1     |   0       |   1     |
X      no  |      0    |   0          2     |   1       |   0     |
X      yes |      0    |   1          3     |   1       |   1     |
X                      4     |   0       |   0     |     1
X
X    Choice 4 only works    on SCO 3.2v4 and ODT 2.0.  As you can see, numeric
X    values are masks.  If the 4    bit is present in the numeric value, it
X    overrides the lower-order bits:  Specifying    7 as an    argument specifies
X    CRTSFL is to be used if it is supported, otherwise RTSFLOW and CTSFLOW.
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      51
X
X
X
X    Under System V Release 4, an TCGETX/TCSETX manipulation is performed,
X    modifying the x_hflag bits as follows:
X
X     argument | RTSXOFF | CTSXON    argument | RTSXOFF | CTSXON
X     ---------+---------+---------    ---------+---------+---------
X       off      |   0        |    0      0     |   0       |   0
X       on      |   0        |    1      1     |   0       |   1
X       no      |   0        |    0      2     |   1       |   0
X       yes      |   0        |    1      3     |   1       |   1
X
X    Under SunOS    4.1, only CTS support is provided.  You    should read the
X    termio and zs man pages.  Arguments    result in the stated manipulations
X    of the termio element c_cflag:
X
X     argument | CRTSCTS    argument    | CRTSCTS
X     ---------+---------  ----------+---------
X       off      |   0          0    |   0
X       on      |   1          1    |   1
X       no      |   0
X       yes      |   1
X
X
X
X    5.38  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    5.39  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
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      52
X
X
X
X    reset with stty(C)).
X
X
X
X    5.40  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. The remote sender must have been started prior to the
X    execution of this command.    File transfer progress is presented on a
X    visual display. To abort the transfer, press your interrupt    key (usually
X    DEL    unless reset with stty(C)).
X
X    If automatic ZMODEM    frame detection    is enabled and ECU is in the
X    interactive    mode, this command is executed automatically.  Automatic
X    ZMODEM frame detection is NOT supported during procedure execution.
X
X
X
X    5.41  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    5.42  SK : send via    C-Kermit
X
X    usage: sk [<file-list>]
X
X
X    This command invokes C-Kermit to send files. ECU searches the PATH list
X    for    'kermit' or 'ckermit', expecting to find Columbia University C-
X    Kermit version 5A(173) or later.  The file ~/.kermrc must be set up    to
X    have any desired initialization parameters you desire (refer to C-Kermit
X    documentation for more information).  The remote protocol must have    been
X    started prior to the execution of this command.
X
X    WARNING: until further notice, avoid suspending Kermit with    ^Z.  ECU is
X    totally unprepared to act as a job control process group leader.
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      53
X
X
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
X    5.43  SS : send via    SEAlink
X
X    usage: ss [<file-list>]
X
X
X    This command invokes a SEAlink file    transmission protocol.
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    5.44  STat : verbose status    summary
X
X    usage: stat
X
X
X    This command displays comprehensive    status and statistics.    Example
X    display:
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                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      54
X
X
X
X     % stat
X    Date: 08-17-1992 05:47:49 (UTC 09:47)
X    Communications line: /dev/tty2b 9600-N-1
X    XON/XOFF input on output on
X    Hardware flow control configuration:
X    RTSFLOW off    CTSFLOW    off CRTSFL off
X    Not    connected to a remote
X    Duplex: full  DCD watcher: off
X    Console: /dev/ttyp7    80x43 <pty>
X    Acquired by    ecuungetty: /dev/tty2b
X    Current directory: /u1/src/ecu
X    Total chars    transmitted: 234 (since    CONNECT    142)
X    Total chars    received:    2278 (since CONNECT 1478)
X    No function    key set    loaded
X    Session logging not    active
X    Bell notify    is ON
X    CR conversion:  incoming CR     outgoing CR
X    Keyboard ESC/funckey time constant = 300 msec
X    Pids: xmtr=20878 rcvr=20882    parent=19476 pgrp=19476
X
X
X
X    5.45  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     .--[ 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
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      55
X
X
X
X    5.46  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    5.47  SZ : send via    ZMODEM/CRC32
X
X    usage: sz [<file-list>]
X
X
X    This command sends files to    the remote system using    ZMODEM/CRC32.  The
X    remote receiver must have been started prior to the    execution of this
X    command unless the remote has automatic ZMODEM frame detection.
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: not all ZMODEM receiving software supports transfer of only newer
X    files or of    resuming interrupted transfers.     If the    remote receiver    does
X    not    support    the feature, it    may skip (reject) all your files.  Retry the
X    transfer specifying    'N' to 'Transfer only newer files' and/or 'Resume
X    interrupted    transfer'.
X
X
X
X
X
X
X
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      56
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    |  Resume interrupted transfer: N                     |
X    |  Window size: 0                             |
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: resume transfer at remote file EOF, N send all -----------'
X    `--    Y: send    only if    source newer than destination, N send all ---'
X    `--    window size (max bytes sent before ACK required) 0 = stream -'
X
X
X
X    5.48  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.49  TTy :    console    tty name
X
X    usage: tty
X
X
X    This command displays the current console tty name.
X
X
X
X    5.50  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    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      57
X
X
X
X    5.51  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    5.52  ! : 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                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      58
X
X
X
X    6.    HoneyDanBer UUCP Interface
X
X
X
X    6.1     Control Files
X
X
X    This section describes how ecu uses    verious    HDB UUCP control files found
X    in the UUCP    library    directory (e.g., /usr/lib/uucp on SCO and ISC or
X    /etc/uucp on SunOS and SVR4).
X
X
X    6.1.1  Devices
X
X    ECU    reads this file    to determine what tty devices are available for
X    outgoing calls. The    fourth field must contain a baud rate or range of
X    baud rates acceptable for the line.     The fifth field of each entry must
X    contain either the full pathname of    an (SCO) modem dialer program (with
X    leading slash) or the name of an entry in the HDB Dialers file (no
X    leading slash).  For more information, consult the UUCP documentation
X    for    your system and    see "Dialers" and "Choosing a Dialout Line" below.
X
X
X    6.1.2  Dialers
X
X    Dialers entries may    be specified in    the Devices entry. ECU provides
X    Dialers support that is largely compatible with most System    V HDB uucico
X    programs.  Refer to    your system's UUCP documentation for general usage
X    instructions.  Refer to the    procedure command expresp for a    precise    list
X    of escape sequences    supported by ECU.
X
X
X    6.1.3  Sysfiles
X
X    Sysfiles support is    not yet    provided.  The Devices and Dialers files
X    must have their default names.
X
X
X    6.1.4  Systems
X
X    No use is made of the Systems file at this time.  ECU provides the
X    equivalent function    with its dialing directory.
X
X
X    6.2     Choosing a Dialout Line
X
X
X    When using the interactive dial command, or    when dialing from the
X    initial menu, if a logical or system name is specified, the    directory
X    entry is fetched and examined.  If the tty field specifies a value other
X    than "Any",    the specific line requested is opened, if available, and
X
X
X
X    Public Domain by wht@n4hgf                  9/7/92
X
X
X
X
X
X
X
X    ECU    Technical Description                      59
X
X
X
X    dialing commences. If the specified    line is    not available, the dial
SHAR_EOF
true || echo 'restore of doc/ecu.man failed'
fi
echo 'End of ecuman320 part 2'
echo 'File doc/ecu.man is continued in part 3'
echo 3 > _shar_seq_.tmp
exit 0

exit 0 # Just in case...