 Copyright    1/1 

LiveWire Communications Version 2.2

Professional Shareware Software

User Manual
&
Script Language Reference

Copyright 1990-1994 Les Novell
DataMirage Software

 Introduction    2/1 

Introduction
LiveWire Communications is the 32-bit, multi-threaded, text-based
tele-communications program for OS/2 2.0 and later. Highly optimized, packed
full of features, and yet easy to use, LiveWire is an excellent replacement for
DOS communications packages which are unable to take full advantage of OS/2.

Features
LiveWire's text-based interface is designed to be easy to use and configure,
especially for users familiar with other communications software. LiveWire also
has many features unavailable in other communications programs. The following
is a list of major features incorporated in LiveWire 2.2.
         
 o Full TTY, ANSI, OS2You, VT-102, and 0+ Avatar  emulations

 o Integrated REXX scripting language

 o Data rates up to 57,600 bps without loss of data

 o High performance output in windowed and full screen sessions

 o Unlimited scroll-back buffer

 o 80 preset modem configurations to choose from

 o Internal public domain Zmodem-32 batch with resume

 o Named pipe support for network modems and connections

 o Point and shoot dialing directory with superior editing facilities

 o Macro commands control the actions of most function or alternate keys; all
   keys are re-definable

 o Automatic detection and installation of external protocols such as M2Zmodem,
   CKermit, SEALink, and ZedZap

 o Support for Procomm+, Qmodem, Boyan, Telix, and LiveWire keysets. This
   feature is meant to decrease the time required to learn LiveWire by
   providing familiar keycommand definitions.

 o Dialing directory reads and writes Procomm, Procomm+, Qmodem, Boyan, and
   Telix dialing directories.

 o Point-and-shoot file selection, using a multi-threaded file navigator.

 Installation    3/1 

Installation

          To install LiveWire, first copy the source files from the
          distribution diskette into a directory on your hard drive, for
          example LW22. Then, change to that directory and drive and type
          INSTALL.

          Example:

          C:\>mkdir LW22
          C:\>A:
          A:\>copy *.* C:\LW22
          A:\>C:
          C:\>cd LW22
          C:\LW22>INSTALL

          The installation program will assume you want to install LiveWire in
          the directory you have copied the files to. The installation program
          will remove any previous residual configuration files. Next, it will
          create a desktop folder for LiveWire which will contain the program,
          this manual, a registration object, and a host mode script.

          Once installation has been completed, you may start LiveWire by
          double-clicking on the LiveWire icon. If you have a registration
          number you may register this copy of LiveWire by double-clicking on
          the LiveWire key icon.

          If you have the ZIPed version of LiveWire available on bulletin
          boards and networks world-wide, follow similar instructions, except
          unzip the LiveWire ZIP file into the desired directory, then run
          install.

 Running LiveWire for the first time    4/1 

Running LiveWire for the first time

          The first time LiveWire is started it must be told a few things about
          the computer setup. The first thing LiveWire will want to know is
          which communications port the modem is on. If you do not know which
          port your modem is on you must refer to your modem or computer manual
          for this information. Move the highlight bar to the correct
          communications port using the right and left arrow keys, then press
          ENTER to make a selection.

          Next, LiveWire must know what type of modem is installed in the
          computer. A list of 80 different types of modems will be displayed.
          To choose one, use the up and down arrow keys to move through the
          list. Press ENTER on the modem installed. If the modem is not listed,
          choose "Other modem not listed." In this case, additional setup will
          be required. Refer to the modem manual for more information.

          LiveWire now needs to know the highest speed the modem will
          communicate at. The correct speed will already be highlighted if a
          pre-defined modem was selected. If "Other modem not listed" was
          selected the modem speed should be set according to the modem manual.
          Make the speed selection by moving the highlight bar to the correct
          speed and then press ENTER.

          LiveWire will now prompt for a default color scheme. To select the
          desired color scheme, use the arrow keys to move the highlight bar to
          the color scheme desired and press ENTER. Colors can later be
          customized.

          You will now be asked if you wish to emulate the keyset of several
          popular communications programs. If you are not familiar with any of
          these programs, just press ENTER. To emulate another program's
          keyset, use the right arrow key to move the highlight bar to the
          program of your choice and press ENTER.

          Lastly, you will be asked if you want to do some further
          configuration or if you want to load LiveWire at this point. To load
          LiveWire without any further configuration press ENTER, otherwise
          press the right arrow key once to move the highlight bar to Edit
          Configuration and then press ENTER.

 Configuration    5/1+

Configuration
Using pull-down menus

          LiveWire makes use of pull-down menus in it's configuration.
          Pull-down menus are designed for ease of use and brevity. Across the
          top of the screen are several categories of configuration.

          Using the right and left arrow keys on your keyboard you can move the
          highlight bar from one category to the next. Pressing the ENTER key
          or Down arrow key on one of these categories "pulls down" a menu
          pertaining to that category.

          Pressing ENTER while the highlight bar is on the Modem category
          causes a menu appears directly under the category. In this new menu
          are three options: "Port Configuration...", "Modem Commands...", and
          "Install new modem..." The "..." at the end of these options indicate
          they lead to additional nested menus.
          Pressing the up and down arrow keys moves the highlight bar
          vertically between the two options. Pressing ENTER on one of these
          options leads to another nested menu.

          Under "Modem Commands..." is the final menu in the menu nest. Listed
          in this menu are the several options for modem commands. Again, using
          the up and down arrow keys moves the highlight bar among the options.
          To change one of these options, move the highlight bar to the option
          and press ENTER. A cursor will appear at the beginning of the option
          which can be used to edit the field. When finished editing the field,
          press ENTER or ESC and the cursor will disappear.

          Pressing the ESC key while not editing a field causes configuration
          to back up one menu.

          If you get stuck or need a little instruction, there is one line of
          context-sensitive help available at the bottom of each screen called
          the status line. The status line contains status information and a
          list of available options.

 Modem    6/2+

Modem
          This menu contains three sub-menus used for configuring modem setup
          and port setup. 

          "Port Configuration" is a sub-menu that contains specific hardware
          information such as the communications port number and baud rate. 

          "Modem Commands" contains the modem's commands and responses such as
          the commands that initialize the modem, dial a number, and hang up.
          This menu also specifies the messages LiveWire will expect the modem
          to respond with when it gets connected to another computer or
          encounters a problem.

          "Install Modem" will install a different modem type from the list of
          modems presented during initial configuration.

 Port Configuration    7/3 

Port Configuration...
This selection leads you to a menu where you may change any of the options
below.
          Comm device
                    Selecting this option allows you to change the
                    communications port number your modem is using.  Refer to
                    your modem, computer, or communications port manual for
                    this information. It will not hurt to try numbers
                    successively from 1 until your modem dials successfully. If
                    you are using a named pipe for communication, this setting
                    must be set to PIPE, which appears after COM8:.
          Baud rate
                    Selecting this option allows you to edit the speed your
                    modem will operate at. This value can be anywhere from 110
                    to 57,600. More common values of the baud rate are 1200,
                    2400, 4800, and 9600, 19200, 14400, and 38400. Check your
                    modem manual for the appropriate modem speed setting.
          Data Bits
                    Selecting this option switches the data bits to 7 or 8. IBM
                    PC systems use 8 bits to communicate. Using a 7 bits is
                    required by older hardware and mainframes. If 8 bits are
                    used, the Parity setting must be None. If 7 bits are used,
                    the Parity setting can be None, Even, or Odd.
          Parity
                    Selecting this option switches the parity to None, Even, or
                    Odd. Parity is a form of error detection used by modems
                    that communicate using 7 data bits. Since only 7 of a
                    possible 8 data bits are used in a 7 bit communications
                    session, the extra bit is used for error detection. There
                    are three forms of this error protection LiveWire supports:
                    None, Even, or Odd. Unfortunately, once an error has been
                    detected, there is no way to correct it. Note that error
                    means garbled text  produced from static or other noise
                    caused by the phone lines.
          Stopbits
                    Selecting this option switches the number is stopbits to 1
                    or 2. Stopbits are extra bits at the end of each series of
                    8 bits that indicate the end of the series of bits. Most
                    computer systems use 1 stop bit, although some require 2. 
          Locked Port
                    Selecting this option turns the locked port option off or
                    on. If your modem has data compression you will want to
                    turn this option on as well as telling your modem that you
                    are using a locked port. Here is why: Most modems are
                    "smart."  When they connect to another computer theyreturn
                    a message to LiveWire indicating the speed at which they
                    connect. For example, a modem may return CONNECT 2400. When
                    the dialer receives this message, LiveWire normally resets
                    the communications parameters to communicate at 2400 bps.
                    While this is fine for modems without error compression,
                    modems with data compression are able to boost transmission
                    speeds well beyond 2400 bps.  For example, if your modem
                    compresses a 2400 bps transfer by a factor of 2 then your
                    actual transmission rate is twice that -- 4800 bps. Without
                    a locked port LiveWire limits the connection to 2400 bps
                    and no speed advantage is gained. Turning the Locked Port
                    option ON prevents LiveWire from interpreting the modem's
                    CONNECT 2400 message. Setting the Baud Rate option above to
                    4800 then allows greater throughput. You must also set an
                    option on your modem to lock the port (although this may be
                    the default). For information on how to do this, consult
                    your modem manual.
          Named Pipe
                    If you are attempting to connect to a named pipe server,
                    you must set this field to the name of the pipe to connect
                    to. All pipe names must begin with \PIPE\ and end in the
                    remote computer name and remote pipe name. To use a named
                    pipe the communications device must also be set to PIPE. 

 Modem Commands    8/3 

Modem Commands
          This selection leads you to a menu where you may change any of the
          options below.

 Modem Initialization
                    Selecting this option allows you to change the modem
                    initialization which is sent to the modem every time you
                    start LiveWire.

                    Here are some other options you can add to the end of the
                    string that work with most hayes-compatible modems:

                    E1        Set echo keystrokes on
                    Q0        Quiet mode off
                    M0        Modem speaker off
                    V1        Verbose responses (such as CONNECT, BUSY)
                    S7=60     Set dial timeout to 60
                    X3        1200 baud busy signal/no dial tone checking
                    X4        2400 baud busy signal/no dial tone checking
                    &C1       Return correct online/offline status

                    There are many more commands the modem understands. The
                    commands listed above are for 1200 and 2400 baud hayes
                    compatible modems. Most modems are hayes compatible, or at
                    least partially compatible. This manual cannot provide a
                    complete list of modem commands since they do vary from
                    modem to modem. If need be, review your modem's options in
                    your modem manual. If you have a high speed or data
                    compression modem make sure you read the manual to get the
                    most out of your modem. It should have a list and
                    description of all supported modem commands. 
          Modem Dial Prefix
                    Selecting this option allows you to change the dial command
                    prefix. This is the command is required to initiate dialing
                    of the phone. It is set to be ATDT by default, which means
                    "ATtention, Dial Tone." If you have a pulse dial (rotary)
                    phone, change this to ATDP, which stands for "ATtention,
                    Dial Pulse." 
          Modem Dial Postfix
                    Selecting this option allows you to change the dial command
                    postfix. Normally, this is just the ENTER key, which sends
                    the command. The ENTER key is ^M for Control-M.
          Modem Hangup Command
                    Selecting this option allows you to change the hangup
                    command. The hangup command for hayes compatible modems is
                    ^~^~^~+++~^~^~^ATH0^M, which translates to:

                    ^~^~^~    Pause for 1.5 seconds (each ^~ is .5 seconds)
                    +++       Puts the modem in command mode
                    ^~^~^~    Pause for 1.5 seconds
                    ATH0      Attention, hang up
                    ^M        ENTER key (to send modem command)

                    NOTE: Before sending the modem hangup string LiveWire
                    lowers the DTR signal. This will make many modems
                    immediately hang up the phone. If this causes the modem to
                    go off-hook, LiveWire does not send the hangup command.
          Connect message
                    Selecting this option allows you to tell LiveWire what your
                    modem responds with when it connects with another computer.
                    Hayes modems return CONNECT. Hayes smart modems will return
                    the speed of connection along with the CONNECT response.
                    (EG: CONNECT 2400). LiveWire is smart enough to understand
                    these responses. You can prevent LiveWire from interpreting
                    the bps rate following the connect message by turning the
                    locked port option on.
          Unable to connect #1,2,3,4
                    Selecting these options allows you to tell LiveWire what
                    messages your modem may return if it is unable to reach the
                    number you have dialed. 
          Modem error message
                    Selecting this option allows you to tell LiveWire what
                    error message the modem sends if something has gone wrong.
                    It is simply ERROR for Hayes compatible modems.

 Terminal    9/2 

Terminal
This menu contains configuration options related to terminal mode operation.

          Terminal Emulation
          Selecting emulation lets you change which terminal type LiveWire will
          emulate. The terminal type dictates how LiveWire will react to
          special control codes and how it will act under certain situations. 

          TTY
          Selecting this option will make LiveWire emulate TTY or TeleTYpe
          emulation. TTY emulation is a plain vanilla emulation. It does
          nothing special, simply displays what it receives.
          ANSI
          Selecting this option will make LiveWire emulate the ANSI emulation.
          LiveWire's ANSI is a subset of the ANSI specification. Most bulletin
          boards and online services use the ANSI emulation.
          OS2You
          OS2You is a special emulation designed to work only with OS2You
          remote software. OS2You software, written by Mikael Wahlgren of Ridax
          programming, is a shareware program that allows you to run OS/2
          programs remotely -- over the network, or over a modem. OS2You
          emulation is a modified ANSI emulation that has two special keys.
          Pressing ALT-- (alt-minus, hex keycode 8200) switches between local
          and remote keyboard. When local keyboard is on, LiveWire operates
          normally. When remote keyboard is on, all special keystrokes are sent
          to the remote program. This allows you to use function keys and
          ALTkeys remotely. In addition, pressing ALT-= (alt-equals, hex
          keycode 8300) causes the OS2You services menu to appear.
          0+ Avatar
          Selecting this option will make LiveWire emulate the Avatar 0+
          specification. This specification, used widely on bulletin boards,
          was created to increase the speed of ANSI text displays considerably.
          VT-102
          Selecting this option will make LiveWire emulate the DEC VT-102
          terminal. DEC VT-102 terminal emulation was coded from the DEC VT330
          programmer's manual and has been tested against several UNIX and VMS
          systems as well as the public domain VTTEST program.

          Setup emulation...
                    This option is only available if VT-102 is the current
                    emulation. Thefollowing are settings for the VT-102
                    emulation. The  default settings are those of a VT-102
                    terminal, so usually no  configuration is required here.
                    Backspace=DEL
                              If Backspace=DEL is on then the backspace key
                              always sends a DELETE character (0x7f) instead of
                              the normal Backspace (0x8) character. This
                              setting overrides the Off setting in the Defaults
                              configuration menu.
                    Destructive BS
                              If Destructive BS is true, then backspace erases
                              characters as it moves back one position. By
                              default in VT-102 emulation backspaces are NOT
                              destructive.
                    Keypad
                              Specifies current keypad mode. If the mode is
                              numeric, the keypad sends actual numbers as the
                              keys are pressed. If the mode is application,
                              special escape sequences are sent to the remote
                              computer.
                    Cursor Keys
                              Specifies the mode in which the cursor keys
                              operate, application or normal. Cursor keys
                              always send escape command sequences in VT-102.
                    PFKeys
                              Some programs which utilize VT-102 emulation
                              require that four function keys (called PFKeys)
                              be available. These keys can be mapped to one of
                              three different local sets of keys, or they may
                              be turned off. By default PFKeys are mapped to
                              F1-F4, but can also be mapped to Shift F1-F4, Alt
                              F1-F4, or CTRL F1-F4.
                    Scroll end of line
                              This option controls whether or not VT-102
                              automatically scrolls when its output reaches the
                              last column (the rightmost edge) on the screen.
                    Command pacing
                              This option controls the pacing, in milliseconds,
                              between each character when a VT-102 escape
                              sequence is sent from LiveWire to the remote
                              site. This happens when PF-keys are pressed or
                              arrow keys are used. The command pacing option is
                              set to zero by default, but some remote hosts
                              cannot handle escape sequences that are sent
                              quickly. In this case this value must be
                              increased.
                    Tab setup...
                              Tab locations can be changed with this option.
                              Pressing ENTER on this option will bring up a
                              window showing the current tabstops. A tab stop
                              is indicated by a "T". Tab stops can be toggled
                              of and on by going to the position desired and
                              pressing ENTER. In addition, pressing ALT-S will
                              restore the standard VT-102 tabs. Pressing ALT-C
                              will clear all tab stops. When you are done
                              editing tabs, press ESC to exit tab setup.
                    Answerback message
                              This string is the answerback message sent by
                              LiveWire in response to a ENQuiry character. By
                              default this message is "LiveWire 2.2."
                    Answerback
                              This setting indicates whether LiveWire should
                              respond to the ENQuiry and send the Answerback
                              message. By default this is yes.

          Echo Keystrokes
                    Selecting this option turns LiveWire's echo (display) of
                    keystrokes on or off. In terminal mode, if you press a key,
                    LiveWire normally does not display the key on the screen.
                    It relies on either the modem or the system you are calling
                    to do this. However, in some cases you may want LiveWire to
                    echo the keys back to you. In such a case you would turn
                    Echo Keystrokes to ON.
          Add linefeeds
                    Selecting this option makes LiveWire either add linefeeds
                    or not add line feeds to carriage returns. Normally, the
                    modem or the other system you call will automatically drop
                    down a line (linefeed) as well as carriage return (move the
                    cursor to the beginning of the line). However, some systems
                    only send carriage returns and expect LiveWire to add the
                    linefeeds. In this case, Add linefeeds should be on.
          Backspace is DEL
                    Turning on this option makes LiveWire send a DEL character
                    when the BackSpace key is pressed. Many dial-in services
                    use DEL as a backspace character. If your BackSpace key
                    does not work, try turning this option on.
          Status Line
                    Selecting this option turns the status line in the terminal
                    on or off. The last line of your screen in terminal mode is
                    normally used for status information. If the computer you
                    are calling requires use of the whole screen, you should
                    turn the status line off. 
          VGA 50 line mode
                    Selecting this option turns VGA 50 line mode on or off. If
                    you have aVGA monitor, your monitor is capable of
                    displaying 50 lines on your screen, as opposed to the
                    normal 25. In this mode the dialing directory will display
                    30 entries per screen rather than 10. 

          XON/XOFF flow control
                    Selecting this option turns the XON/XOFF flow control
                    protocol on or off. When XON/XOFF flow control is on, the
                    receiving computer can send a command called XOFF to your
                    computer that will stop transmission temporarily.  When the
                    receiving computer catches up, it sends an XON command,
                    which resumes transmissions. This is used when the computer
                    is receiving information too quickly to be processed. If
                    flow control is on and your computer receives the XOFF
                    command, your keyboard will not work until XON is received.
                    If you wish to override this, press the ESC key. 
          RTS/CTS flow control
                    Selecting this option turns the RTS/CTS flow control
                    protocol on or off. The RTS/CTS protocol serves the same
                    purpose as the XON/XOFF flow control but is more effective
                    and more widely used. Flow control is managed by the
                    hardware at the UART level instead of sending commands.
                    This option should remain on for most modems, especially if
                    you have a high speed modem. Without RTS/CTS flow control
                    you may loose large chunks of information while
                    communicating at high speeds.

          Ignore carrier signal
                    The carrier signal is a signal sent by the modem to the
                    computer informing the computer that the modem still has a
                    connection. If this signal is suddenly dropped, LiveWire
                    realizes that no connection exists any more and stops its
                    current operation. Turning this option on causes LiveWire
                    to ignore the state of the carrier signal when uploading
                    and downloading. This is useful if you have a direct
                    connection or your modem does not properly report carrier.

 Keys    10/2 

Keys
This menu allows the setup of keyboard shortcuts (macros) and incoming/outgoing
translation tables.

          Edit Macros...
                    LiveWire's macros can be changed by selecting this option.
                    LiveWire's macros control how the function keys operate.
                    For example, when you press ALT-D, a macro is executed
                    which makes the dialer screen appear. When you first select
                    this option LiveWire will ask you to enter the macro
                    filename. Press ENTER to retain the same macro filename.

          Macro char pacing
                    This option determines the time, in milliseconds, to delay
                    between sending each character in a macro. By default, this
                    is zero.

          Press the function keys you wish to define or command below:
                    Pressing any key or key combination here will allow you to
                    define the macro associated with that key combination. You
                    may define any key or key combination (except for normal
                    typing or numeric keys). To do this, simply press that key
                    or key combination. For example, Press F1. The macro for F1
                    will be displayed, and you may edit it if you like. When
                    you are done editing the macro, press ENTER. NOTE: In
                    VT-102 emulation PF keys and keypad keys cannot be
                    redefined.

          List macros
                    Pressing L from this menu will display a full list of all
                    definable keys and the macros associated with them. Using
                    the up and down arrow keys you can move the highlight bar
                    through the list of macros. Press ENTER to edit the
                    highlighted macro.

          Using Macros
                    Macros have many uses. Anything you put in the macros will
                    be sent to the modem when you press the key associated with
                    that macro. For example, if you define F1 to be "Hello, I
                    am using LiveWire Communications!" then when you press F1
                    it will be as if you typed "Hello, I am using LiveWire
                    Communications!"  To insert control characters into the
                    macro, use a caret followed by the control key letter. For
                    example, ^M. Some common control characters and what they
                    correspond to are:
                              ^M        Carriage Return (as if you have pressed
                                        ENTER)
                              ^G        Makes a beep tone sound on the remote
                                        computer
                              ^L        Formfeed, which effectively clears the
                                        screen
                              ^[        Escape character
                              ^         Placing a single caret at the end of a
                                        line serves as a place marker for
                                        trailing spaces. The ending caret will
                                        not be transmitted

                    There are also commands that can go in macros. Commands are
                    contained in curly braces -- { }. 

          The following macro commands are recognized by LiveWire:

          {BSISDEL}
                    Toggles the action of the backspace key between the
                    backspace  and
                    delete character
          {CAPTURE}
                    Toggles capture of information on and off
          {CGA25}
                    Switches to 25 line mode
          {CHANGE DIR}
                    Invokes the change directory (directory tree) function
          {CHANGE DRIVE}
                    Invokes the change drive function
          {CLRSCR}
                    Clears the screen
          {CONFIG}
                    Invokes the configuration menu
          {CONFIGEMU}
                    Invokes the emulation configuration menu
          {DIALER}
                    Invokes the dialer
          {DOORWAY}
                    Toggles the doorway mode on and off
          {DOS}
                    Invokes a OS/2 command shell
          {DOS:cmnd}
                    Invokes a OS/2 shell where cmnd is executed
          {DUMP SCREEN}
                    Dumps the screen to a file (like print-screen)
          {ECHO OFF}
                    Turns local keyboard echo off
          {ECHO}
                    Toggles local keyboard echo on or off
          {ECHO ON}
                    Turns local keyboard echo on
          {EGA43}
                    Switches to 43 line mode
          {EXIT}
                    Exits LiveWire (asks the user before exiting)
          {HANG-UP}
                    Sends the command to hang up the modem
          {HELPSCREEN}
                    Brings up the help/command screen
          {KEYCONFIG}
                    Invokes macro configuration
          {LEARN SCRIPT}
                    Turns script learning on or off
          {LINEFEEDS}
                    Toggles local linefeeds on or off
          {LINEFEEDS ON}
                    Turns linefeeds on
          {LINEFEEDS OFF}
                    Turns linefeeds off
          {LINES}
                    Toggles between CGA 25 line and EGA 43 line screen mode
          {LOG}
                    Toggles the log on and off
          {MACROCONFIG}
                    Invokes macro configuration
          {PASSWORD}
                    Sends your password (as listed in the dialer) to the remote
                    computer
          {PRINTER}
                    Toggles capture to printer on and off
          {PORTCONFIG}
                    Invokes the communications port configuration
          {RECEIVE FILES}
                    Invokes a download session

          {RUN SCRIPT <filename>}
                    Invokes a script. If no filename is specified it is
                    requested  from the user.
                    If a filename is specified the script is immediately
                    executed .
          {SCROLL-BACK}
                    Invokes scroll-back viewer
          {SCROLL-BAK}
                    Toggles scroll back on and off
          {SEND FILES}
                    Invokes an upload session
          {SEND ANSI}
                    Invokes the menu to send an ANSI color command to the remote
                    computer
          {SEND BREAK}
                    Sends a BREAK signal to the remote computer
          {STATUS}
                    Toggles the status line on and off
          {VIEW FILE}
                    Invokes the file editor
          {XFLOW OFF}
                    Turns Xon/Xoff flow control off
          {XFLOW}
                    Toggles Xon/Xoff flow control on or off
          {XFLOW ON}
                    Turns Xon/Xoff flow control on
          {XLATETABLES}
                    Invokes translate tables configuration

                    You may mix commands and text. For example, a macro can be
                    defined as:
                    Running Configuration{CONFIG}Done.

                    Any of these commands can be embedded in a macro. These
                    commands are dynamically linked with the command menu. If
                    you move the clear screen command ({CLRSCR}) from  ALT-C to
                    F1, the change will be reflected in the command screen
                    automatically.

 Input translate table...
                    Selecting this option will allow you to configure the
                    translation table. The input translate table controls all
                    information going and coming over themodem. Before it is
                    displayed on your screen, it is passed through the
                    translate table. For example, using the translate table you
                    can change all A's to Z's or change all Z's to A's. The
                    translate table lists numbers 0 through 255. Each number
                    corresponds with a letter or character. For example, the
                    number 65 corresponds with the letter A. Using this
                    information, you can modify the translate table so that
                    when the letter A is received it is changed to another
                    letter. Note that the input translate table has no effect
                    on special terminal emulation codes. 
                              Swap
                                        Pressing S, for swap, allows you to
                                        view numbers 129 to 255 of the
                                        translate table, since the screen can
                                        only display 128 values at a time.
                              Change
                                        Pressing C, for change, allows you to
                                        modify the translate table. You will be
                                        asked which number you want to change.
                                        For example, you would type in 65 and
                                        press ENTER for the letter A. It then
                                        asks you for the new value, any number
                                        from 0 to 255. 
                              View
                                        Pressing V, for view, allows you to
                                        view the letters and characters
                                        associated with the numbers. Pressing V
                                        again will return to the numeric mode.

 Output translate table...
                    Selecting this option will allow you to configure the
                    translation table. The output translate table controls all
                    information going over the modem. Before it is displayed on
                    your screen, it is passed through the translate table. For
                    example, using the translate table you can change all A's
                    to Z's or change all Z's to all A's. The translate table
                    lists numbers 0 through 255. Each number corresponds with a
                    letter or character. For example, the number 65 corresponds
                    with the letter A. Using this information, you can  modify
                    the translate table so that when the letter A is sent it is
                    changed to another letter before being sent over the modem.
                    See Input translate table for information on swap, change,
                    and view commands.

 Protocols    11/2 

Protocols
File transfer protocols may be configured using this menu.

          Zmodem-32 Batch
          Zmodem setup options can be configured by selecting this option.
          Auto-download
                    Toggles Zmodem auto-download on or off. When Zmodem
                    autodownload is on, Zmodem will automatically initiate a
                    download when a packet header is seen.
          32-bit CRC
                    Toggles Zmodem 32-bit CRC checking on or off. When Zmodem
                    32-bit CRC is off, Zmodem uses 16-bit CRC checking.
          Rename files if FAT
                    Toggles long filename renaming on FAT file systems on or
                    off. If this option is off and a file with a long
                    HPFS-style filename is downloaded to a FAT drive, the
                    download will fail. If this option is on, a file with a
                    long HPFS-style filename will be translated to the 8.3 FAT
                    standard. Note that this translation is only done if the
                    destination drive is FAT.
          Rename duplicate files
                    Toggles whether or not the file being received will be
                    renamed if the filename already exists. LiveWire will first
                    attempt to determine if the file transfer should be resumed
                    by checking the file size. If the file on the disk compared
                    to the file being received is smaller, LiveWire will
                    attempt a resume the file transfer. If the file transfer
                    cannot be resumed, the file is renamed.
          Rename format
                    This field specifies how incoming files will be renamed. By
                    default the file's extension is removed and replaced with a
                    unique number, starting with 1. If another format is
                    required, this field can be modified to match that format.
                    Any normal keys typed into this field at the keyboard will
                    be added to the file. In addition, there are embedded codes
                    which begin with a percent sign (%):

                    %f        Name of file being received, excluding extension
                    %e        Extension of file being received
                    %w        Whole name (name and extension) of file being
                              received
                    %n        A unique sequential number, assigned by LiveWire
                    %%        Translates into a single percent sign
                    Some examples of how this field might be used are:
                    %f.%n    
                              Translates filename "LW22.ZIP" into ("LW22.1" or
                              "LW22.2" or "LW22.3", etc.)

                    %w;%n
                              Translates filename "LW22.ZIP" into "LW22.ZIP;1"

                    Renamed file #%n %w
                              Translates filename "LW22.ZIP" into "Renamed file
                              #1 LW22.ZIP"

          Resume uploads
                    Toggles whether or not Zmodem sends a resume request at the
                    beginning of each upload. The receiver is responsible for
                    determining whether or not the file should be resumed, and
                    acts accordingly. NOTE: Leaving this option on will NOT
                    cause problems uploading non-resumed files.

          Resume downloads
                    Sets whether or not Zmodem attempts to resume a download.
                    If this option is set to "off," Zmodem will never attempt
                    to resume a download. If this option is set to "on," Zmodem
                    will always attempt to resume transfer an existing file if
                    the existing file is smaller than the file being received.
                    If this option is set to "ask," LiveWire will ask before
                    resuming any file. 

          Ascii
          Ascii setup options can be configured by selecting this option.
          Character pacing
                    Sets the delay between characters, in milliseconds.
          Line pacing
                    Sets the delay after a CR or LF, in milliseconds.
          Strip LF
                    Toggles linefeed stripping on or off.
          Strip CR
                    Toggles carriage return stripping on or off.
          CR -> CR/LF
                    Toggles carriage return conversion to carriage return
                    followed by linefeed on or off.
          LF -> CR/LF
                    Toggles linefeed conversion to carriage return followed by
                    linefeed on oroff.
          Expand blank lines
                    If this option is on, empty lines are expanded so as to
                    contain a single space. This is to avoid an empty line
                    condition, which stops some editors.

          Edit external protocols
          Selecting one of the protocols in the list will allow you to change
          the information for that protocol. To add a new protocol you must
          select the empty entry after the last protocol and provide the
          following information:
          Name
                    Selecting this option allows you to change the name of the
                    protocol. All protocols must be named.
          Hotkey
                    Selecting this option allows you to change the unique
                    hotkey associated with the protocol. The hotkey is the
                    character that may be pressed to automatically jump the
                    highlight bar to that protocol. The hotkey should be one of
                    the letters in the name of the protocol. This hotkey is
                    also used to specify the protocol in the dialing directory
                    and the script language.
          Prompt filename
                    Selecting this option changes whether LiveWire will prompt
                    the user for a filename before downloads. If the protocol
                    you are adding requires that LiveWire ask for the filename
                    before receiving (downloading) a file, this option should
                    be yes. Protocols such as Zmodem obtain the download
                    filename from the sending computer automatically.
                    Therefore, Zmodem does not require that the user enter a
                    filename when receiving a file.
          Receive command 1 and 2
                    Selecting this option will allow you to change the OS/2
                    commands required to run the protocol to receive a file.
                    Read the external protocol manual for information about
                    what command to use. Some protocols may require more than
                    one DOS command, so two lines are provided. Most external
                    protocols will require that you send the communications
                    port, modem speed, and filename. If you put %0 in the
                    command line, it will be replaced with the port number. %1
                    will be replaced with the modem speed. %2 will be replaced
                    with the filename or path. %3 is replaced with the file
                    handle of the currently opened device.

                    Example:
                    DSZ port %0 speed %1 rz %2
                    May expand to:
                    DSZ port 1 speed 2400 rz C:\TMPZIP

                    This replacement is done automatically by LiveWire, all you
                    need to do is put the percent commands in the correct
                    place.

          Send command 1 and 2
                    Selecting this option will allow you to change the OS/2
                    commands required to run the protocol to send a file. Read
                    the external protocol manual for information about what
                    command to use. Some protocols may require more than one
                    DOS command, so two lines are provided. Most external
                    protocols will require that you send the communications
                    port, modem speed, and filename. If you put %0 in the
                    command line, it will be replaced with the port number. %1
                    will be replaced with the modem speed. %2 will be replaced
                    with the filename or path.

                    Example:
                    DSZ port %0 speed %1 rz %2

                    May expand to:
                    DSZ port 1 speed 2400 sz C:\TMPZIP\READ.ME

                    This replacement is done automatically by LiveWire, all you
                    need to do is put the percent commands in the correct
                    place.

 Dialer    12/2 

Dialer

          Dialer on startup
                    Turning this option on causes LiveWire to automatically
                    enter the dialing directory when it starts up. By default
                    this option is off and LiveWire enters terminal mode. This
                    setting is turned off if a script is run from the command
                    line.
          Music on connect
                    Turning this option off stops LiveWire from making sound.

          Popup on connect
                    Turning this option on causes LiveWire's dialer to
                    interrupt your current program by switching momentarily to
                    full screen mode when a connection has been established. 

          Connect timeout
                    Selecting this option allows you to change the time
                    LiveWire will spend waiting to be connected to each
                    computer system you dial. By default the connect timeout is
                    set to 45 seconds. Most computers will establish connection
                    within 15 to 20 seconds.

          Redial wait
                    Selecting this option allows you to change how long
                    LiveWire will wait between phone dialing attempts. By
                    default it is set to five seconds. In other words, if
                    LiveWire gets a busy signal it will wait five seconds
                    before trying again.

          inter-character Pacing
                    Most modems and network setups require a minuscule pause
                    between characters sent to the modem. This option is the
                    number of milliseconds LiveWire should pause between each
                    character it sends to the modem. By default this option is
                    set to 5 milliseconds. 

 Scroll-back    13/2 

Scroll-back

          Scroll-back
                    Selecting this option turns the scroll-back buffer on or
                    off. By default scroll-back is on. This means that LiveWire
                    stores all text that scrolls off the screen for review. 
          scroll-back Quote
                    When quoting a portion of the text from your scroll back
                    buffer, sometimes a character or characters to precede each
                    line of quoted text. These characters indicate to the
                    reader that the text he is reading has been quoted from
                    another source. By default this option is a single caret
                    (>).

          quote character Pacing
                    This option sets the pacing (in milliseconds) between
                    characters when quoting text from scroll-back. Some systems
                    will require a pacing in order to keep up with the incoming
                    information. By default, this value is zero.

 Colors    14/2 

Colors
Under this configuration menu LiveWire's color scheme can be configured.

          Color schemes...
          This sub-menu contains four pre-defined color schemes to choose from
          Cool cyan
                    This option selects a cyan (light blue) color scheme.
          Moronic Monochrome
                    This option selects a monochrome (black and white) color
                    scheme.
          Big Blue
                    This option selects the traditional blue-on-grey color
                    scheme. Looks great in a corporate office.
          Neat-o Neon
                    This option selects a wild neon-like color scheme.

          To do change a specific color select one of the options below. A
          color selection box will appear. In the color selection box the up
          and down arrow keys change the background color and the right and
          left arrow keys to change the foreground color. A sample of the color
          you've selected will appear. Press ENTER to select the color.
          Terminal
                    Selecting this option allows you to change the color in the
                    terminal.
          Terminal Message
                    Selecting this option allows you to change the color of the
                    messages displayed while in the terminal.
          Menu text
                    Selecting this option allows you to change the color of the
                    normal menu text.
          Menu Secondary text
                    Selecting this option allows you to change the color of the
                    secondary text in the menus.
          Menu window Border
                    Selecting this option allows you to change the color of the
                    menu's border.
          Menu Highlights
                    Selecting this option allows you to change the color of the
                    background highlights (scroll bars, for example) in the
                    menus.
          Status liNe
                    Selecting this option allows you to change the color of the
                    status line at the bottom of the screen.

 Paths    15/2 

Paths
Under the file configuration menu you can set up file paths and names.

          Editor
                    This field specifies the editor that LiveWire uses to view
                    and edit files. By default LiveWire uses OS/2's system
                    editor, E.

          Script path
                    This field specifies the default directory where scripts
                    can be found.

          Upload path
                    This field specifies the default directory from which
                    uploads (files to be sent) can be found. Normally this
                    option is blank, allowing the user to enter a path at the
                    time of the upload. 

          Download path
                    This field specifies the default directory where downloads
                    are sent. Normally this option is blank, allowing the user
                    to enter the path on each download. Protocols that do not
                    prompt you for a download file name (such as Zmodem) will
                    automatically use the download directory specified in this
                    field. If this field is empty the default directory is
                    used.
          Usage Log
                    This field contains the path and filename of LiveWire's
                    usage log file. If this is left empty, LiveWire will ask
                    for a log file name when the usage log is turned on.
          Capture file
                    This field contains the default path and filename for the
                    capture file. 
          Scroll back save
                    This field contains the default path and filename for
                    scroll back save.
          Screen Dump
                    This field contains the default path and filename for a
                    screen dump. A screen dump is saving the contents of the
                    current screen to a file. This is like print screen to a
                    file.

 Exit    16/2 

Exit

Save Configuration
                    Select this option to save the changes in the
                    configuration.
 Exit without saving
                    Select this option to cancel the changes made to the
                    configuration. Changes made to the macros and transfer
                    protocols cannot be canceled and will be in effect even if
                    you select abort configuration.

 The Terminal Mode    17/1 

The Terminal Mode

The modem initialization string
          When LiveWire first starts up it sends the modem initialization
          string. The modem initialization string is a set of commands sent to
          the modem that set it up for use by LiveWire Communications. 

          Before sending the initialization string, however, LiveWire checks to
          see if the modem is connected to another computer. If so, LiveWire
          will tell you that you are online and will ask if you still want to
          send the initialization string. Some modems will initially report
          that they are connected with another computer, but after sending the
          first initialization will report the correct status. In some
          occasions, the Hayes Personal Modem for example, the modem ALWAYS
          reports that it is connected to another computer. In this case
          LiveWire will always ask if you want to send the initialization
          string. You should answer Yes.

          If your modem was not listed as one of the pre-defined modems in the
          LiveWire modem database you should consult your modem manual for the
          correct settings. Some of the most common problems that occur if the
          modem initialization string is wrong are:

          Modem says "ERROR" (although the modem may still work correctly)
          Modem does not respond to commands
          Modem does not echo back keystrokes
          Modem responds with numbers instead of commands like OK, CONNECT, and
          BUSY
          Modem always indicates that is online
          Modem connects at the wrong speed
          LiveWire's dialer cannot dial
          LiveWire's dialer cannot recognize busy or connect signals
          LiveWire's dialer never gets a busy signal, but will connect
          LiveWire's dialer won't automatically detect the other modem's speed

 Explanation of the status line
          The last line on the screen is reserved for status information and
          help. In the terminal mode the status line looks like:

          | LW | COM1  2400 N81 | Offline |  8:19:24P | L P C E X F R B | ANSI
          |

          COM1                The communications device (COM1-8 or PIPE)

          2400                The modem speed
          N                   Parity: None, Even, or Odd
          8                   The data bits: 7 or 8
          1                   The stop bits: 1 or 2
          Offline             Indicates if the modem is offline or online. If
                              the modem is online, this will show the time
                              spent online.
          8:19:24P            The current time
          L                   Indicates LiveWire is keeping a log
          P                   Indicates LiveWire is capturing to the printer
          C                   Indicates LiveWire is capturing to a file
          E                   Indicates LiveWire is echoing local keystrokes
          X                   Indicates that XON/XOFF flow control is on
          F                   Indicates that linefeeds are on
          R                   Indicates that RTS/CTS flow control is on
          ANSI                Indicates the current terminal emulation

          In all other modes, such as the dialer, the status line contains
          limited help and available commands. 

 Terminal mode: a direct link to your modem
          The terminal mode serves as a direct link to your modem. Anything you
          type in terminal mode is sent to the modem. The modem has two modes:
          command mode and data mode.

          Initially, the modem is in command mode. While in command mode it
          will accept what's called Hayes AT commands. AT is short for
          "ATtention." Typing AT and then pressing ENTER should make the modem
          respond by printing OK on the screen. Some other commands are ATH for
          hangup and ATA for answer phone. In this command mode the modem
          interprets anything you type as a command.

          When the modem connects to another computer it automatically changes
          into data mode. In data mode the modem ignores all commands and opens
          a link between your computer and the other computer. Anything you
          type will be sent to the other computer.
          Once in data mode, there is a way to switch out of it -- type three
          +'s with a 1/2 second delay between each +. At this point, the modem
          will switch out of data mode and allow you to give it commands. It's
          unlikely you'll need to do this, because if either computer hangs up
          the phone the modem will return to command mode automatically.

 The Command Screen    18/1+

The Command Screen
LiveWire[Home]
Procomm+[Alt-Z]
Qmodem[Home]
Telix[Alt-Z]
Boyan[Ctrl-Home]

Using the command screen
          When LiveWire first loads up it will display the following line:

          Press <key> for menu command screen

          Pressing the key shown will bring up the command screen. The command
          screen provides a list to the major commands supported by LiveWire
          and the key combination which activates it.

          The command screen is important because the key combination
          associated with each command can change according to the macros
          setup.

          While in the command screen, pressing any of the listed key
          combinations will activate that command. Pressing the Escape key will
          return you to the terminal mode. You may also select the command you
          want by moving the highlight bar with the arrow keys, and then
          pressing ENTER when the highlight bar is on the command desired.

 Dynamic command keys and changing keysets
          All of LiveWire's command keys are dynamic. That is, you can
          configure the macros such that any key combination can bring up a
          desired function. For your convenience, LiveWire includes keyset
          emulations for LiveWire, Procomm+, Qmodem, Telix, and Boyan. This
          will help you adapt to LiveWire when switching from another
          communications program. All of the commands mentioned in this manual
          will, in fine print, list the keys for all of these keysets which
          activate the command.

          Changing the keyset emulations after the initial configuration of
          LiveWire is accomplished by bringing up the command screen and
          pressing K for keyset. Then press L for the LiveWire keyset, P for
          the Procomm keyset, Q for the Qmodem keyset, T for the Telix keyset
          or B for the Boyan keyset.  NOTE: changing the keyset clears the
          macros. If you have defined some macros for your personal use they
          will be erased by this command. You can also change the keys which
          activate any of the commands on the command menu right from the
          command menu. To do this, move the highlight bar to the command
          youwish to change and press N to select a new key combination. Then,
          press the key combination you wish to associate with the highlighted
          command. As long as that key combination is not used for another
          command the change will take place immediately and permanently on the
          command screen and in the LiveWire configuration.

 Phone book    19/2 

Phone book
LiveWire [Alt-D]
Procomm+[Alt-D]
Qmodem [Alt-D]
Telix [Alt-D]
Boyan [Alt-D]

          The phone book allows you to keep phone numbers of bulletin boards
          and online services. Directly from the phone book you can dial simply
          by moving the highlight bar to the number and pressing ENTER. 

          The dialer is able to read and modify Qmodem 4.x and 5.0, Procomm+,
          Telix, and Boyan phone files. Of course, LiveWire has it's own
          proprietary dialing directory format too. LiveWire has two
          proprietary dialing directory formats, 2.0 style and 2.1 style.
          Version 2.1 style allows much longer phone numbers and names and
          includes a comments section. Version 2.0 style retains compatability
          with the old DOS version of LiveWire. Note that DOS versions of
          LiveWire can only read 2.0 style phone books. The dialer also has
          excellent editing and sorting functions. For more information see the
          section The Phone Book.

 Clear screen    20/2 

Clear screen
LiveWire[Alt-C]
Procomm+[Alt-C]
Qmodem[Alt-C]
Telix[Alt-C]
Boyan[Alt-Z]

          This command simply clears the terminal mode screen.

 Scroll back    21/2 

Scroll back
LiveWire[UP-Arrow]
Procomm+[Alt-F6]
Qmodem[UP-Arrow]
Telix[Alt-B]
Boyan[Up-Arrow]

          Using the scroll-back command you may review what has scrolled off
          your screen during your connection. You may then save all or parts of
          this scroll-back buffer. 

          To review scroll-back you can press the up and down arrow keys. Doing
          this moves the white highlight bar up and down the screen. When the
          highlight bar reaches the top or bottom of the screen the screen will
          scroll automatically to reveal more of the session. 

 Clearing the buffer
          You can clear the scroll-back buffer by pressing C when it is
          activated.

 Saving the buffer
          Pressing S will allow you to save the scroll-back. You will be asked
          for a filename to save the scroll-back to. If you wish to save only
          part of the scrollback you can block highlight the part you want to
          save before pressing S.

 Marking a block of text for saving
          To preform block highlighting, move the highlight bar to the first
          line you wish to highlight. Press B, for Begin Block. Now move the
          highlight bar to the last line you wish to highlight. Press E, for
          End Block. Both the beginning line, ending line, and all lines in
          between will be highlighted. To save this highlighted block, press S.

 Quoting text from the buffer
          You can also quote a highlighted block. Quoting means that the
          highlighted block is transmitted over the modem, as if you typed it
          in yourself. One example of where this feature can be used is if you
          are replying to a message. If you wish to include some of the
          original message in your reply for reference purposes you can
          highlight just the lines you want from the original message and then
          have LiveWire retype it for you. To preform a quote, highlight the
          block you wish to quote and then press Q, for Quote.

 Searching for text in the buffer
          LiveWire also allows you to search for strings within the
          scroll-back. This is extremely useful for finding the desired
          position in a very long scroll backsession. To start searching, press
          F for find and type in a string to search for. LiveWire will search
          backwards, from the current highlight bar position to the top of the
          scroll-back buffer. When LiveWire finds the string it will move the
          highlight bar to the line in which the string was found and stop
          searching. If you wish to search for another occurrence of the string
          press A, for search again.

 Exiting the buffer
          When you are finished looking through the scroll-back you may exit
          back to terminal mode by pressing ESC.

 Capture    22/2 

Capture
LiveWire[Alt-K]
Procomm+[Alt-R]
Qmodem[Ctrl-Home]
Telix[Alt-L]
Boyan[Alt-L]

          This command will capture the whole communications session to a file.
          The capture can be turned off by repeating this command again.

 Dump screen    23/2 

Dump screen
LiveWire[Alt-U]
Procomm+[Alt-G]
Qmodem[Alt-T]
Telix[Alt-I]
Boyan[Alt-S]

          This command allows you to save the current terminal mode screen to a
          disk file.

 ANSI color    24/2 

ANSI color
LiveWire[Alt-A]
Procomm+[Alt-N]
Qmodem[Alt-7]
Telix[Alt-N]
Boyan[Alt-O]

          This command sends the correct ANSI codes over the modem to change to
          any desired color. This may be useful in messages and while chatting.

 Hang-up    25/2 

Hang-up
LiveWire[Alt-H]
Procomm+[Alt-H]
Qmodem[Alt-H]
Telix[Alt-H]
Boyan[Alt-H]

          This command attempts to hang up the modem. It attempts two methods.
          First, it lowers the DTR (Data Terminal Ready) signal for a 1/4
          second and raises it. Most modems will take this as a signal to
          hangup. If the modem fails to hangup using this method LiveWire sends
          a the hangup string to the modem instructing it to hang up the phone.

 Exit    26/2 

Exit
LiveWire[Alt-X]
Procomm+[Alt-X]
Qmodem[Alt-X]
Telix[Alt-X]
Boyan[Alt-X]

          This command exits LiveWire Communications. Before exiting, LiveWire
          will ask you if you're sure you want to exit. Press Y (or ENTER) to
          exit or N to return to LiveWire.

 Configuration program    27/2 

Configuration
LiveWire[Alt-N]
Procomm+[Alt-S]
Qmodem[Alt-N]
Telix[Alt-O]
Boyan[Alt-C]

          This command allows you change the configuration for LiveWire. 
          Configuration is explained in the section Configuration.

 Port setup    28/2 

Port setup
LiveWire[Alt-P]
Procomm+[Alt-P]
Qmodem[Alt-P]
Telix[Alt-P]
Boyan[Alt-P]

          This command allows you to change the serial port configuration. This
          includes COM port, baud rate, data bits, stop bits, parity, network,
          and port setup. This is discussed in the section Configuration
          options and explanations.

 Macros    29/2 

Macros
LiveWire[Alt-M]
Procomm+[Alt-M]
Qmodem[Alt-J]
Telix[Alt-K]
Boyan[Alt-M]

          This command allows you to configure the keyboard macro definitions.
          This is discussed in the section Configuration options and
          explanations.

 X-late Tables    30/2 

X-late Tables
LiveWire[Alt-T]
Procomm+[Alt-W]
Qmodem[Alt-A]
Telix[Alt-W]
Boyan[Alt-T]

          This command allows you to change the translate tables LiveWire uses.
          This is discussed in the section Configuration options and
          explanations. 

 Config keys    31/2 

Config keys
LiveWire[Alt-Y]
Procomm+[Alt-F8]
Qmodem[Alt-6]
Telix[Alt-2]
Boyan[Alt-K]

          This command allows you to configure the keyboard macros or translate
          tables. This is discussed in the section Configuration options and
          explanations.

 Set Emulation    32/2 

Emulation
LiveWire[Alt-E]
Procomm+[Alt-U]
Qmodem[Alt-G]
Telix[Alt-T]
Boyan[Alt-A]

          Sets the terminal emulation LiveWire uses. Currently, LiveWire
          supports TTY, ANSI, OS2You, and VT-100. Most bulletin boards and
          online services require or recommend ANSI emulation. For more
          information, see Terminal Emulations.

 Run script    33/2 

Run script
LiveWire[Alt-I]
Procomm+[Alt-F5]
Qmodem[Alt-F]
Telix[Alt-G]
Boyan[Alt-R]

          This command starts a LiveWire script file.  You will be asked for
          the filename of the script (including extension). You will then be
          asked for script parameters. If you do not know what script
          parameters to provide, just press ENTER.

 Learn script    34/2 

Learn script
LiveWire[Alt-L]
Procomm+[Alt-F10]
Qmodem[Alt-Q]
Telix[Alt-Y]
Boyan[Alt-8]

          This function attempts to learn your keystrokes and records your
          keystrokes in a script file for later playback. This feature is
          useful for automating redundant tasks such as typing your name and
          password to login to a system. For more information about script
          learning see Using Script Learn.

 Send files    35/2 

Send files
LiveWire[PgUp]
Procomm+[PgUp]
Qmodem[PgUp]
Telix[Alt-S]
Boyan[PgUp]

          This command lets you send files over the modem using any of the
          listed protocols. A discussion of how to send and receive files is
          found in the section Transferring files.

 Receive files    36/2 

Receive files
LiveWire[PgDn]
Procomm+[PgDn]
Qmodem[PgDn]
Telix[Alt-R]
Boyan[PgDn]
          This command lets you receive files over the modem using any of the
          listed protocols. A discussion of how to send and receive files is
          found in the section Transferring files.

 OS/2 shell    37/2 

OS/2 shell
LiveWire[Alt-S]
Procomm+[Alt-F4]
Qmodem[Alt-R]
Telix[Alt-J]
Boyan[Alt-J]

          This command temporarily shells you to an OS/2 command prompt. To
          return to LiveWire simply type EXIT and then press Enter at the DOS
          prompt.

 Change drive    38/2 

Change drive
LiveWire[Alt-G]
Procomm+[Alt-F9]
Qmodem[Alt-L]
Telix[Alt-3]
Boyan[Alt-7]

          This command allows you to change the logged drive. Simply move the
          highlight bar to the drive you want and press ENTER. You may also
          type the letter of the drive to change to, A through Z.

 Change dir    39/2 

Change dir
LiveWire[Alt-O]
Procomm+[Alt-F7]
Qmodem[Alt-O]
Telix[Alt-4]
Boyan[Alt-N]

          This command allows you to change the default directory by choosing
          it from the file navigator. The first time this command is run
          LiveWire will scan the disk to make the directory structure. This may
          take some time. 

 Directory    40/2 

Directory
LiveWire[Alt-R]
Procomm+[Alt-F]
Qmodem[Alt-W]
Telix[Alt-1]
Boyan[Alt-0]

          This command displays a listing of the files in the current directory
          by the OS/2 DIR /P command.

 View file    41/2 

View file
LiveWire[Alt-V]
Procomm+[Alt-V]
Qmodem[Alt-V]
Telix[Alt-A]
Boyan[Alt-V]

          This command invokes the external editor to edit a file of your
          choice. By default the OS/2 system editor E is invoked on the file.

 Send BREAK    42/2 

Send BREAK (NOT listed in command menu)
LiveWire[Alt-B]
Procomm+[Alt-B]
Qmodem[Ctrl-End]
Telix[Ctrl-End]
Boyan[Ctrl-End]

          This command will send a 1.5 second break signal to the remote
          computer. 

 Log    43/2 

Log
LiveWire[Alt-1]
Procomm+[Alt-F1]
Qmodem[Alt-0]
Telix[Alt-U]
Boyan[Alt-U]

          This turns the usage log on and off. LiveWire logs such things as
          time of connection to another computer, files transferred, functions
          executed, time online, when carrier was dropped, and when LiveWire
          was started and exited.

 Printer    44/2 

Printer
LiveWire[Alt-2]
Procomm+[Alt-L]
Qmodem[Alt-9]
Telix[Ctrl-@]
Boyan[Ctrl-PrtSc]

          This command turns the printer on or off. If on, anything appearing
          in the terminal mode is sent to the printer. It is like the capture
          command which saves the session, except to the printer.

 Echo    45/2 

Echo
LiveWire[Alt-3]
Procomm+[Alt-E]
Qmodem[Alt-E]
Telix[Alt-E]
Boyan[Alt-E]

          This command turns echo on or off. If echo is on, LiveWire displays
          every key that you type in the terminal mode on the screen as you
          type it. This is not always desirable because normally the modem and
          other computers do that for you automatically. If you see doubled
          characters on your screen you should turn echo off.

 Scroll-back    46/2 

Scroll-back
LiveWire[Alt-4]
Procomm+[Alt-1]
Qmodem[Alt-U]
Telix[Alt-5]
Boyan[Alt-2]

          This command turns the scroll-back on or off. Scroll-back is designed
          to use as little memory as possible, but if you plan to run LiveWire
          for a long time without exiting it is best to turn Scroll-back off to
          conserve memory.

 Xon/Xoff    47/2 

Xon/Xoff
LiveWire[Alt-5]
Procomm+[Alt-2]
Qmodem[Alt-Z]
Telix[Alt-6]
Boyan[Alt-3]

          This command turns XON/XOFF flow control on or off. If flow control
          is on, the computer you are talking to will be able to temporarily
          pause your transmission in order to catch up. This is rarely used,
          but can be useful. It can be a nuisance, too. Sometimes line noise or
          static upon hanging up will cause a burst of characters, one of which
          will be the code to stop transmission. This will lock your keyboard
          until you press ESC to override the command.

 Doorway    48/2 

Doorway
LiveWire[Alt-6]
Procomm+[Alt-3]
Qmodem[Alt-=]
Telix[Alt-=]
Boyan[Alt-4]

          This command turns the special doorway mode on or off. While in
          doorway mode, you will be able to send function and arrow keys over
          the modem. Normally, only printing characters (letters, numbers, and
          symbols) can be sent over the modem. Using the special doorway mode
          all other keys will be sent over the modem. The use of this mode
          requires that the other computer be able to recognize the codes for
          the function keys. Some message editors and remote DOS shells
          recognize the keys. The program that initiated this standard is
          DOORWAY. The shareware DOORWAY program, by Marshall Dudley, allows
          any text based program to be run on one computer and appear on
          another via a modem.

 Status Line    49/2 

Status Line
LiveWire[Alt-7]
Procomm+[Alt-4]
Qmodem[Alt--]
Telix[Alt-7]
Boyan[Alt-5]

          This command turns the terminal mode status line on or off. In some
          cases where the whole screen is needed, the status line, which takes
          resides on the last screen line, may not be desirable. 

 Linefeeds    50/2 

Linefeeds
LiveWire[Alt-8]
Procomm+[Alt-F3]
Qmodem[Shift-Tab]
Telix[Shift-Tab]
Boyan[Shift-Tab]

          This command turns linefeeds on or off. If linefeeds are on, LiveWire
          adds a linefeed to every carriage return. IE: It'll automatically
          drop down a line when the cursor moves to the beginning of the line.

 50 lines    51/2 

50 lines
LiveWire[Alt-9]
Procomm+[Alt-6]
Qmodem[Alt-4]
Telix[Alt-9]
Boyan[Alt-G]

          This command toggles between 25 lines per screen and 50 lines per
          screen mode. 

 Backspace=DEL    52/2 

Backspace=DEL
LiveWire[Alt-0]
Procomm+[Alt-0]
Qmodem[Alt-1]
Telix[Alt-0]
Boyan[Alt-9]

          This toggles the BackSpace key between sending a BS (backspace)
          character and sending a DEL character. For most BBSs a backspace (the
          default) is required. Some systems (UNIX or VMS, in particular) may
          require a DEL character, though. If your backspace key appears not to
          work, use this command to toggle your backspace setting.

 The Phone Book    53/1+

The Phone Book
LiveWire [Alt-D]
Procomm+[Alt-D]
Qmodem [Alt-D]
Telix [Alt-D]
Boyan [Alt-D]

The jobs the phone book performs
          The dialer keeps a list of up to 200 phone numbers of other
          computers. The dialer keeps records such as computer name, number,
          last called, and number of times called. The dialer also preforms
          useful functions such as dialing the modem and establishing a
          connection to one of the services in the phone book. You can have the
          phone book redial a number or several selected numbers until it
          connects with another computer. Upon connection to another computer
          the dialer will return to terminal mode so you can communicate with
          the other computer.

 Entering a phone number    54/2 

Entering a phone number

          The basic thing you'll need to know to use the dialer is how to enter
          a new phone number into the list. You can do this by using the edit
          command in the dialer. 

          First, bring up the dialer by pressing the key combination Alt-D from
          the terminal mode. Now, using the up and down arrow keys, move the
          highlight bar to a blank entry in the phone book. Now press the "E"
          key, for Edit. 

          A window appears displaying information for the entry you've
          selected. The highlight bar appears at the top of the window over the
          "Name" field. Press ENTER to edit the name of the computer system to
          be added. Type in the name and press ENTER. Now press the down arrow
          key once, moving the highlight bar to the "Number" field. Press ENTER
          to edit the phone number. Type in the phone number and then press
          ENTER when you're finished.

          When entering the phone number the following keys have special
          meanings:

          ,         A comma will pause the phone for 1/2 a second. This is
                    useful when the modem must wait for before continuing to
                    dial, as some long distance phone companies and foreign
                    calls require.

          A - J     The letters A through J are called dial codes. Putting a
                    dial code in the phone number will cause LiveWire to expand
                    that dial code into a code you specify. For example, if you
                    type in as a phone number: A555-3218 LiveWire will look up
                    the dial code A. If it is defined by you, it will be
                    replaced. For example, in this instance if A is defined as
                    "9,," then the number would expand to 9,,555-3218. As you
                    might imagine, this could be useful when you switch between
                    a phone line that requires that you dial 9 before dialing
                    and one that does not. The dial codes can be defined
                    through the edit (D)ialing codes command, "D" from the
                    dialing menu.

          When you are finished entering this information you might also want
          to edit other information such as speed, parity, bits, stop bits,
          script, password, last call, total calls, protocol, emulation, and
          echo. 

 Loading another programs dialing directory    55/2 

Loading another programs dialing directory

          LiveWire provides a unique feature in that it allows you to directly
          load several other dialing directory formats. LiveWire supports
          LiveWire, Qmodem 4.x and 5.0, Telix, Boyan, Procomm 3.4.2, and
          Procomm+ phone directory types.

          To load one of these phone files, first enter the dialing directory
          (press Alt-D from the terminal mode). Now press the "L" key to Load a
          new phone directory. When you are prompted, type the path and name
          for the dialing directory you wish to load, then press ENTER.

          Loading a Telix directory requires one extra step. Since Telix phone
          files are of variable length, they must be converted to LiveWire
          format before it can be used. So, when you try to load a Telix phone
          directory LiveWire will prompt you to enter a name for the converted
          Telix file. Another problem with Telix phone files is that they are
          cut off after 200 entries. This is due to the fact that the LiveWire
          phone directory format does not support more than 200 entries.

          For all phone directories except Telix, the file is not automatically
          converted to LiveWire format. If you wish to convert the phone
          directory to LiveWire format (although it is not necessary), press
          the "N" to coNvert to LiveWire format. You will be asked for a name
          to convert the phone file to. 

 Dialing out    56/2 

Dialing out

          Once you have your phone directory set up, you can dial another
          computer. Dialing on LiveWire is very easy. Use the up and down arrow
          keys to position the highlight bar over the entry you wish to dial
          and press ENTER. LiveWire will automatically start dialing the
          selected number. If LiveWire is unable to connect for any reason, it
          will wait for a few seconds and redial automatically. This re-dialing
          process will repeat until either you press ESC and cancel the dialing
          or you establish connection with the other computer. Pressing ESC
          simply stops the dialing and returns you to the dialing directory. If
          the modem connects with another computer, the dialer will make a high
          pitched ring and display the message "Connect. Press any key..." Upon
          your pressing a key, LiveWire will return you to the terminal mode
          where you can talk directly with the remote computer.

 Marking entries to dial multiple phone numbers    57/2 

Marking entries to dial multiple phone numbers

          LiveWire can also dial any number of entries you choose until it
          connects with one of the computers. This is done by marking the
          entries you wish to dial. Marking is also very simple. Position the
          highlight bar on the entry you wish to mark for dialing. Press the
          space bar. A check mark will appear next to the entry, indicating the
          entry has been marked. Note that the highlight bar automatically
          moves down to the next entry. Repeat this process until all of the
          entries you want to dial have been marked. Now, position the
          highlight bar on the entry you want to dial first, and press ENTER.
          The dialing will begin. The dialing will cycle through the marked
          entries until a connection is established.

 Dialing commands    58/2 

Dialing commands

dial entry [ENTER]
          The Start Dial command will start re-dialing either the entry the
          highlight bar is on or, if there are marked entries, the marked
          entries will be dialed. The dialer will continue re-dialing until it
          connects with another computer. To stop dialing, press ESC.

 edit entry [E]
          The Edit entry command will allow you to edit the entry the highlight
          bar is on or the entries that are marked. When you edit an entry, a
          window will appear containing the current entry's information. The
          following information can be edited by moving the highlight bar to
          that option and pressing enter. 

          Name                The name of the BBS or service associated with
                              this entry.
          Number              The phone number of there BBS or service for this
                              entry.
          Speed               Speed to set the modem before dialing. This is
                              initially set to the highest baud rate available
                              for your modem.
          Parity              Parity to be used for the computer being called.
                              N=No Parity, O=Odd Parity, E=Even Parity.
          Bits                Number of data bits to be used when communicating
                              to the computer being called. This may be either
                              7 or 8.
          Stop (bits)         The number of stop bits to be used when
                              communicating to the computer being called. This
                              may be either 1 or 2.
          Duplex              This option is the same as the echo on/off
                              toggle. If duplex is FULL, echo is off. If duplex
                              is HALF, echo is on.
          Script              This field contains the name of the script file
                              associated with this entry. When LiveWire
                              connects to a service it checks if the script
                              field is filled in. If specified this script file
                              is started as soon as a connection has been
                              established. NOTE: If a script file is specified
                              that does not exist, LiveWire assumes it is
                              supposed to start script learning and create a
                              script file for automated logon. For more
                              information about this feature read Using Script
                              Learning.
          Password            You may put your password here for reference. In
                              addition this field corresponds to the macro
                              {PASSWORD} and can be accessed by LiveWire REXX
                              scripts.
          Protocol            If you wish to have a default protocol for this
                              service press ENTER while the highlight bar is on
                              this option. A pop-up menu will appear listing
                              all of the possible protocols. Movethe highlight
                              bar to the default protocol for this entry and
                              press ENTER. 
          Emulation           If you wish to have a default terminal emulation
                              for this service press ENTER while the highlight
                              bar is on this option. A pop-up menu will appear
                              listing the terminal emulations LiveWire
                              supports. Move the highlight bar to the default
                              emulation for this entry and then press ENTER.
          Info file           Specifies the name of the file used for
                              additional information. If you wish to create
                              additional information (such as comments or
                              script information) with this dialing directory
                              you may link a dialer entry with a filename. 
          Last call           LiveWire keeps the date of your last call to this
                              system. You may manually edit this field.
          Total calls         Total number of times you've called and
                              successfully been connected to this service.

 mark [SPACEBAR]
          This command will mark or unmark the entry with the highlight bar on
          it. If the entry is not marked, it will become marked. If the entry
          is marked, it will be unmarked. Marking entries allows you to do mass
          dialing, deleting, and editing.

          Note that the mark/unmark command moves the highlight bar to the next
          entry automatically. This is to provide "power marking." In other
          words, holding down the spacebar will continue highlighting
          consecutive entries as long as the spacebar is held down.

 multiple mark [M]
          Multiple mark is a very useful and versatile command. It allows you
          to mark entries by name, part of a name, or entry number. For
          example, if you press M a window will appear asking for what to
          search for. Typing in 1,5,7 will mark entries 1, 5, and 7. Here are
          some more examples:

          1,10,50,3           Marks entries 1, 10, 50, and 3
          1,5..20             Marks entries 1, and all entries 5 through 20
          1..20,25..200       Marks entries 1 through 20 and entries 25 through
                              200
          DataMirage          Marks all entries that contain "DataMirage"
          Data                Marks all entries containing "Data." Note that
                              this will match entries such as: "DataMirage,"
                              "The DATA Line," and "Dumb Data." There is no
                              differentiation between caps and lowercase.
          1,Data,5..20        Marks entry 1, all entries containing "Data," and
                              entries 5 through20.

 unmark all [U]
          This command quickly unmarks all entries. 

 delete entry [DEL]
          This command does just what it says -- deletes the highlighted or
          marked entries. This command will confirm deletion before it deletes
          the entry. After each entry is deleted, LiveWire will ask if you want
          to remove the blank entry and move the rest of the dialing directory
          up to fill the blank spot. 
 insert entry [INS]
          Pressing INS inserts a blank entry wherever the highlight bar may be.
          Note that the new entry is created using the current configuration
          information (ie: the modem speed, parity, bits, stopbits, duplex, and
          the default protocol).

 sort entries [S]
          This command will sort your phone book A through Z, Z through A, or
          by total calls. All empty entries will be moved to the end of the
          list.

 eXchange entries [X]
          Exchange entries is a simple command that exchanges positions of two
          entries in the phone book. Simply mark two entries (no more, no less)
          and then press X. The position of the entries will be swapped.

 compRess directory [R]
          This command removes all blank entries from the dialing directory and
          compresses all entries so that they are contiguous. This command will
          not rearrange your phone book, it just moves entries up into spots
          where blank entries used to be. 

 xFer entry info [F]
          This feature facilitates the exchange of phone numbers. This command
          sends basic information over the modem about the entry the highlight
          bar is on. This is useful when you want to tell someone the phone
          number of a BBS you like but do not want to type them the name or
          number. Simply go into your dialer, move the highlight bar to the
          entry you want to send them information about and press F. They will
          see on their end: 
          :::>DataMirage BBS  <#>(408) 578-5850  
          (2400-N-8-1)        NOTE: If your friend is using LiveWire
                              Communications also and he does not have this
                              number in his dialing directory LiveWire will
                              automatically ask him if he wants to add this
                              number to his dialing directory!

 Print entries [P]
          This command will print your phone book to your printer. Upon
          pressing P, LiveWire will verify that your printer is on PRN (LPT1:).
          If you printer is on another printer port, communications port, or
          you want to print to a file, simply type in the destination of phone
          book list. For example, LPT2: for printer port 2, COM1: for com port
          1, COM2: for com port 2, or FONBOOK.TXT to send the listing to a file
          called FONBOOK.TXT.

 Load other book [L]
          The load other phone book command will allow you to load or start
          another phone book. LiveWire can read LiveWire, Procomm, Procomm+,
          Qmodem 4.x and 5.0, Telix and Boyan phone directories. To load one of
          these phone books, just enter the path and name of the phone book. To
          start a new phone book, type in a new filename and a clean phone book
          will be made for you.

 coNvert to LW format [N]
          This command converts Boyan, Procomm, Procomm+, Qmodem 4.x/5.0, and
          LiveWire 2.0 phone directories to current LiveWire phone file format.
          First load the phone book you wish to convert. Then, press N and type
          in a new name to save the converted phone book as.

 undo last actions [!]
          This command accomplishes an undo of all of your previous commands up
          until the last time the dialing directory was saved to the disk. The
          dialing directory is saved automatically by LiveWire upon exiting the
          dialer or loading a new phone file. The undo command accomplishes its
          work by simply reloading the dialing directory without saving the
          current changes. 

 View script [V]
          This command brings up the editor on the file specified in the script
          field for the highlighted entry.

 edit Dial codes [D]
          This command allows you to edit the dialing codes A through J.
          Pressing C brings up a window with the letters A through J listed
          with an entry field beside each. If you put "9," in the dialing code
          A, whenever the letter A appears in thenumber LiveWire is dialing
          (eg. A578-5850) the A will be replaced with "9,".  In this way it is
          easy to define and change prefixes or postfixes on numbers. Defined
          dialing codes are listed at the top of the dialing directory. To exit
          the edit dialing codes window, press ESC.

 edit Comment file [C]
          This command brings up the editor on the file specified in the Info
          file field for the highlighted entry.

 Transferring Files    59/1 

Transferring Files

          The transfer of files over a modem is called uploading and
          downloading. Uploading is the action of sending a file. Downloading
          is the action of receiving a file. 

          Conventional phone lines and most data links are error prone. Static,
          echos, and unclean lines cause "garbage" to be transmitted. In order
          to transfer files, these errors must be corrected or your programs
          and data will be unusable.

          In order to catch these errors files are transferred with an error
          detection and correction scheme called a file transfer protocol. Both
          the remote and local sides must agree upon the protocol. Some common
          protocols are Zmodem, Ymodem, and Xmodem. Zmodem is by far the most
          efficient and robust protocol of these three. Zmodem and Ymodem allow
          you to send and receive multiple files at a time. A transmission of
          multiple files is called a "batch" file transfer.

          Sample upload session

          This section describes uploading a file to a remote system. Here we
          assume that the remote system is capable of initiating the transfer
          on its side.

          First, locate the file on your disk that you want to send. The
          filename to send might be C:\LW22\LW22.EXE. 

          Next, tell your remote that you wish to send a file. Usually this is
          done by telling it you want to upload. Then, tell the remote which
          protocol you want to use. The most preferable protocol is Zmodem. For
          more information, consult the manual or help system for your remote
          host.

          When the remote end tells you to begin uploading, press the PageUp
          (for UPload) key on your keyboard. A list of protocols will appear
          for your to choose from. Choose the protocol that matches the one you
          selected for your remote.

          Once a protocol has been established, you will be prompted for the
          files you wish to send. If the protocol is Xmodem, Xmodem CRC, or
          Xmodem-1K youcan only send one file. If the protocol is Zmodem or
          Ymodem you may enter as many files as you wish. Optionally, you may
          use the file navigator to pick files to send from a list. Refer to
          the section File Navigator for more information. When you are
          finished entering files you can begin the transfer by pressing ENTER.

          During the file transfer a small window should appear in the lower
          right hand corner of your screen showing you statistics about the
          file transfer. To abort the file transfer, press ESC at any time.
          When the file transfer is completed the window will disappear and a
          bell will sound.

          Sample download session
          This section describes downloading a file from a remote system. Here
          we assume that the remote system is capable of initiating the
          transfer on its side.

          First, find the filenames or filenames you want on the remote side.

          Next, tell the remote that you wish to receive some files. Usually
          this is done by telling it you want to download. Then, tell the
          remote which protocol you want to use. The most preferable protocol
          is Zmodem. For more information, consult the manual or help system
          for your remote host.

          The remote end will ask you which files you want to download. Type in
          the filenames you wish to receive and tell the remote to begin the
          transfer.

          At this point, if you are using Zmodem the downloading will
          automatically begin. If you are downloading using Ymodem or Xmodem
          some extra work is required.

          The Ymodem protocol will not start up automatically, so you must
          press the Page Down key (for Download) and select the Ymodem
          protocol. At this point the download will begin.

          The Xmodem protocol (including CRC and 1k) will only receive one file
          at a time and does not start automatically either. To begin
          downloading you must press the PageDown key (for Download) and select
          the Xmodem protocol. You will then be prompted for a filename to
          download to. Type in one filename, and press ENTER. At this point the
          download will begin.

          During the file transfer a small window should appear in the lower
          right handcorner of your screen showing you statistics about the file
          transfer. To abort the file transfer, press ESC at any time. When the
          file transfer is completed the window will disappear and a bell will
          sound.

 File Navigator    60/1 

File Navigator

          Navigator features
          LiveWire 2.2 contains a new feature called the File Navigator. The
          File Navigator is a file and directory selection window with a
          multi-threaded interface capable of handling long file and directory
          names. File Navigator can be used to select files to upload, find a
          file from a file spec window, or change directories. 

          Initiating the navigator
          The navigator may be used in three different areas in LiveWire. 

          1. During batch uploads the batch send window will prompt for a
          filename. Pressing F3 in this window brings up the file navigator. 

          2. Any file specification window (IE: Load phone book, run script,
          view file, save scroll-back, capture file, etc) is capable of
          invoking the file navigator. Pressing F3 or ALT-N in a file
          specification window brings up the file navigator.

          3. The "Change dir" command brings up the file navigator
          automatically for directory selection.

          When the navigator is initiated it contains two main windows. The
          window on the right contains the files for the current directory. The
          longer window on the left contains a directory tree structure. When
          the navigator is first started files are displayed for the current
          directory while the directory tree structure is being built in the
          background. While the directory tree is being built, the files window
          may be used to select files and move between directories.

          Navigating the files window
          The file window contains at most two columns of files. If more files
          exist, an arrow will appear at the lower right hand corner of the
          files window.

          Using the Arrow, PgUp, PgDn, and Home keys the highlight bar may be
          moved over any file in the list. The highlight bar will also jump
          directly to a specified file by pressing the first letter of the
          filename on the keyboard. For example, pressing L might bring the
          highlight bar to the file LW22.ZIP.

          Once the highlight bar is over a file it may be selected by pressing
          ENTER.When multiple files can be selected, pressing the spacebar puts
          a mark next to the currently highlighted file. Marking several files
          in this way, then pressing ENTER causes all of the files to be
          selected.

          Directories in the file window are denoted by <DIR> after the
          directory name. Pressing ENTER while the highlight bar is over a
          directory causes the navigator to enter that directory. The special
          directory called ".." is available in all directory listings.
          Pressing ENTER while over ".." causes the navigator to leave the
          current directory and go back to its parent.

          Pressing the Tab key will change windows to the directory tree
          window.

          Navigating the directory tree window
          The window on the left is a tree-like blow-out of the directories on
          the hard drive. If the tree is wider than the window, only partial
          directory names will be visible. A scroll-bar on the right indicates
          the position of the highlight bar in relation to the entire directory
          tree structure.

          The directory tree may be traversed by pressing the Arrow, PgUp,
          Pgdn, Home and End keys to move the highlight bar. If the highlight
          bar is at the top or bottom of the window, the directory tree will
          scroll to bring more directories into view. As the highlight bar
          moves through the directory tree files for each directory to appear
          in the files window on the right.

          To change to another drive, press D. A list of valid drives will
          appear. Press the letter of the drive to change to.

          If a directory needs to be selected (as opposed to a file), pressing
          ENTER will select the highlighted directory.

          Pressing the Tab key will change windows to the files window.

          Exiting the file navigator
          Once the desired file(s) or directory has been located, pressing
          ENTER selects those directories and exits the file navigator. To exit
          the navigator without selecting a file or directory, press ESC.

 File Transfer Monitor    61/1 

File Transfer Monitor

          Included in the LiveWire 2.2 package is a Presentation Manager File
          Transfer Monitor. The file transfer monitor was designed so that
          background file transfers could be easily monitored while using the
          applications in the Work Place Shell.

          To start the file transfer monitor, double click on its icon before
          beginning the file transfer. You may also choose to keep the file
          transfer monitor running all the time as a minimized window. When
          minimized, the file transfer window changes its title to show the
          percent transferred of the current file.

          The file transfer monitor takes up very little memory and almost no
          CPU. It may be minimized or displayed even when LiveWire is not
          active.

          When a LiveWire session detects the presence of the file transfer
          monitor it connects through a named pipe. The named pipe remains
          connected until LiveWire exits or the file transfer monitor is
          closed.

          Please note that the file transfer monitor is a simple utility for
          the text-based version of LiveWire. It by no means attempts to make
          LiveWire a PM application, and is in no way related to the PM version
          of LiveWire currently being developed.

 Named Pipes    62/1 

Named Pipes

          Named pipes are a communications facility provided by OS/2. Named
          pipes connect two different programs through a data pipe in the
          computer. The data pipe can be thought of as a real-world pipe with
          two people standing on either end. If one person speaks down the
          pipe, the other person hears what the other has to say, and
          vice-versa.

          One use for named pipes can be used to connect your local computer to
          a single modem in a modem pool (collection of many modems). This is
          useful if there are a lot of employees and only a few modems.
          Employees can use a modem through named pipe, effectively sharing
          them with everyone in the company.

          Named pipes are also used for running programs remotely. OS2You by
          Mikael Wahlgren of Ridax programming allows you to run and control a
          program on a distant computer. The program can be run over a named
          pipe.

          To set up a connection to a named pipe in LiveWire two things must be
          set up in the port configuration. First, go into the configuration
          program under "Modem" and "Port Setup." Then, change your
          communications device to PIPE. Lastly, set the "Pipe Name" field to
          the name of the pipe you want to connect to.

          Pipe names always are of the format \PIPE\<pipename>.
          To access network pipes the pipe name format is
          \\<computername>\PIPE\<pipename>.

          When you exit configuration LiveWire will attempt to connect to the
          named pipe. If the connection attempt is unsuccessful the message
          "PORT NOT READY" will appear on the status line and the status line
          will say "Offline". If the connect is successful, the time spent
          connected will be displayed on the status line.

          To disconnect from a named pipe connection, press the hangup key
          sequence, usually ALT-H. A window saying "Disconnecting pipe" will
          appear, and the status line should read "Offline." If, during a
          connection, the remote disconnects the pipe the status line will
          report that you are "Offline".

          To attempt a re-connection to a named pipe, press the hangup key
          sequence again (usually ALT-H). A window saying "Attempting to
          reconnect pipe" will appear. If the connect was successful, the
          status line will indicate the connection has been established by
          displaying the time connected.

          For more information on how to setup named pipes refer to your
          remote's manual or online help.

 REXX Scripting Functions    63/1+

REXX Scripting Functions

Starting a script
          LiveWire includes support for the OS/2 REXX procedure language.
          LiveWire scripts may be started in one of three ways. Scripts may be
          started using the command line parameter /Sscriptname where
          <scriptname> is the name of the script to start. Scripts may be
          started from within LiveWire in two ways, by invoking them from the
          terminal mode or by linking them to a dialing entry. When the dialer
          makes a connection to a particular service, its script is
          automatically started.

 Description of functions
          REXX is a very powerful script language provided with OS/2. LiveWire
          extends the power of REXX by providing a full suite of functions
          designed to control communications sessions. Beneath this item is a
          list of functions that are added to REXX scripts executed inside
          LiveWire. 

          There are two special commands, GetLW and SetLW, which get and set
          LiveWire attributes. An attribute is any toggle or setting
          configurable in LiveWire. These attributes include cursor location,
          screen color, phone book entries, timeout values, terminal
          emulations, capture, and log. A complete list and description of all
          attributes are available beneath the SetLW function.

          The rest of the commands handle LiveWire functions, such as hanging
          up, dialing, and exiting. Complete descriptions are given beneath
          this panel. Some functions include examples, but the best examples
          are provided in the host mode script (HOST.CMD) provided with
          LiveWire 2.2.

 REXX extensions
          REXX scripts are plain ASCII text, and must end with the .CMD
          extension. LiveWire registers itself as a sub-command handler for
          REXX programs run inside LiveWire. LiveWire passes on any commands
          that are not valid functions to the OS/2 command interpreter.
          Standard REXX output, tracing output, and error output are mapped to
          LiveWire's terminal screen. In addition, LiveWire redirects the
          standard REXX output command SAY to to the LiveWire terminal screen.

          REXX scripts run from inside LiveWire can be further extended by
          third party extensions in order to add features such as
          multi-threading or PM interfaces.
          This manual does not include a complete description of the REXX
          scripting language. More information on the REXX scripting language
          is distributed with OS/2 as the INF file "REXX Information" normally
          kept in the Information folder.

 Script commands quick reference    64/2 

Script commands quick reference

The following are all LiveWire-defined script functions and attributes. This
page is for quick reference only, see full documentation on each function and
attribute for more information.

Functions defined by LiveWire

AnsiColorLW(fg, bg)
ClrScrLW()
DelayLW(ms)
DialLW(markstring)
DiseLW(string)
DispLW(string)
DoMacroLW(keyname)
DumpScreenLW(filename)
FindLW(string, string, ...)
FlushBufferLW()
GetKeyLocalLW()
GetKeyLW()
GetKeyRemoteLW()
GetLW(attribute)
GetStrLocalLW(string, maxlen)
GetStrLW(string, maxlen)
GetStrRemoteLW(string, maxlen)
HangUpLW()
LogLW(string)
ReceiveFilesLW(protocol, path)
SendBreakLW()
SendFilesLW(protocol, filelist)
SetLW(attribute, attribute_value)
SleepLW(seconds)
WaitTimeLW(hr, min)

Attributes for GetLW and SetLW

BgColor             BSisDEL             Capture
 CaptureFile        ConnectPopup        ConnectTimeout
 CurrentDir         CurrentDisk         CursorX
 CursorY            DataBits            DialerBits
 DialerDuplex       DialerEmulation     DialerInfoFile
 DialerLastCall     DialerName          DialerNumber
 DialerOnStartup    DialerParity        DialerPassword
 DialerPhoneNumber  DialerProtocol      DialerScriptFile
 DialerSpeed        DialerStop          DialerTotalCalls
 DLDir              DoorWay             DumpFile
 Echo               EchoBack            Editor
 Emulation          FgColor             IgnoreCarrier
 Linefeeds          LocalOnly           LocalOnly
 LockedPort         Log                 LogFile
 MacroFile          Music               Online
 Pacing             Parity              PhoneFile
 PipeName           Port                Printer
 RedialWait         RtsCts              ScrollBack
 Speed              StatusLine          StopBits
 TimeOut            ULDir               XlateFile
 XonXoff

 GetLW(attribute)    65/2 

GetLW(attribute)

          GetLW takes an attribute as an argument and returns the current
          actual value of the passed attribute.  If the value of the attribute
          is undefined, then the return value is the empty string or "".

 SetLW(attribute, attribute_value)    66/2+

SetLW(attribute,attribute_value)

          SetLW sets a majority of LiveWire program attributes.  It takes an
          attribute and a corresponding attribute value as arguments.  A call
          to SetLW will attempt to set the passed LiveWire program attribute to
          the passed attribute value. If SUCCESS, the return value is the empty
          string.

          Listed as sub-entries of this command are all the attribute that are
          Getable and Setable in LiveWire.

 TimeOut    67/3 

TimeOut

          TimeOut - represents the LiveWire timeout value in seconds.  TimeOut
          must be set to an integer value. 

          Example:  SetLW( TimeOut, 45 ); 

          This sets TimeOut to 45 seconds. If TimeOut is set to 0, then there
          is no timeout effect in LiveWire at all.

 Echoback    68/3 

Echoback

          EchoBack - determines whether or not input received over the
          communications line should be echoed back.

          Example: SetLW( EchoBack, On );
          This toggles EchoBack to ON.  Similarly, it may be set to OFF with
          SetLW( EchoBack, Off ); 

          Integer values may also replace the arguments, where 1=ON and 0=OFF. 
          By default, EchoBack is OFF.

 FgColor    69/3 

FgColor

          FgColor - represents the current local LiveWire foreground color. 
          May be set with colors in the range from 0 to 15, inclusive, integers
          values only. 

          Example:  SetLW( FgColor, 8 );
          This set the foreground color to Dark Grey. The following is the
          foreground coloring scheme:
 
          Value      Color
          -----      ----
          0          Black
          1          Blue
          2          Green
          3          Cyan
          4          Red
          5          Magenta
          6          Brown
          7          White
          8          Dark Grey
          9          Light Blue
          10         Bright Green
          11         Bright Blue    
          12         Bright Red
          13         Bright Magenta
          14         Yellow
          15         White

 BgColor    70/3 

BgColor

          BgColor - represents the current local LiveWire background color. 
          May be set with the same values as FgColor, except only the range
          from 1 to 7. 

          Note:  Clearing the screen after modifying background colors will
          cause the entire screen to immediately change to that background
          color. 

 CursorX    71/3 

CursorX

          CursorX - the cursor X position, where X_Coordinate is an integer
          value in the range 1 to 80, inclusive.

 CursorY    72/3 

CursorY

          CursorY - the cursor position, where Y_Coordinate is an integer value
          in the range 1 to screen length, inclusive.

 Online    73/3 

Online

          Online - determines whether or not LiveWire is currently online.  If
          online, then the return value is 1.  Otherwise, if not online, then
          the return value is 0.  Note: This attribute is only defined for
          GetLW.

 CurrentDir    74/3 

CurrentDir

          CurrentDir - represents the current directory. 
          Example: SetLW( CurrentDir, "C:\LiveWire\Info" );

 CurrentDisk    75/3 

CurrentDisk

          CurrentDisk - represents the current default disk drive.
          Example:  SetLW( CurrentDisk, "D:" );.

 Emulation    76/3 

Emulation

          Emulation - represents the current emulation. 
          Emulation values are as follows:  0=TTY, 1=ANSI-BBS, 2=OS2YOU,
          3=VT-102 4=0+ Avatar.

          Example: SetLW( Emulation, 1 );
          This sets the current emulation to ANSI-BBS.

 Capture    77/3 

Capture

          Capture - determines whether or not LiveWire should capture sessions.
          May be set with ON/OFF, 1/0, where 1=Start Capture and 0=Stop
          capture.

          A third optional parameter (only available with ON setting) specifies
          the file to capture to.

          Note: When used with GetLW, only returns 1 or 0.
          Example: SetLW(Capture, ON);
          Example: SetLW(Capture, ON, "Cap.Fil");
          Example: SetLW(Capture, OFF);

 CaptureFile    78/3 

CaptureFile

          CaptureFile - represents the name of the current capture file.

 LogFile    79/3 

LogFile

          LogFile - represents the name of the current log file.

 Log    80/3 

Log

          Log - determines whether or not LiveWire's log feature is active.

 Echo    81/3 

Echo

          Echo - determines whether or not the echo (display) of key presses is
          on or off. May be set with attribute values On or Off, 1 or 0, True
          or False.  Note: When used with GetLW, only returns 1 or 0.

          Example: SetLW(Echo, On);

 Linefeeds    82/3 

Linefeeds

          Linefeeds - determines whether or not automatic line feeds is on or
          off. May be set with attribute values On or Off, 1 or 0, True or
          False.  Note: when used with GetLW, only returns 1 or 0.

 RtsCts    83/3 

RtsCts

          RtsCts - determines whether or not RTS/CTS flow control is on or off. 
          May be set with attribute values On or Off, 1 or 0, True or False. 
          Note:  When used with GetLW, only returns 1 or 0.

 StatusLine    84/3 

StatusLine

          StatusLine - determines whether or not the status line is turned on
          or off. Maybe set with attribute values On or Off, 1 or 0, True or
          False. Note:  When used with GetLW, only returns 1 or 0.

 DoorWay    85/3 

Doorway

          Doorway - determines whether or not doorway mode is on or off.  May
          be set with attribute values On or Off, 1 or 0, True or False.  Note: 
          When used with GetLW, only returns 1 or 0.

 Printer    86/3 

Printer

          Printer - determines whether or not printer capture is on or off. 
          May be set with attribute values On or Off, 1 or 0, True or False. 
          Note:  When used with GetLW, only returns 1 or 0.

 BSisDEL    87/3 

BSisDEL

          BSisDEL - determines whether or not the backspace key is equated with
          the DEL key.  May be set with attribute values On or Off, 1 or 0,
          True or False. By default, BSisDel is set OFF.  Note:  When used with
          GetLW, only returns 1 or 0.

 PhoneFile    88/3 

PhoneFile

          PhoneFile - represents the current phone directory file. 

 MacroFile    89/3 

MacroFile

          MacroFile - represents the current macro file.

 XlateFile    90/3 

XlateFile

          XlateFile - represents the current translation table file.

 Port    91/3 

Port

          Port - represents the current communications port being used.

 Speed    92/3 

Speed

          Speed - represents the current modem speed.  May be set with any
          common baud rate. 

          Example:  SetLW(Speed, 14400);
          This sets the  modem speed to 14000 baud.

 Parity    93/3 

Parity

          Parity - represents the current parity checking in effect.

          Parity values are as follows:
          0=No Parity
          1=Even Parity
          2=Odd Parity

 DataBits    94/3 

DataBits

          DataBits - represents the number of databits (7 or 8) used in
          communication. The number of databits must be integer values of
          either 7 or 8.

 StopBits    95/3 

StopBits

          StopBits - represents the number of stop bits used in communication.
          The number of stop bits must be integer values of either 1 or 2. 

 LockedPort    96/3 

LockedPort

          LockedPort - determines whether or not the modem baud rate is locked.
          May be set with attribute values On or Off, 1 or 0, True or False. 
          Note: When used with GetLW, only returns 1 or 0.

 PipeName    97/3 

PipeName

          PipeName - represents the name of the current named pipe.

 XonXoff    98/3 

XonXoff

          XonXoff - determines whether or not flow control is on or off.  May
          be set with attribute values On or Off, 1 or 0, True or False.  Note: 
          When used with GetLW, only returns 1 or 0.

 IgnoreCarrier    99/3 

IgnoreCarrier

          IgnoreCarrier - determines whether or not to ignore carrier on
          downloads and uploads.  May be set with attribute values On or Off, 1
          or 0, True or False. Note: When used with GetLW, only returns 1 or 0.

 ConnectPopup    100/3 

ConnectPopup

          ConnectPopup - determines whether or not to popup a message when
          connect to other host.  May be set with attribute values On or Off, 1
          or 0, True or False. Note:  When used with GetLW, only returns 1 or
          0.

 Music    101/3 

Music

          Music - determines whether or not music is on or off.  May be set
          with attribute values On or Off, 1 or 0, True or False.  By default,
          music is ON.  Note: When used with GetLW, only returns 1 or 0.

 DialerOnStartup    102/3 

DialerOnStartup

          DialerOnStartup - determines whether or not to dial a specified phone
          directory entry immediately upon LiveWire startup. 

 ScrollBack    103/3 

ScrollBack

          ScrollBack - determines whether or not the scroll back buffer is on
          or off. May be set with attribute values On or Off, 1 or 0, True or
          False. By default scrollback, is ON.  Note:  When used with GetLW,
          only returns 1 or 0.

 ConnectTimeout    104/3 

ConnectTimeout

          ConnectTimeout - represents the maximum amount of time LiveWire will
          wait to connect to each computer system dialed.

 RedialWait    105/3 

RedialWait

          RedialWait - represents the amount of time LiveWire will wait between
          dialing attempts. 

 Pacing    106/3 

Pacing

          Pacing - sets the character inter-pacing value.  If the pacing value
          is set to 0, then pacing has no effect.  Must be set with integer
          values where the pacing rate is effectively measured in milliseconds.

 Editor    107/3 

Editor

          Editor - represents the full path of the current default LiveWire
          text editor.

 ULDir    108/3 

ULDir

          ULDir - represents the directory where uploaded files will go. If
          this value is "", then the upload directory is the current directory.

 DLDir    109/3 

DLDir

          DLDir - represents the directory where downloaded files will go. If
          this value is "", then the download directory is the current
          directory.

 DumpFile    110/3 

DumpFile

          DumpFile - represents current dump file name including path.

 MacroFile    111/3 

MacroFile

          MacroFile - represents the name of the current macro file including
          path.

 LocalOnly    112/3 

LocalOnly

          LocalOnly - determines whether or not your script should send output
          to the modem.  When set to 0, Off, or False output from your script
          may be sent to the modem.  If set to 1, On, or True output is
          restricted to the local system. By default, LocalOnly is set to OFF. 
          Note: When used with GetLW, only returns 1 or 0.

 DialerNumber    113/3 

DialerNumber

          DialerNumber - The current dialing entry number being modified. If
          the script was run automatically from the dialer after connecting,
          this attribute will be set to the dialing entry connected to.

 DialerName    114/3 

DialerName

          DialerName - The name of the current entry in the dialing directory.

 DialerPhoneNumber    115/3 

DialerPhoneNumber

          DialerPhoneNumber - The number of the current entry in the dialing
          directory.

 DialerInfoFile    116/3 

DialerInfoFile

          DialerInfoFile - The name of the comments/information file of the
          current entry.

 DialerScriptFile    117/3 

DialerScriptFile

          DialerScriptFile - The name of the script file of the current entry.

 DialerSpeed    118/3 

DialerSpeed

          DialerSpeed - The communications speed of the current entry.

 DialerParity    119/3 

DialerParity

          DialerParity - The parity of the current entry.  (N, E, or O)

 DialerBits    120/3 

DialerBits

          DialerBits - The data bits of the current entry. (7 or 8)

 DialerStop    121/3 

DialerStop

          DialerStop - The stop bits of the current entry. (1 or 2)

 DialerDuplex    122/3 

DialerDuplex

          DialerDuplex - The duplex of the current entry. (F=Full, H=Half)

 DialerPassword    123/3 

DialerPassword

          DialerPassword - The password of the current entry.

 DialerProtocol    124/3 

DialerProtocol

          DialerProtocol - The hotkey (highlighted character in the menu) of
          the protocol of the current entry. (EG: Zmodem is Z, Xmodem-1K is 1)

 DialerEmulation    125/3 

DialerEmulation

          DialerEmulation - The emulation of the current entry.

 DialerLastCall    126/3 

DialerLastCall

          DialerLastCall - The date of the last call of the current entry.

 DialerTotalCalls    127/3 

DialerTotalCalls

          DialerTotalCalls - The number of total calls to the current entry.

 DispLW(string)    128/2 

DispLW(string)

          Disp(string) - displays a string locally (i.e. does not send it over
          the modem), where <string> is a string of text enclosed in a pair of
          quotes or the name of a string variable. 

          The passed string may include any special control characters
          following special characters, for example: 
          ^M = carriage return
          ^J = line feed
          ^G = Bell

          ^M^J would be a carriage return immediately followed by a line feed.

          Example:
          DispLW("This will display a string and drop down to the next
          line^M^J");

 SendLW(string)    129/2 

SendLW(string)

          SendLW(string) - sends a string over the modem, but does not display
          it to the screen, where <string> is a string of text enclosed in a
          pair of quotes or the name of a string variable. 

          The passed string may include any special control characters
          following special characters, for example: 
          ^M = carriage return (or ENTER)
          ^J = line feed
          ^G = Bell

          ^M^J would be a carriage return immediately followed by a line feed.

          Example:
          DispLW("This will send a string to the modem and press [ENTER]^M");

 DiseLW(string)    130/2 

DiseLW(string)

          DiseLW(str) - sends a string over the modem and displays it locally
          as well, where <str> is a string of text enclosed in a pair of quotes
          or the name of a string variable.

          The passed string may include any special control characters
          following special characters, for example:
          ^M = carriage return (or ENTER)
          ^J = line feed
          ^G = Bell

          ^M^J would be a carriage return immediately followed by a line feed.

          Example:
          DispLW("This will send a string to the modem and display it on the
          LiveWire screen^M");

 FindLW(string, string, )    131/2 

FindLW(string, string, ...)

          FindLW(string, string, ... ) - Waits until one of the strings
          <string> is found in the information being received over the modem,
          where <string> is a string of text enclosed in a pair of quotes or
          the name of a string variable. Find may look for up to 10 strings. 
          The command fails if it cannot find one of the strings in the amount
          of time specified in the TIMEOUT variable.  Upon timeout, FindLW
          returns the string "TIMEOUT", otherwise it returns the string it
          found. Note that if timeout is zero, FindLW will not timeout.

          Note:  The passed strings may include the following special
          characters:  ^M = carriage return, ^J = line feed, and ^G = Bell. 
          For example, ^M^J would be a carriage return immediately followed by
          a line feed.

 GetKeyLW()    132/2 

GetKeyLW()

          GetKeyLW() - returns a single keystroke of input from either the
          local end or remote computer.

 GetKeyLocalLW()    133/2 

GetKeyLocalLW()

          GetKeyLocalLW() - returns a singe keystroke of input from the local
          end of LiveWire.

 GetKeyRemoteLW()    134/2 

GetKeyRemoteLW()

          GetKeyRemoteLW( ) - returns a single keystroke of input from the
          remote computer.

 GetStrLW(string, maxlen)    135/2 

GetStrLW(string, maxlen)

          GetStrLW(string, maxlen) - receives a full string from either the
          local or remote end and returns a string typed or edited by the user. 
          The string is ended when <ENTER> is pressed. If a string <string> is
          specified, the string appears for the user to edit. The string will
          not be allowed to exceed the maximum length specified by <maxlen>.
          The size of the passed string <string> cannot exceed the length.
          specified by <maxlen>.  By default, <maxlen> is 78.

          Example: 
          Name=GetStrLW("Les",15);

          Would display the name "Les" for editing. Up to a maximum of 15
          characters can be entered. When <ENTER> is pressed the variable
          "Name" gets the edited string.

 GetStrLocalLW(string, maxlen)    136/2 

GetStrLocalLW(string, maxlen)

          GetStrLocalLW(string, maxlen ) - this command is similar to GetStrLW
          except that GetStrLocalLW gets a string only from the local keyboard.
          Also, the editing provided is much more powerful than GetStrLW since
          it allows full editing of the variable with arrow, insert, and delete
          keys.

 GetStrRemoteLW(string, maxlen)    137/2 

GetStrRemoteLW(string, maxlen)

          GetStrRemoteLW(string, maxlen) - similar to GetStrLW, except this
          command only receives a string from the remote computer.

 DialLW(markstring)    138/2 

DialLW(markstring)

          DialLW(markstring) - marks and dials a range of entries based upon a
          given mark string, specified by the string <markstring>. The mark
          string allows you to mark entries by name, part of a name, or entry
          number. Here are some examples:

          1,10,50,3           Marks entries 1, 10, 50, and 3
          1,5..20             Marks entries 1, and all entries 5 through 20,
                              inclusive.
          1..20,25..200       Marks entries 1 through 20 and 25 through 200,
                              inclusive.
          DataMirage          Marks all entries that contain "DataMirage"
          Data                Marks all entries that contain "Data".  Note that
                              this will match entries such as "DataMirage", The
                              DATA Line", and "My Data". Also, this is case
                              insensitive.
          1,Data,5..20        Marks entry 1, all entries containing "Data", and
                              entries 5 through 20, inclusive.

 ClrScrLW()    139/2 

ClrScrLW()

          ClrScrLW() - clears the local screen.

 SendBreakLW()    140/2 

SendBreakLW()

          SendBreakLW() - sends a break signal over the modem for 1/4 of a
          second.

 SendFilesLW(protocol, filelist)    141/2 

SendFilesLW(protocol, filelist)

          SendFilesLW(protocol, filelist) 

          Sends (uploads) one or more files over the modem using the specified
          protocol, where <protocol> is a string variable that should contain a
          single character which is the hotkey of the protocol to use.  The
          hotkeys are the letters that are highlighted in the protocol listing
          when you press <PgUp>.  For example, Zmodem would be Z.  Xmodem would
          be X.  Xmodem-1K would be 1.

          <filelist> is a list of quote-enclosed files and their paths to send
          all in one string. Long filenames and filenames with spaces are
          accepted. If you wish to send only one file, there is no need to
          enclose the file in double quotes. Wildcards are not accepted.

          For example:
          SendFilesLW(Z, '"C:\COMMAND.COM" "F:\LW22\LW22.EXE"');
          SendFilesLW(Z, 'C:\AUTOEXEC.BAT');

          Returns "0" on success, otherwise failure.
          Specific failure codes may be added in future versions of LiveWire.

 ReceiveFilesLW(protocol, path)    142/2 

ReceiveFilesLW(protocol, path)

          ReceiveFilesLW(protocol, path) 

          Receives (downloads) one or more files over the modem using the
          specified protocol, where <protocol> is a string variable that should
          contain a single character which is the hotkey of the protocol to
          use.  The hotkeys are the letters that are highlighted in the
          protocol listing when you press <PgDn>.  For example, Zmodem would be
          Z.  Xmodem would be X.  Xmodem-1K would be 1. 

          <path> is the directory to place the received files into for batch
          protocols. For single-file protocols (Xmodem, Xmodem-1K, Xmodem CRC),
          <path> is the full filespec of the file being received. If <path> is
          the empty string (""), received files are placed in the default
          download directory. 

          For example:
          ReceiveFilesLW(Z, "");
          ReceiveFilesLW(Z, "C:\DOS");
          ReceiveFilesLW(X, "C:\DOS\COMMAND.COM");

          Returns "0" on success, otherwise failure.
          Specific failure codes may be added in future versions of LiveWire.

 AnsiColorLW(fg, bg)    143/2 

AnsiColorLW(fg, bg)

          AnsiColorLW(fg,bg) - sends an ANSI code over the modem that changes
          the remote terminal color. <fg> is the foreground color. <bg> is the
          background color.

 DumpScreenLW(filename)    144/2 

DumpScreenLW(filename)

          DumpScreenLW(filename) - dumps the current screen to <filename>, the
          specified dump file.

 ExitLW()    145/2 

ExitLW()

          ExitLW() - exits the LiveWire program.

 DelayLW(ms)    146/2 

DelayLW(ms)

          DelayLW(ms) - delays for <ms> milliseconds before resuming the
          script.

 SleepLW(seconds)    147/2 

SleepLW(seconds)

          SleepLW(seconds) - sleeps (does nothing) for <seconds> amount of time
          before resuming the script.

 WaitTimeLW(hr, min)    148/2 

WaitTimeLW(hr, min)

          WaitTime(hr, min) - waits until the current time is <hr>:<mn> (in 24
          hour military time) before resuming the script. During the wait time,
          the session continues. Therefore, this command can be used to capture
          data from a start time to end time.

 HangUpLW()    149/2 

HangUpLW()

          HangUpLW() - attempts to disconnect the current modem session.

          Returns "1" on success (modem reports offline status), "0" on failure
          (modem reports online status).

 DoMacroLW()    150/2 

DoMacroLW()

          DoMacroLW(<key name>) - executes a macro given a key name.

          Example:
          DoMacroLW("F1");
          DoMacroLW("ALT-X");

          Warning: This function has had minimal testing and is not guaranteed
          to work except for macros containing strictly ASCII text or the
          {PASSWORD} command. All other macro commands may or may not work.

 FlushBufferLW()    151/2 

FlushBufferLW()

          FlushBufferLW() - Flushes the incoming and outgoing data buffers.

 LogLW()    152/2 

LogLW()

          LogLW(<str>) - Creates an entry in the log file. The time and date
          are automatically stamped.

          Example:
          LogLW("Hanging up");
          LogLW("Phone rang");

 Learning scripts    153/1+

Learning scripts

          LiveWire has the capability to record part or all of a communications
          session and play it back automatically. This is called script learn.

          LiveWire accomplishes this "recording" by assuming that the service
          you are connected to will be sending a prompt (eg: Enter Your Name or
          Press Any Key...) and that you will respond by typing a response and
          pressing ENTER. LiveWire remembers what you type at each prompt and
          responds in the same manner next time it sees these prompts.

          The following runs through an example learning session:
          The first thing you must do is find a service you want to call in
          your phone directory and put a filename in the "Script" field. To
          edit this entry press "E" while the highlight bar is on the entry.
          When the edit window appears, move your highlight bar to the entry
          "Script" and press ENTER. Now type a filename, ending with the
          extension .CMD, into this field and press ENTER. Then press Esc to
          save this entry.
          Now, dial the service. Note that as you dial an "L" appears next to
          the entry where a check mark normally appears. This means that
          LiveWire will automatically start learning as soon as you get onto
          the service.
          Logon normally to the service, but take care to note of how much of
          your logon you want LiveWire to remember. For example, on most
          services you would only need LiveWire to remember when you type your
          name and password. Beyond this (reading bulletins and messages) the
          service you call probably changes daily. If so, LiveWire will become
          confused. It isn't smart enough to adapt to these changes.
          When you are ready to have LiveWire stop learning, look at the status
          line on your screen. It will tell you what keys you need to press to
          stop script learning.

          That's it! Next time you call the same service LiveWire should
          automatically replay what it learned, key for key. If for some reason
          LiveWire did not learn correctly or you made a mistake while it was
          learning you can change the name of the script filename in the phone
          book entry or erase the script file.

          TIPS FOR LEARNING:
          LiveWire makes the assumption that when you press ENTER you are
          finished typing so...

          - Press ENTER after each prompt

          - The use of hotkeys (selection of an option without having to press
          ENTER) may not work

 Editing a learned script file    154/2 

Editing a learned script file

          Editing a script file associated with a service in the dialer is
          simple. Go into the dialer and move the highlight bar to the service,
          then press the V (for View Script) key. After a few seconds an editor
          will come up with the learned script. 

          If you intend to fix the script, the first thing you need to know is
          at what point the script is failing. For example, if the script never
          responds to a "PASSWORD:" prompt then you know that it is not
          recognizing the prompt correctly.

          Move your cursor to the place in the script which has the command to
          find the password prompt. This may look like:

          FindLW("PASSWORD:");

          Any small difference in the actual prompt and the prompt LiveWire
          expects will cause a problem. Some things to look for are:

          + Time/Date dependent information is part of the prompt
          EG: "(23 minutes left) COMMAND:"
          this should be changed to "COMMAND:"

          + Spaces where they do not belong

          + Odd control (^) characters

          + Line noise

          + The system prompt changed since you learned the script!

 Host mode script    155/1 

Host mode script

          LiveWire 2.2 includes a Host Mode REXX script. The host mode script
          allows a computer to accept incoming calls. Callers can access the
          remote computer and do the following functions:

          - Transfer files
          - Send messages
          - Chat with you

          The host mode included is by intended for simple purposes only and is
          not robust or complete enough to serve as a full bulletin board or
          service. The host might be useful if you have a co-worker or friend
          who needs to call up to your system and get a file. In addition, he
          might also leave you a short message. The host could also be useful
          if you frequently exchange files from your home to the office via
          modem. The host is also a good example of how to program REXX scripts
          under LiveWire.

          To start the host most you must invoke it from LiveWire's command
          menu. The only parameter it recognizes is "LOCAL". If you type LOCAL
          as a parameter, the Host Mode will not wait for an incoming call, but
          instead will allow you to login locally.

          Host mode expects that the modem is setup correctly. Before running
          host mode make sure that:
          1. The modem is NOT in auto-answer mode
          2. The modem returns text response codes
          3. The modem speed is set properly
          4. If necessary, the modem's port speed is locked properly

          By default the host stores its messages and files in the LiveWire
          directory in the HSTFILES and HSTMSGS directories, which are
          automatically created by the script. These directories can be changed
          using the sysop menu inside the host. The default sysop password is
          "PASSWORD."

          If you have a special need that the host mode script does not
          address, feel free to modify the script. The script is not
          copyrighted, so any changes made may be re-distributed freely.

 Reporting bugs and suggestions    156/1 

Reporting bugs and suggestions

          DataMirage Software is committed to developing and delivering
          quality, bug-free software that meets your needs. Our bug database
          allows us to track each bug and suggestion individually. This bug
          database will be available in January 1994 to callers of the
          DataMirage BBS. Callers will be able to query for bugs and submit new
          bugs or suggestions directly to our database. Later, they can call
          back and view the progress being made on the bug and the release in
          which it will be fixed.

          We still accept bugs and suggestions from internet, CompUServe, and
          Prodigy. All bugs submitted must be in the format following. Bugs not
          in this format are often ambiguous, so please follow this format as
          closely as possible and provide as much detailed information as
          possible. Please note, only one bug or suggestion per form.

 Submission addresses:
          Internet  : 73631,1233@compuserve.com
          CompUServe          : 73631,1233

          LiveWire Bug Report
          585 Hyde Park Drive
          San Jose, CA 95136

          Bug Submission Form

          Submitter First Name :
          Submitter Last  Name :
          Submitter Phone #    :
          Submitter EMAIL      :

          One-line description :

          Severity of bug (1=who cares? - 4=critical crash) :

          Version of LiveWire :

          Steps to reproduce bug (many lines) :
          Complete description of bug or suggestion (many lines) :
          Have you tested this against other communications software?

          Describe your hardware setup, if necessary:
          - CPU
          - UART type
          - Modem manufacturer
          - Remote host

 Registration and support    157/1 

Registration and support

LiveWire 2.2 shareware license agreement

This agreement replaces all previous versions of LiveWire Communications
license agreements.

LiveWire is NOT free software! LiveWire is marketed under the shareware
marketing concept. You may use LiveWire for 30 days, after which you are
obligated to either register this software or discontinue use of the software.
The fee for registration is nominal and brings a lot of benefits. If you
register once, you will never have to buy another shareware version of
LiveWire. All future versions of LiveWire marketed under the shareware concept
can be registered with your serial number -- even if the registration prices go
up. You also get free (except for long distance or toll charges) support
through the DataMirage Bulletin Board System.

By using this software you are agreeing to the above terms.

Basic registration is $35
That includes:
- Your registration number
- Support through the DataMirage BBS

Extended registration is $45
That includes:
- Your registration number
- A registered copy of the latest version of LiveWire
- Support through the DataMirage BBS

Complete registration is $65
That includes:
- Your registration number
- A registered copy of the latest version of LiveWire Support
- Support through DataMirage BBS
- A laser printed manual, identical to the one provided with the 2.2 release

to register, mail the registration blank on the following page to:
DataMirage Software
585 Hyde Park DriveSan Jose, CA 95136

 Registration by credit card    158/1 

Registration by credit card

          Starting with version 2.2 of LiveWire, credit card registration is
          available through the Public Shareware Library (PSL).

          CREDIT CARD ORDERS ONLY:
          You can order with MC, Visa, Amex, or Discover from Public (software)
          Library by calling 800-2424-PsL or 713-524-6394 or by FAX to
          713-524-6398 or by CIS Email to 71355,470 or by Internet Email to
          71355,470@compuserve.com. You can also mail credit card orders to PsL
          at P.O.Box 35705, Houston, TX 77235-5705.

          PsL can take orders via our 800#, non-800#, CIS#, and FAX#. Operators
          are available from 7:00 a.m. to 7:00 p.m. CST Monday-Friday and
          normally from 7:00 a.m. to 4:00 p.m. on weekends. 

          THE ABOVE NUMBERS ARE FOR ORDERS ONLY

          Any questions about the status of the shipment of the order, refunds,
          registration options, product details, technical support, volume
          discounts, dealer pricing, site licenses, etc, must be directed to:

          DataMirage Software
          585 Hyde Park Drive
          San Jose, CA 95136
          BBS #: 714-856-2071

          To insure that you get the latest version, PsL will notify DataMirage
          the day of your order and we will ship the product directly to you.

          Software Order #11300

 Registration form    159/1 

Registration form (print me!)

Filling out your name, address, and phone number is a
requirement. Your name will be used to personalize your serial
number.

Name      _________________________________

 Address
          _________________________________

          _________________________________

          _________________________________

 Phone # (_____)_________-________________

 QUANTITY
 (  ) $35 Basic Registration   = registration #

 (  ) $45 Extended Registration = registration # + newest version

 (  ) $65 Complete Registration = registration # + newest version + printed
 manual

   SUB TOTAL   ________

   $5 shipping  ________   (USA addresses excluded)

  + TAX (8.75%)  ________   (California residents only!)

   TOTAL COST  ________

 I only accept US currency, US money orders, and checks through the mail. If
 you send a purchase order, please make it clear where the invoice should be
 mailed.

