OS/2 Shareware BBS: 3 Comm/03-Comm.zip/lw30.zip/LWHLP.HLP

OS/2 Help File | 1995-09-18 | 238KB | 2,456 lines

ΓòÉΓòÉΓòÉ 1. LiveWire/WPS 3.0 ΓòÉΓòÉΓòÉ

LiveWire 3.0 for the Workplace Shell


User Manual


Copyright 1995 Les Novell


ΓòÉΓòÉΓòÉ 2. Introducing LiveWire for the Workplace Shell ΓòÉΓòÉΓòÉ

Introduction

LiveWire Communications for the Workplace Shell is the 32-bit, multi-threaded,
graphical and text based communications software for OS/2 Warp 3.0 and later.

LiveWire is optimized to take full advantage of OS/2. Small, reliable, and easy
to use, LiveWire is also packed with many high-end features.

LiveWire's interface is designed to be easy to use and configure, especially
for users familiar with other communications software.

Features

o   Both graphical and text mode support

o   Ability to switch to text mode from graphical seamlessly

o   Emulations supported: TTY, ANSI, VT-102, OS2You, 0+ Avatar, and RIPTerm

o   Integrated REXX scripting language

o   High performance output

o   Unlimited scroll-back buffer

o   Internal protocols supported: Zmodem-32, Xmodem and Ymodem

o   External protocols supported: P, M2Zmodem, CKermit, and others

o   Named pipe support for network modems

o   Point and shoot phone book with auto-dialer

o   Macro comands control the actions of most Fn and Alt keys; all keys are re-definable

o   Phone book can import existing ZOC, Procomm, Procomm+, Qmodem, Boyan, and
    Telix phone books.


ΓòÉΓòÉΓòÉ 3. Installing and Deinstalling LiveWire/WPS ΓòÉΓòÉΓòÉ

Installation

LiveWire is a WorkPlace Shell application that requires a complex installation
procedure. The install procedure involves attaching new objects to OS/2.

However, this installation process has been simplified so that it can be
accomplished in one button push, and a single system shutdown and restart.

To Install LiveWire

1.  Insert the first installation disk into your disk drive.

2.  Open the corresponding drive icon on your OS/2 desktop.

3.  Double click on INSTALL.EXE.

4.  After a moment, an installation window will appear.

5.  Select a drive to install on. There must be at least five megabytes of
    space on that drive.

6.  Click on the Install button.

7.  After the files have been copied, you must shut down and restart your system.

8.  When your computer restarts, LiveWire will complete installation. This may
    take a few minutes.

9.  LiveWire will create default folders and objects automatically. When they
    appear, configuration is complete.

Deinstallation

Deinstallation is also a complex process. However, LiveWire eases the
complexity by providing a simple deinstallation program.


To deinstall LiveWire

1.  Open the LiveWire Accessories folder.

2.  Double click on the DeInstall LiveWire icon.

3.  After a few moments, a deinstallation window will appear.

4.  Click on the DeInstall button.

5.  After a very short time, you will be asked to shut down and restart.

6.  Upon restarting your computer, LiveWire will complete deinstallation by
    removing all files and directories.

Note:  If you wish to delete the LiveWire program  after reinstalling OS/2, you
may delete its files directly off the hard drive. However, if LiveWire objects
are still present on the system NEVER directly delete files from the LiveWire
directory. Always use the provided deinstallation program.


ΓòÉΓòÉΓòÉ 4. Using LiveWire/WPS ΓòÉΓòÉΓòÉ

Using LiveWire Communications for the WorkPlace Shell



The LiveWire program consists of three visible objects: LiveWire, phone book,
and the log.

The LiveWire object (also referred to as the terminal object) is the object
that allows you to communicate with other computer systems. Opening this object
opens a blank, black window into which you may directly type. The terminal
object performs a number of other functions such as file transfer, scroll-back,
and scripted communications sessions.

The phone book object (also referred to as the dialer object) helps you keep
track of the phone numbers and configurations of remote computer systems. The
phone book will also dial those numbers and automatically connect you with a
remote computer system through the LiveWire object.

The log object records the time and date you performed important actions while
using the LiveWire or phone book object. For example, the log object keeps
track of which computer systems you call and files you transfer.





ΓòÉΓòÉΓòÉ 4.1. LiveWire object ΓòÉΓòÉΓòÉ

Using the LiveWire object

To open the LiveWire object, double click on the following icon:


While LiveWire is starting up, a small window that says "Initializing LiveWire"
will appear. A few moments later, a terminal window that looks like the
following will appear.



Three parts of this window are important. The toolbar contains icons for
frequently used commands. These commands are also available through accelerator keys.

The status line at the bottom of the window contains relevant information about
the current terminal and connection status.

The terminal is the black area with a white flashing underline-style cursor
into which you may directly type. When you are not connected to a remote
computer system, the terminal session allows you to send commands directly to
your modem. You will rarely need to send commands to your modem in this manner.


ΓòÉΓòÉΓòÉ 4.1.1. Modem initialization ΓòÉΓòÉΓòÉ

The modem initialization string

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

Before sending the initialization string, 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 want to send the initialization string.

Some modems may initially report that they are connected with another computer,
but after sending the first initialization will report the correct status.

If your modem was not listed in the predefined modems in the LiveWire modem
database, you should consult your modem manual or call your modem manufacturer
for the correct settings. Some of the most common problems that occur if the
modem initialization string is wrong are:

o   Modem says "ERROR"

o   Modem does not respond to commands

o   Modem does not respond to keystrokes

o   Modem responds with numbers instead of full text responses such as OK,
    CONNECT, and BUSY

o   Modem indicates it is always online

o   Modem connects at the wrong speed

o   LiveWire's dialer cannot dial

o   LiveWire's dialer cannot recognize busy or connect signals


ΓòÉΓòÉΓòÉ 4.1.2. Toolbar ΓòÉΓòÉΓòÉ

Toolbar

Two toolbars in the terminal object allow you to access all features and
functions. The first toolbar appears at the top of the terminal window. The
second toolbar (the pop-up toolbar) appears when you click once with the second
mouse button on the black portion of the terminal window.



Each icon on the toolbar performs a specific action. Moving the mouse pointer
over an icon causes a short description of the function that icon performs to appear.

The following is a more detailed description of each of the icons and their functions.

 Notebook settings
Selecting this icon causes the settings notebook to appear. The settings
notebook allows you to configure the LiveWire terminal. For more information
about the settings notebook, see LiveWire/WPS Settings Notebook.

 Phone book
Selecting this icon causes the phone book object to open and appear. Using the
phone book object you may dial and connect to another computer. For more
information, see Phone book object.

 Receive files
Selecting this icon allows you to begin receiving one or more files. For more
information, see the section on File transfers.

 Send files
Selecting this icon allows you to begin sending one or more files. For more
information, see the section on File Transfers.

 View scroll-back
Selecting this icon allows you to view information that has since moved off the
screen. For example, if a portion of a message scrolls off the screen you can
go back and read it using the scroll-back viewer. For more information, see the
section Scroll-back viewer.

Paste text
Selecting this icon causes any text in the system clipboard to be pasted into
the terminal. The paste occurs as if the text were typed directly into the
terminal.

If more than a few lines of text are in the system clipboard, LiveWire will ask
before beginning the paste operation.

 Erase screen
Selecting this icon causes the text in the terminal window to be cleared.

 Run script
Selecting this icon causes the REXX scripting control panel to appear. From the
control panel you can play, stop, and record scripts. For more information see
the sections Rexx Control Panel and REXX Scripting.

 Modem lights
Selecting this icon causes a window to appear that displays the modem status
lights as they would appear on an external modem.

The modem lights window can be sized by grabbing and dragging the corner of the window.

The following lights appear, in order:

o   RI   Ring indicator

o   RCV  Receive data indicator

o   XMT  Transmit data indicator

o   CD   Carrier detect indicator

o   CTS  Clear to send indicator

o   RTS  Ready to send indicator

 Statistics
Selecting this icon causes a line statistics window to appear. This window
contains four graphs containing average and current CPS rates for send and
receive.

 Hang-up
Selecting this icon causes LiveWire to attempt to hang up the modem. Two
methods are attempted. First, LiveWire lowers the DTR (Data Terminal Ready)
signal for 1/4 second and raises it. Most modems will take this as a signal to
hang-up. If the modem fails to hang-up using this method, LiveWire sends a
hang-up string to the modem instructing it to hang up the phone.

 OS/2 prompt
Selecting this icon causes LiveWire to open an OS/2 command prompt. To close
the command prompt type EXIT and press Enter at the OS/2 prompt.

 Exit LiveWire
Selecting this icon causes the LiveWire terminal object and phone book object
to close.

If LiveWire detects that you are still connected to another computer, you will
be asked before disconnecting and exiting.

 Reset terminal
Selecting this icon causes the current terminal emulation to reset to its
initial state. Reset causes the screen is cleared and reset to black on white
and the keyboard mappings to be returned to normal.

You should use the reset option if your keyboard or terminal screen get stuck
in a undesired state.

 Capture to disk
Selecting this icon will turn capture of an entire communications session to
disk on or off.

While capture is on, all text received and sent is saved to the disk for later
review. If capture is currently on, a small disk icon will appear on the status
line at the bottom of the terminal window.

 Edit file
Selecting this icon will open the editor specified in the Path settings
notebook page.


ΓòÉΓòÉΓòÉ 4.1.3. Status line ΓòÉΓòÉΓòÉ

Status line

The status line appears at the bottom of the LiveWire object window. The status
line contains information about the current connection as well as important
information about the current state of the LiveWire object.

The left hand side of the status line contains connection information in the
following format:

            COM1 38400 8 N 1  ANSI
                      
Emulation ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓö╝ΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÿ
Stop Bits ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓö╝ΓöÇΓöÿ
Parity   ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÿ
Data Bits ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
Speed   ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÿ
Device   ΓöÇΓöÇΓöÿ

These settings can be set in the Settings Notebook.

The right hand side of the status line may contain several small icons:
= Not Connected
= Connected
= Capturing data to disk
= Playing REXX script
= Recording REXX script


ΓòÉΓòÉΓòÉ 4.1.4. Terminal  ΓòÉΓòÉΓòÉ

Terminal

The terminal window is the black area with a white flashing underline-style
cursor. You may type directly into the terminal window.

The terminal window is designed to act like (emulate) one of several common
computer systems. Before connecting to a remote computer, the correct emulation
should be selected in the Terminal page of the Notebook Settings.

The terminal 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 is called Hayes AT commands. AT is short for "ATtention." Typing AT an
then pressing ENTER should make the modem respond by printing OK on the screen.
Some other commands are ATH for hang-up 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 will need to do
this, because if either computer hangs up the phone the modem will return to
command mode automatically. Once back in command mode, the modem is ready to
dial and connect to another computer.



ΓòÉΓòÉΓòÉ 4.1.5. LiveWire Keys ΓòÉΓòÉΓòÉ

LiveWire Keys

The LiveWire terminal responds to the following key combinations:

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéAlt-A     ΓöéAbout LiveWire box              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-B     ΓöéSend break signal               Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-C     ΓöéClear terminal screen           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-D     ΓöéBring up phone book for dial    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-E     ΓöéEdit file                       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-H     ΓöéHangup                          Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-I     ΓöéInvoke (run) script             Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-K     ΓöéCapture on/off                  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-N     ΓöéBring up settings notebook      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéShift-Ins ΓöéPaste text in clipboard         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-R     ΓöéReset terminal emulation        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-S     ΓöéShell to OS/2 prompt            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-X     ΓöéExit LiveWire                   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-Up    ΓöéBring up scroll-back viewer     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPageUp    ΓöéSend files (upload)             Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPageDn    ΓöéReceive files (download)        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéF1-F4     ΓöéReserved when in VT-102         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéF12       ΓöéSwitch to full screen mode      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-P     ΓöéSend password from dialer       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt-U     ΓöéSend username from dialer       Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 4.2. Phone Book object ΓòÉΓòÉΓòÉ

Using the Phone Book object

The phone book keeps a list of phone numbers of other computers. The phone book
keeps records such as computer name, number, last called, and number of times
called. The phone book also performs useful functions such as dialing the modem
and establishing a connection to one of the computers. The phone book will
automatically redial a phone number or several selected phone numbers until it
connects to another computer.

To open the Phone Book object, double click on the following icon, or click on
the phone book icon in the terminal toolbar.



After a few moments, the phone book window will appear. The phone book window
has three important parts. The toolbar is located at the bottom of the window.
The service list is the main portion of the window that contains a list of
computers and phone numbers. The "free space," located at the top of the
window, is the empty space on the window above the list of phone numbers.


The toolbar contains several common functions you can perform with the phone book.

The service list is an OS/2 container control and works much like the details
view of the OS/2 Drives object. Clicking on one or more services causes them to
be selected or deselected for dialing. To begin dialing, double click on any service.

The keyboard may also be used to select and dial entries from the service list.
To do this, use the arrow keys to move the dotted selection cursor and press
the space bar to highlight a service. Pressing the Enter key causes the phone
book object to begin dialing.

Clicking with the second mouse button on the service list brings up a pop-up
context-sensitive menu. This menu is specific to the service entry clicked
over.

The "free space" at the top of the window contains the phone book title and
current view name. Clicking the second mouse button on the free space brings up
a pop-up context-sensitive menu. This menu is contains options which affect the
entire phone book, not just a particular service entry.


For a full description of each menu item selection click below.

New entry

Edit entries

Dial selected

Select entries

Sort entries

Delete entries

Pre/Postfixes

Phone book settings

Importing other phone books


ΓòÉΓòÉΓòÉ 4.2.1. New entry ΓòÉΓòÉΓòÉ

New entry

Selecting this option creates a new entry in the service list. After the new
blank entry is created, its edit window appears. You should at least fill in
the name and phone number fields before saving the entry. For more information,
see the panel on editing entries.


ΓòÉΓòÉΓòÉ 4.2.2. Edit entry ΓòÉΓòÉΓòÉ

Edit entry



Selecting this option causes the edit window to appear. This edit window allows
you to change all of the options associated with a service.

Select one of the following fields for more information:

Name and number

Line parameters

Script file

Emulation and protocol

Last call and total connects

Flags

User name and password


ΓòÉΓòÉΓòÉ 4.2.2.1. Service Name and Number ΓòÉΓòÉΓòÉ

Service Name and Number



These are text entry fields. The name field is the name of the computer,
service, or person this service entry applies to.

The number field is the full phone number, including any necessary area or
international calling codes.

Prefixes and Postfixes can be inserted into the phone number by specifying an
uppercase letter of the alphabet A through J. If one of these letters are
inserted, then the corresponding pre/postfix is inserted. For example,

where A is defined as "1-714-"
A555-1212
would translate to
1-714-555-1212

This feature is extremely useful if you are changing locations frequently,
dialing internationally, or using a calling card.

The number field can also be used to store lowercase host names for telnet
connections. For example, entering "wave.ics.uci.edu" will automatically
connect to the host wave.ics.uci.edu when the service is dialed. For more
information on Telnet, see the section Using TELNET.


ΓòÉΓòÉΓòÉ 4.2.2.2. Service line parameters ΓòÉΓòÉΓòÉ

Service line parameters



This field allows you to configure the line parameters used to connect to the
remote computer. Line parameters include port speed, parity, databits, and stop bits.

The format is as follows, where the speed is optional:
[SPEED]  <BITS><PARITY><STOPBITS>

For example,
19200 8N1
or
7E1

Omitting the speed parameter uses the current default speed. Omitting all
parameters causes LiveWire to use all current line parameters.




ΓòÉΓòÉΓòÉ 4.2.2.3. Service script file ΓòÉΓòÉΓòÉ

Service script file



Selecting a REXX script from this drop-down list box causes that script to be
played when a connection is established.

Selecting <Record Logon> will cause LiveWire to begin recording a script when a
connection is established. Once you are finished recording the script you must
press the stop button in the REXX Control Panel. After the script is saved, go
back into the script file field and select the newly recorded logon script.


ΓòÉΓòÉΓòÉ 4.2.2.4. Service emulation and protocol ΓòÉΓòÉΓòÉ

Service emulation and protocol



These two fields allow you to select the desired terminal emulation and file
transfer protocol for the service entry.

For a description of emulations, see the section Terminal Emulation.

For a description of protocols, see the section File Transfers.


ΓòÉΓòÉΓòÉ 4.2.2.5. Service last call and total connects ΓòÉΓòÉΓòÉ

Service last call and total connects



These fields are generally maintained by LiveWire. The Last Call field contains
the date of the last connection to this service. The Total Connects field
contains the number of times a connection was established with this service.



ΓòÉΓòÉΓòÉ 4.2.2.6. Service Flags ΓòÉΓòÉΓòÉ

Service Flags

These flags control important terminal options.




Echo
 = Echo on
 = Echo off
 = default

Backspace is DEL
 = BackSpace mapped to DEL
 = BackSpace mapped to BackSpace
 = default

Linefeeds
 = Linefeeds on
 = Linefeeds off
 = default

XON/XOFF
 = XON/XOFF on
 = XON/XOFF off
 = default

RTS/CTS
 = RTS/CTS on
 = RTS/CTS off
 = default

Omit default prefix
 = Omit default dial prefix (usually ATDT)
 = Use default dial prefix (usually ATDT)


ΓòÉΓòÉΓòÉ 4.2.2.7. User name and password ΓòÉΓòÉΓòÉ

User name and password



The user name and password fields are for your information only. Entering your
login name and password into these fields makes them easy to retrieve later in
REXX scripts and macros. Your password is hidden for security reasons.

To get the LiveWire terminal object to automatically type your password, press
Alt-P in the terminal. To recall your username, press Alt-U in the terminal.

For example, after logging into a computer you might see the following prompts:

login: <Alt-U>    (sends username)
password: <Alt-P>  (sends password)


ΓòÉΓòÉΓòÉ 4.2.3. Dial selected ΓòÉΓòÉΓòÉ

Dial selected

Selecting this menu item causes LiveWire to begin dialing. The following window
will appear containing dial information:



The dialer will dial all highlighted phone book entries in a round-robin
fashion, starting with the first number in the phonebook.

To add phone numbers while the dial is in progress, simply highlight more
numbers in the phone book by clicking on them.

To remove phone numbers while the dial is in progress, simply remove the
highlight from the numbers you no longer wish to dial.

When a connection is made with another computer, the dial process will stop and
the terminal will be brought to the foreground.


ΓòÉΓòÉΓòÉ 4.2.4. Select entries ΓòÉΓòÉΓòÉ

Select entries



There are three selection methods: select all, deselect all, or select by pattern.

Select all turns on the highlight for all service entries in the phone book.

Deselect all turns off the highlight for all service entries in the phone book.

Select by pattern allows you to type a partial or full name of the service
entries to select. Typing DATA would select all entries containing DATA, for
example DataMirage Software.


ΓòÉΓòÉΓòÉ 4.2.5. Sort entries ΓòÉΓòÉΓòÉ

Sort entries



Sort allows you to sort service entries in to ways. By default, the phonebook
sorts by name in A-Z sequence. Sort will also sort by total calls, from
greatest to least.

The phone book does not automatically keep service entries sorted. To keep your
phone book sorted, you must use this sort option.


ΓòÉΓòÉΓòÉ 4.2.6. Delete entries ΓòÉΓòÉΓòÉ

Delete entries



This option can be used to delete one or more service entries.


ΓòÉΓòÉΓòÉ 4.2.7. Pre/Postfixes ΓòÉΓòÉΓòÉ

Pre/Postfixes



Frequently used dial strings can be represented as prefixes and postfixes. For
instance, area codes, calling card numbers, and international codes. This
feature allows you to associate a commonly used dial string with an uppercase
letter A through J.

For example, assigning the calling card sequence to the letter A:
171483744421129,,,,

Allows you to specify in the phone number field of a service entry as follows:
A7148562071

When dialed, the number expands to:
171483744421129,,,,7148562071

If you use the calling card number on more than one service entry, you save the
time and labor of inserting it into every phone number. Furthermore, if your
card number ever changes or you wish to forego using the calling card you can
simply change the value of A without editing any service entries.


ΓòÉΓòÉΓòÉ 4.2.8. Phone book settings ΓòÉΓòÉΓòÉ

Phone book settings


This settings page allows you to change phone book and dialer settings.

Select one of the following items for more information:

Seconds between dial attempts

Seconds to wait for connection

Inter-character pacing

Connect sound

Connect options


ΓòÉΓòÉΓòÉ 4.2.8.1. Seconds to wait for connection ΓòÉΓòÉΓòÉ

Seconds to wait for connection



This field represents the maximum number of seconds the dialer will wait after
a service is dialed. If the dialer receives no status information (busy,
connected, etc) in this period of time the dial attempt will be aborted.

Note:  The default for this value is 45. Some long distance, overseas, and
calling card services require more than 45 seconds to place a call. Increasing
this number in those circumstances is important.


ΓòÉΓòÉΓòÉ 4.2.8.2. Seconds between dial attempts ΓòÉΓòÉΓòÉ

Seconds between dial attempts



This field contains the number of seconds the dialer will wait before trying to
dial the next phone number in the service list.

By default, this value is 5. To increase the dialing rate, set this value to 0.


ΓòÉΓòÉΓòÉ 4.2.8.3. Inter-character pacing ΓòÉΓòÉΓòÉ

Inter-character pacing



This field sets the pause between characters sent to the modem during dial, in
milliseconds. This is an advanced setting, please do not change it unless you
suspect you know what you are doing.


ΓòÉΓòÉΓòÉ 4.2.8.4. Connect sound ΓòÉΓòÉΓòÉ

Connect sound



This option allows you to select the sound made when the dialer connects to
another computer. The sound can be turned off, played over the simple PC
speaker, or a digital WAV file can be played. If you wish to play a WAV file
you must specify the full path and filename of the WAV file.

When playing a WAV file, the volume of the sound can be changed by using the
circular volume control.


ΓòÉΓòÉΓòÉ 4.2.8.5. Connect options ΓòÉΓòÉΓòÉ

Connect options



Terminal to foreground
When checked, the LiveWire terminal window will be brought to the foreground
and given focus upon connection to another computer.

Close dial window
When checked, the dial dialog window will close automatically after connection.
When unchecked, the dial dialog window containing connection and dial
information will remain until closed manually.


ΓòÉΓòÉΓòÉ 4.2.9. Importing other phone books ΓòÉΓòÉΓòÉ

Importing other phone books

LiveWire's phone book object will read the phone book formats of several other
OS/2 and DOS communications packages. In order to import a phone book, you must
know the file the phone book is kept in. For example, Qmodem phone books are
kept in the file QMODEM.FON and Procomm phone books are kept in the file PCPLUS.DIR.

Once you locate your old phone book file, LiveWire will automatically determine
the phone book type and will automatically convert the information into native format.

Unfortunately, LiveWire cannot always convert all information. For example,
scripts will not be imported because they are in a different script language.

LiveWire supports the following phone book formats:

LiveWire 2.x (text mode)

ZOC 2.xx for OS/2

Procomm and Procomm+ for DOS

Qmodem 4.x, 5.x, 6.x, Pro, and for Windows 1.0

Telix for DOS 1.5x, 3.xx

Boyan for DOS

Note:  We are unable to import Procomm Plus for Windows phone books because
PC+/WIN encrypts their phone books for the sole purpose of keeping other
programs from reading them. After we contacted DataStorm, makers of PC+, they
refused to release the phone book format. If you disagree with this closed
market approach, please call DataStorm's customer support line and register
your complaint.


ΓòÉΓòÉΓòÉ 4.3. Log object ΓòÉΓòÉΓòÉ

Log object

The log object keeps a running log of all operations performed during a
communications session. Information such as connect times and dates and files
transferred appears in this log.

The log is off by default. To turn the log on, open its settings notebook and
check the Keep Activity Log check box.


ΓòÉΓòÉΓòÉ 5. LiveWire Settings Notebook ΓòÉΓòÉΓòÉ

LiveWire/WPS Settings Notebook

For help, select a page in the settings notebook:

Port Settings

Terminal Settings

Macro Settings

Scroll Back Settings

Protocol Settings

Modem Settings

Translate Settings

Path Settings


ΓòÉΓòÉΓòÉ 5.1. Port Settings ΓòÉΓòÉΓòÉ



This settings page allows you to change physical communications port settings.


Select one of the following items for more information:
Communications Device
Named Pipe
Data Bits
Stop Bits
Parity
Flow Control
Speed
Lock Speed
Ignore Carrier Signal


ΓòÉΓòÉΓòÉ 5.1.1. Communications Device ΓòÉΓòÉΓòÉ


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. Guessing which communications port number is correct will do no
harm.

If you are using a named pipe for communication, the device must be set to
Named Pipe, which appears after COM8. In addition, you should set the correct
pipe name.


ΓòÉΓòÉΓòÉ 5.1.2. Named Pipe ΓòÉΓòÉΓòÉ


If you are attempting to connect to a named pipe server, you must set this
field to a pipe name. All pipe names begin with \PIPE\ and end in the remote
computer name and remote pipe name.

Note:  Before you can use a named pipe, the communications device must be set
to Named Pipe.


ΓòÉΓòÉΓòÉ 5.1.3. Data Bits ΓòÉΓòÉΓòÉ


This option sets the data bit width to 7 or 8. IBM PC systems use 8 bits to
communicate. Older hardware, mainframes, and some online services (such as
CompUServe) require 7 bits. 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.


ΓòÉΓòÉΓòÉ 5.1.4. Stop Bits ΓòÉΓòÉΓòÉ


This option sets the number of stop bits to either 1 or 2. Stopbits are extra
bits at the end of each character that mark the end of that character. Most
computer systems require 1 stop bit, although some older systems require 2.


ΓòÉΓòÉΓòÉ 5.1.5. Parity ΓòÉΓòÉΓòÉ


This option sets the parity bit 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 detection
LiveWire supports: None, Even, or Odd. Unfortunately, even if an error is
detected in this manner, there is no way to correct it. Note that error means
garbled text produced from static or other noise on the phone line.


ΓòÉΓòÉΓòÉ 5.1.6. Flow Control ΓòÉΓòÉΓòÉ


XON/XOFF flow control


When checked this option turns on the XOFF/XON flow control protocol. 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 causes
transmission to resume. This is used when the computer is receiving information
too quickly to be processed.


RTS/CTS flow control


When checked this option turns on the RTS/CTS flow control protocol. The
RTS/CTS protocol serves the same purpose as XON/XOFF flow control, but is more
effective and more widely used in the PC world. Flow control is managed by the
hardware at the UART level instead of sending commands. This option should
remain on for most modems, especially high speed modems. Without RTS/CTS flow
control you may loose large chunks of information while communicating at high speeds.


ΓòÉΓòÉΓòÉ 5.1.7. Speed ΓòÉΓòÉΓòÉ

This option sets the speed of the connection. Speeds exceeding 57,600 bps
require a special communications driver such as the shareware driver called
SIO, written by Ray Gwinn.


ΓòÉΓòÉΓòÉ 5.1.8. Lock Speed ΓòÉΓòÉΓòÉ

When checked this option ensures that the connection speed does not change when
the dialer connects to a new system. The recommended setting for this option is
checked (ON) for high speed (9600+) modems that use error correction


ΓòÉΓòÉΓòÉ 5.1.9. Ignore Carrier ΓòÉΓòÉΓòÉ

Selecting this option makes LiveWire/WPS ignore the status of the carrier
signal. The carrier signal is a signal sent by the modem to the computer to
inform the computer that a connection is present. If this signal is suddenly
dropped, LiveWire/WPS realizes that no connection exists anymore and stops its
current operation. Turning this option on causes LiveWire/WPS to ignore the
state of the carrier signal when uploading and downloading, for example. This
is useful if you have a direct connection or your modem does not properly set
the carrier signal.


ΓòÉΓòÉΓòÉ 5.2. Terminal Settings ΓòÉΓòÉΓòÉ


This settings page allows you to change terminal emulation settings.


Select one of the following items for more information:

Terminal Emulation

Setup Emulation

Terminal Settings

Terminal Font and Size


ΓòÉΓòÉΓòÉ 5.2.1. Terminal Emulation ΓòÉΓòÉΓòÉ

Selecting an item in this listbox sets the current terminal LiveWire will
emulate. LiveWire supports five emulations:

TTY
Selecting this option will make LiveWire emulate a simple TTY (TeleTYpe)
device. TTY emulation is a plain vanilla emulation.

ANSI
Selecting this option will make LiveWire emulate the ANSI emulation. LiveWire's
ANSI is a subset of the ISO's ANSI specification for terminals. Most bulletin
boards and online services use the ANSI emulation.

RIPTerm
Selecting this option will make LiveWire emulate RIPTerm 1.54. RIPScrip, a
specification created by Telegrafix, is a fully graphical emulation that allows
EGA-resolution graphics to be transferred efficiently over a modem line. Many
bulletin board services support this exciting emulation.

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.

0+ AVATAR
Selecting this option will make LiveWire emulate the Avatar 0+ specification.
This emulation, used widely on bulletin boards, can in increase the speed of
multi-attributed text displays considerably.

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 text mode programs remotely --
over a network or over a modem. OS2You emulation is a modified ANSI emulation
that treats the keyboard differently. Instead of LiveWire interpreting ALT,
SHIFT, and Fkey combinations, these combinations are sent to the remote
program. This allows you to use special function keys remotely.

Note:  The special key combination ALT-= (ALT-EQUAL) causes the OS2You services
menu to appear.


ΓòÉΓòÉΓòÉ 5.2.2. Setup Emulation ΓòÉΓòÉΓòÉ

Selecting this option allows you to change the settings for the currently
selected emulation.


VT-102 settings
Backspace is DEL
If Backspace=DEL is on then the backspace key always sends a DEL character
(0x7f) instead of the normal backspace (0x8) character.

Destructive Backspace
If destructive backspace is on then backspace erases characters as it moves
back one position. By default in VT-102 emulation, backspaces are NOT
destructive.

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 through F4, but they can also be mapped to Shift, Alt, or Ctrl F1
through F4.

Keypad
This option sets the current keypad mode. If the mode is Numeric, the keypad
sends actual numbers as the keys on the keypad are pressed. If this mode is
Application, special escape sequences are sent to the remote computer.

Cursor Keys
Specifies the mode in which the cursor keys (arrow keys) operate. Either
Application or Normal mode may be selected. Cursor keys always send special
escape command sequences in VT-102.

Answer Back
This setting indicates whether LiveWire should respond to the ENQuiry character
by sending the answerback message.

Scroll End of Line
This option controls whether or not VT-102 automatically scrolls when its
output reaches the last column (the rightmost edge) of 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 or cursor 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 the value must be increased.


ΓòÉΓòÉΓòÉ 5.2.3. Terminal Settings ΓòÉΓòÉΓòÉ

These are general options which affect terminal operation.


Echo Keystrokes
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. Instead, it relies upon 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 this option on.

Add Linefeeds
When on, this option causes LiveWire to add linefeeds to every incoming
carriage return. Normally, the modem or 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 on the linefeeds.

Status Line
This option turns the status line on the title bar of the terminal on or off.

Backspace is DEL
When on this option makes LiveWire send a DEL character when the Backspace key
is pressed. Many services and remote hosts use DEL instead of a backspace
character. If your backspace key is not working, try turning this option on.

Toolbar
This option turns the toolbar above the terminal window on or off.


ΓòÉΓòÉΓòÉ 5.2.4. Terminal Font and Size ΓòÉΓòÉΓòÉ


This option allows you to select both the font size and the terminal window
dimensions.

To select a font size, choose one of the fonts from the drop-down list box. As
soon as a font is selected in this list box the terminal window's font will be
updated.

To select terminal dimensions, select a new width and height in the drop-down
list boxes. The default terminal dimension is 80x25 (80 characters wide and 25
lines tall).


ΓòÉΓòÉΓòÉ 5.3. Macro Settings ΓòÉΓòÉΓòÉ



This settings page allows you to change macro (key combination) settings.

LiveWire allows you to customize key combinations such as the function keys and
Alt key combinations so they perform operations or automatically type commands
for you.


Select one of the following items for more information:

Key Definition

Macro Commands

UNDO last definition

Macro List


ΓòÉΓòÉΓòÉ 5.3.1. Key Definition ΓòÉΓòÉΓòÉ


This option lets you create or change the special operation of a key
combination.

To view a specific key combination's operation, select the key name from the
drop-down list box. When a key name is selected its current definition is
displayed in the entry field below. The entry field will be blank if no current
key operation is defined. You may also view key operations by scrolling through
the Macro List box.

To edit or add a specific key combination's operation, select the key name from
the drop-down list box, then edit the text in the entry field. Text entered
into this field will be sent over the modem when the key combination is
pressed.

Key combinations can be set to perform special operations when pressed. To do
this, select a command from the Macro Commands drop-down list box.


ΓòÉΓòÉΓòÉ 5.3.2. Macro Commands ΓòÉΓòÉΓòÉ

This list box contains a list of special operations (called macro commands)
that LiveWire understands. Selecting one of these special macro commands causes
the currently selected key to do the operation described.

For example, selecting "Hang up" in the Macro Commands list box causes the
current key combination to hang up the phone.

Macro command strings are inserted into the "Key definition" entry field and
are enclosed by curly braces. The Macro command string for hang-up is {HANGUP}.
This text is inserted directly into the entry field.

Removing special operations for a key entails removing the Macro command string
entered into the entry field.


ΓòÉΓòÉΓòÉ 5.3.3. UNDO last definition ΓòÉΓòÉΓòÉ

Clicking on this button undoes the last key definition. This essentially means
that the text in the Key Definition entry field is changed back to what it was
before it was edited.


ΓòÉΓòÉΓòÉ 5.3.4. Macro List ΓòÉΓòÉΓòÉ

The Macro List contains a list of all key combinations that have a special
operation or send text over the modem

The Macro List is quick way to select and change a key combination. Selecting
an item in the Macro List causes the key name and key definition to appear
above. The key definition for that key can then be edited.

The following macro commands are recognized by LiveWire:

{BREAK}

Send break signal.

{CAPTURE}

Toggles capture on and off.

{CLRSCR}

Clear screen.

{CONFIG}

Open settings notebook.

{DIALER}

Open phone book.

{DOWNLOAD}

Begin receiving files.

{EDITFILE}

Open file editor.

{EXIT}

Exit LiveWire.

{FULLSCREEN}

Switch to full screen text mode.

{HANGUP}

Hang-up phone line.

{HELP}

Request online help.

{PASSWORD}

Send password from the phone book.

{SHELL}

Open OS/2 command shell.

{UPLOAD}

Begin sending files.

{USERNAME}

Send username from the phone book.


ΓòÉΓòÉΓòÉ 5.4. Scroll Back Settings ΓòÉΓòÉΓòÉ


This settings page allows you to setup and change scroll back viewer settings.


Select one of the following items for more information:

Scroll Back On/Off

Quote Line Preface


ΓòÉΓòÉΓòÉ 5.4.1. Scroll Back On/Off ΓòÉΓòÉΓòÉ


This option turns scroll back recording on or off. Turning scroll back
recording off will save memory.


ΓòÉΓòÉΓòÉ 5.4.2. Quote Line Preface ΓòÉΓòÉΓòÉ

This option sets the character(s) preceding each line quoted from the scroll
back viewer. By default, this option is set to an arrow (">").

Quoting is the process of sending a portion text in the the scroll back viewer
back over the modem. To indicate that the text has been quoted from another
source, each line is prefaced with a quote character or characters.


ΓòÉΓòÉΓòÉ 5.5. Protocol Settings ΓòÉΓòÉΓòÉ

This settings page allows you to setup and change file transfer protocol
settings.


Select one of the following items for more information:

Edit

Add

Delete

Auto-Find

Extended Setup for Zmodem-32 Batch

Extended Setup for ASCII


ΓòÉΓòÉΓòÉ 5.5.1. Edit ΓòÉΓòÉΓòÉ

This option allows you to change a protocol's settings.

To edit a protocol, select a protocol from the list and click the Edit button.

Any of the following options may be changed:

Protocol name

Name by which the protocol will be known to LiveWire.

Prompt for filename on download

If this check-box is checked, LiveWire will prompt the user for a filename to
download to. This is an important feature for non-batch protocols such as
Xmodem. Batch protocols such as Zmodem obtains the download filename from the
sending computer automatically. Therefore, Zmodem does not require that the
user enter a filename when receiving a file.

Auto-receive string

Entering a string into this field will cause LiveWire to start a download using
this protocol when the string is received. To enter un-typable ASCII characters
you should hold down the ALT key, then type the ASCII code into the keypad,
then let go of the ALT key.

Receive command

This option allows you to change the OS/2 command required to run an external
protocol to receive a file. You must read the manual that comes with the
external protocol for more information about which command and parameters to
use. The characters %0, %1, %2, and %3 have special meaning in this field. %0
will be replaced with the active port number when the protocol is run. %1 will
be replaced with the modem speed. %2 will be replaced with the filename or
path. %3 will be replaced with the file handle of the currently opened device.

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

This replacement is done automatically by LiveWire when the protocol is run.
All you must do is put the percent commands in the correct place.

Send command

This option allows you to change the OS/2 command required to run an external
protocol to send a file. This option is very similar to the Receive command
option above.


ΓòÉΓòÉΓòÉ 5.5.2. Add ΓòÉΓòÉΓòÉ

This option allows you to add a new external protocol.

This option is identical to the Edit Protocol option.


ΓòÉΓòÉΓòÉ 5.5.3. Delete ΓòÉΓòÉΓòÉ

This option allows you to delete a protocol. To do this, first select a
protocol from the list and then press the Delete button.


ΓòÉΓòÉΓòÉ 5.5.4. Auto-Find ΓòÉΓòÉΓòÉ

Pressing this button will cause LiveWire to search your hard drive for known
external protocols. If LiveWire finds a protocol it knows how to handle, it
will automatically install the protocol into the protocol list.

The following are external protocols supported automatically by LiveWire:

M2Zmodem

CKermit

CKoker32

Clink

Cexyz

P


ΓòÉΓòÉΓòÉ 5.5.5. Extended Setup for Zmodem-32 Batch ΓòÉΓòÉΓòÉ

This option allows you to change options for the internal Zmodem-32 batch
protocol.

Auto-download

Toggles Zmodem auto-download on or off. When Zmodem auto-download 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 checking
is off, Zmodem uses 16-bit CRC error checking.

Rename files if FAT

Toggles long filename renaming on FAT file systems. 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 a 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 to resume the file
transfer. If the file transfer cannot be resumed, the file is renamed.

Rename formula

This field specifies how incoming files will be renamed. By default, the last
two letters of a file's extension are 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 will be
added to the file. In addition, there are embedded codes which begin with a
percent sign (%):

  %f

 Name of the file being received, excluding extension.

  %e

 Extension of the file being received.

  %w

 Whole name (name and extension) of the 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".

  %w;%n

 Translates filename "LW22.ZIP" into "LW22.ZIP;1".

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

Toggles whether or not Zmodem attempts to resume a download. If this options 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 of an existing file IF
the existing file is smaller than the file being received. If this option is
set to Ask, LiveWire will ask the user before resuming any file.


ΓòÉΓòÉΓòÉ 5.5.6. Extended Setup for ASCII ΓòÉΓòÉΓòÉ


This option allows you to change options for the ASCII protocol.

Strip Linefeed

Toggles linefeed stripping.

Strip Carriage-return

Toggles carriage return stripping.

CR -> CR/LF

Toggles carriage return conversion to carriage return followed by line feed.

LF -> CR/LF

Toggles linefeed conversion to carriage return followed by line feed.

Expand blank lines

If this option is checked, empty lines are expanded so as to contain a single
space. This is to avoid an empty line condition, which stops some editors.

Line pacing

Sets the delay after a CR or LF, in milliseconds.

Character pacing

Sets the delay between characters, in milliseconds


ΓòÉΓòÉΓòÉ 5.6. Modem Settings ΓòÉΓòÉΓòÉ

This settings page allows you to change modem specific settings.


Modem type

This option allows you to automatically setup your modem if it is one of the
modems contained in LiveWire's modem database.

To setup your modem, look through the drop down list box and select a modem
that is closest to your modem brand and model. If your modem is not in the
list, select "Other, not listed."

After a modem has been selected, you may be asked if LiveWire should
permanently modify the modem's nonvolatile configuration parameters.

Modem Initialization

This option allows you to change the modem initialization which is sent to the
modem every time you start LiveWire.

Here are some of the 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, etc)
S7=60   Set dial timeout to 60
X3    1200 baud busy signal/no dial tone checking
X4    2400 baud busy signal/dial tone checking
&C1    Return correct online/offline status

There are many more commands the modem understands. 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. The modem manual should have a list and description of all
supported modem commands.

Modem Dial Prefix

This option allows you to change the dial command prefix. This is the command
required to initiate a dial. It is set to be ATDT by default, which means
"ATtention, Dial Tone." If you have a pulse (rotary) phone, change this to
ATDP, which stands for "ATtention, Dial Pulse."

Modem Dial Postfix

This option allows you to change the dial command postfix. Normally, this is
just the ENTER key, which will cause the modem to begin dialing. The ENTER key
is denoted by its control character ^M (Control-M).

Modem Hang-up Command

Selecting this option allows you to change the hang-up command. The default
setting is the hang-up command for Hayes compatible modems. Note that before
sending the hang-up command, LiveWire lowers the DTR signal. This will make
many modems immediately hang up the phone. If the modem does hang up properly,
LiveWire does not send the hang-up command.

Connect Messages (on 2nd page)

This option allows you to tell LiveWire what messages your modem will return
when you have established a connection.

Additionally, there are four options for messages your modem may return to
indicate a connection failed (the phone was BUSY, or there was NO DIALTONE for
example).

The modem error message is the message your modem will return if there is an
internal modem error. Normally, this is just ERROR.


ΓòÉΓòÉΓòÉ 5.7. Translate Settings ΓòÉΓòÉΓòÉ


This settings page allows you to change ASCII translation table settings.


Select one of the following items for more information:

Input and Output Translate Tables

Setting Input and Output Values

View Type

Mirror Image


ΓòÉΓòÉΓòÉ 5.7.1. Input and Output Translate Tables ΓòÉΓòÉΓòÉ


These tables allow you to customize translations for single characters in the
incoming and outgoing data streams. These settings only affect visible data
such as text displayed on the screen and text pasted from the clipboard. These
settings do not affect transfer protocols, with the exception of the ASCII
upload protocol.

The ASCII table is a 256 character table that contains all possible characters.
Any character being received or sent can be re-mapped to any other character in
the ASCII table. The mapping of characters in the ASCII table is represented
by:

<MAPPED FROM> -> <MAPPED TO>

So that the following mapping means the character A is mapped to the character
Z:

A -> Z

There are sets of these mappings, the input translate table and the output
translate table. The former maps all characters being received, while the
latter maps all characters being sent.

For information on setting these mappings, see Setting Input and Output Values.


ΓòÉΓòÉΓòÉ 5.7.2. Setting Input and Output Values ΓòÉΓòÉΓòÉ


These options allow you to change the input and output mappings for the ASCII
character table. For more information, read the section Input and Output
Translate Tables.

To change an input or output mapping, first select the desired mapping in
either the input or output translate table. This will cause the currently
defined mapping to appear in the corresponding Input or Output field. To change
this mapping, edit the field, then click on the Set button immediately below
the field.

If the Mirror Image box is checked, both the output and input translate tables
will be updated with your mapping simultaneously.


ΓòÉΓòÉΓòÉ 5.7.3. View Type ΓòÉΓòÉΓòÉ

This option allows you to change the representation of the ASCII table for the
Input and Output Translate Tables.

Selecting Character will update the translate tables so they can be viewed and
edited as characters. Selecting Decimal will update the translate tables so
they can be viewed and edited as decimal numbers. Selecting Hex will update the
translate table so they can be viewed and updated as hexadecimal numbers.


ΓòÉΓòÉΓòÉ 5.7.4. Mirror Image ΓòÉΓòÉΓòÉ

If this option is on, the input and output translate tables are updated
simultaneously such that setting a mapping in one table will set the same
mapping in the other. If this option is off, only the desired table is
re-mapped.


ΓòÉΓòÉΓòÉ 5.8. Path Settings ΓòÉΓòÉΓòÉ

This settings page allows you to change file and path settings.


Select one of the following items for more information:

Editor Program

Download Path

Mail Path and Ext.

Upload Path

Script Path

Capture File

Object Information


ΓòÉΓòÉΓòÉ 5.8.1. Editor Program ΓòÉΓòÉΓòÉ

This option allows you to set the editor that will be invoked by LiveWire. By
default, this is set to the system editor.

IMPORTANT
The full path and editor program name (including .EXE extension) must be
entered.


ΓòÉΓòÉΓòÉ 5.8.2. Download Path ΓòÉΓòÉΓòÉ

This option allows you to change the default download directory.

To set this option, the directory must have already been created. If a shadow
to the download directory exists in the corresponding LiveWire Folder, its link
will be updated to the new directory.


ΓòÉΓòÉΓòÉ 5.8.3. Mail Path and Ext. ΓòÉΓòÉΓòÉ



The mail path option allows you to change the default mail directory. To set
this option, the directory must have already been created.  If a shadow to the
mail directory exists in the corresponding LiveWire Folder, its link will be
updated to the new directory.

The Ext. option allows you to specify which files get routed to the mail
directory.  By default, files ending in QW?, MO?, TU?, WE?, TH?, FR?, SA?, SU?
are placed in the mail directory. The format of the Ext. field is as follows:

QW?|MO?|TU?| . . .

Where there are three letters which specify the extension to be matched. A
question mark (?) represents any character. All three characters must be
present, and all must be separated by the pipe character (|).  Do not include a
period (.).


ΓòÉΓòÉΓòÉ 5.8.4. Upload Path ΓòÉΓòÉΓòÉ

This option allows you to change the default upload directory.

To set this option, the directory must have already been created. If a shadow
to the upload directory exists in the corresponding LiveWire Folder, its link
will be updated to the new directory.


ΓòÉΓòÉΓòÉ 5.8.5. Script Path ΓòÉΓòÉΓòÉ

This option allows you to change the default script directory.


ΓòÉΓòÉΓòÉ 5.8.6. Capture File ΓòÉΓòÉΓòÉ

This option allows you to change the default path and filename of the capture
file.

Changing this filename when the capture file is open will have no effect until
the capture file is closed and re-opened.


ΓòÉΓòÉΓòÉ 5.8.7. Object Information ΓòÉΓòÉΓòÉ

Object Information



This information aids in writing REXX scripts and other programs to manipulate
the LiveWire terminal.  The object path is the full path to the LiveWire
object. The HObject ID is unique 32-bit the hexadecimal number used by the
WorkPlace Shell to identify this object.


ΓòÉΓòÉΓòÉ 6. Scroll-back viewer ΓòÉΓòÉΓòÉ

Scroll-back viewer

Pressing the <Alt-Up Arrow> key combination brings up a window called the
scroll-back viewer. This window contains all information that has scrolled off
the screen in the current session. Scroll-back is useful for reviewing a
message or information that has since moved off the terminal window.

Once the scroll-back window is up, you may peruse through it using the scroll
bar or the up and down arrow, home, and end keys. Pressing ESC closes the
window and returns you to the terminal window.

You can select one or more lines at a time by pushing the first mouse button
and dragging the mouse over the lines to be selected. Once selected you can
export, copy, and quote the selected text. The selected lines can be deselected
by clicking once with the first mouse button in the scroll-back window.

Clicking with the second mouse button on the scroll-back window brings up a
context-sensitive menu with a number of extra functions.


Clear All
Clears the entire scroll-back contents.

Find Text
Allows you to search for text from the current screen either in the forward or
backward direction. Be default, the search is performed backwards. The search
is always case insensitive.

When the desired string is found it is highlighted in red. To find another
occurrence of the string, press the Find Next button.

Export to editor
Selecting this option causes the currently selected text (or if none is
selected, all text) to be brought up in the editor configured in the Path
Settings page of the terminal object's notebook. After editing the scroll-back
text, it can be saved to disk.

Save to disk
Selecting this option causes the currently  selected text (or if none is
selected, all text) to be saved to a file.

Copy to clipboard
Selecting this option causes the currently  selected text (or if none is
selected, all text) to be copied into the system clipboard. Once in the
clipboard, it can be pasted into any other application as text.

Quote selected
Selecting this option causes the currently  selected text (or if none is
selected, all text) to be quoted.  Quoting text means that the text is send
over the modem as if it were typed in directly. In addition, the quote
character is prepended to each line. By default the quote character is >, but
can be changed in the Scroll Back Settings notebook page of the terminal object.





ΓòÉΓòÉΓòÉ 7. File transfers ΓòÉΓòÉΓòÉ

File Transfers

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 introduced into the data. In order to
transfer files these errors must be corrected or the transferred files will be wrong.

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.

For more information select one of the following:

Sample download session

Sample upload session

Using TAP


ΓòÉΓòÉΓòÉ 7.1. Sample download session ΓòÉΓòÉΓòÉ

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, file the filename or filenames you want on the remote computer.

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 the remote computer.

The remote computer will ask you which files you want to download. Type in the
filenames you wish to receive and tell the remote to begin 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
PageDown key (for Download) and select the Ymodem protocol from the drop down
list box. Pressing OK begins the transfer.



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, then press
ENTER. At this point the download will begin.

During the file transfer a status window should appear containing statistics
about the file transfer. To abort the transfer, press the Cancel button. To
save CPU by skipping statistics, press the Save CPU button.

When the file transfer is completed the window will disappear and a bell will sound.


ΓòÉΓòÉΓòÉ 7.2. Sample upload session ΓòÉΓòÉΓòÉ

Sample upload session



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

First, tell your remote system that you wish to send a file. Usually this is
done by telling it you want to being an 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 for the remote computer.

When the remote end tells you to begin uploading, press PageUp (for Upload). A
list of protocols will appear for you to choose from. Choose the protocol that
matches the one you selected for the remote computer, then press OK.

Once a protocol has been selected you will be prompted to select one or more
files to send. If the protocol is Xmodem, Xmodem CRC, or Xmodem-1K you can only
send one file. If the protocol is Zmodem or Ymodem you may select as many files
as you wish. After selecting files, the following window will appear listing
the files you have selected:



To add more files, click on the Add File(s) button. To delete files, click on
the Delete Files button. To begin your transfer, click on the Transfer button.

During the file transfer a status window should appear containing statistics
about the file transfer. To abort the transfer, press the Cancel button. To
save CPU by skipping statistics, press the Save CPU button.

When the file transfer is completed the window will disappear and a bell will sound.


ΓòÉΓòÉΓòÉ 7.3. Using TAP ΓòÉΓòÉΓòÉ

Using TAP



TAP allows external programs to read data while it is being transferred over
the modem.

One example of a TAP compliant program is the Shareware image viewer called
PMView. During PMView installation, it registers itself as a TAP client
application.  PMView allows you to view many image formats such as GIF, JPG,
and PNG while they are still being received.

PMView is distributed and sold separately.  To obtain PMView ftp to
hobbes.nmsu.edu or download it from compuserve's OS2SHARE forum.

To start a TAP client program, press the TAP button during a file transfer. A
list of TAP client programs will be displayed. Select one TAP client and press
the Start button.  If the TAP client recognizes the format file being
transferred it will automatically and continuously display its contents.

If you wish to adapt your program to be TAP-enabled, a development kit with
full samples is provided with the LiveWire package. All source files are
available under the TAP directory. Please contact DataMirage Software for
development help.





ΓòÉΓòÉΓòÉ 8. REXX Control Panel ΓòÉΓòÉΓòÉ

Rexx Control Panel



The REXX Control Panel allows you manage scripts. REXX scripts can be recorded,
played, edited, deleted, and created.  To perform an action on a script, select
the desired script in the drop-down list of scripts, then select the desired option.

For information on specific options, select one of the following:

Rexx script listbox

Parameters

Stop

Play

Record

New

Edit

Delete

Other


ΓòÉΓòÉΓòÉ 8.1. Rexx Script listbox ΓòÉΓòÉΓòÉ

This listbox contains a list of scripts. Selecting one of the scripts from this
listbox makes it the current script.  Before playing or editing a script,
select the appropriate script from this listbox.


ΓòÉΓòÉΓòÉ 8.2. Parameters ΓòÉΓòÉΓòÉ

This field is a free-form parameter list to be passed to the script.  For
example, the host most script accepts the parameter "LOCAL" to indicate that
the host mode should work in local mode.


ΓòÉΓòÉΓòÉ 8.3. Stop ΓòÉΓòÉΓòÉ

Pressing this button stops a script that is currently being played or recorded.


ΓòÉΓòÉΓòÉ 8.4. Play ΓòÉΓòÉΓòÉ

Pressing this button plays the current script selected in the Rexx script listbox.


ΓòÉΓòÉΓòÉ 8.5. Record ΓòÉΓòÉΓòÉ

Pressing the record button begins recording a new script. All text typed into
the terminal will be recorded for later playback. When you are finished
recording, press the Stop button and you will be asked to name your script.


ΓòÉΓòÉΓòÉ 8.6. New ΓòÉΓòÉΓòÉ

Pressing this button creates a new script. You will be asked for a script name,
and the newly created script will be brought up in the default text editor.


ΓòÉΓòÉΓòÉ 8.7. Edit ΓòÉΓòÉΓòÉ

Pressing this button brings the current script selected in the script listbox
to be brought up in the default text editor.


ΓòÉΓòÉΓòÉ 8.8. Delete ΓòÉΓòÉΓòÉ

Pressing this button deletes the current script selected in the script listbox.


ΓòÉΓòÉΓòÉ 8.9. Other ΓòÉΓòÉΓòÉ

Pressing this button brings up a standard file open dialog window in which you
may find a REXX script by file name that may not be in the LiveWire script
listbox.  After you have selected a file in the dialog window, that file will
be added to the Rexx script listbox.


ΓòÉΓòÉΓòÉ 9. Using TELNET ΓòÉΓòÉΓòÉ

Using TELNET

Telnet is an internet protocol which allows you to connect to a remote
computer. In order to use Telnet, you must have the IBM Internet Connection
installed and you must be dialed into an  active SLIP or PPP connection.

To switch to the telnet protocol, open the terminal's settings notebook to the
Port Settings page.  Change the communications  device to TELNET (TCP/IP),
located after COM8 in the list.  The status line on the terminal window should
indicate that Telnet is active.

LiveWire accomplishes telnet by simulating a simple modem.  Typing standard
Hayes modem commands causes LiveWire to respond as a modem would. For example,
typing AT causes the modem simulator to return OK. Typing ATI displays the
following information:

ATI
TELNET Modem Simulation
Copyright 1995 DataMirage Software

To login to a remote computer, you must know either the internet host name or
internet address.

Internet hostname example:
clyde.ics.uci.edu

Internet address example:
128.100.142.101

You can connect to a  remote host in one of two ways.  First, you can type ATDT
<hostname> directly into the terminal and a connection should be established.
For example:

ATDT [e-mail]
CONNECT

Sun OS Unix (clyde.ics.uci.edu)

login: _

Second, you can enter the hostname directly into the phone book service entry
in the phone number field.  Dialing this number normally using the phone book
will cause the dialer to connect to the remote host.

If the remote host cannot answer or does not exist, LiveWire returns a BUSY signal.

When the remote host ends the connection, a NO CARRIER message is displayed.



ΓòÉΓòÉΓòÉ 10. Using Named Pipes ΓòÉΓòÉΓòÉ

Using 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 is said.

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, change your communications device to PIPE.
Second, 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>


LiveWire will attempt to connect to the named pipe. If the connection attempt
is unsuccessful the message "PORT NOT READY" or "PIPE CLOSED" 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 hang-up 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 hang-up 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.


ΓòÉΓòÉΓòÉ 11. Starting LiveWire from a REXX script ΓòÉΓòÉΓòÉ

Starting LiveWire from a REXX script

LiveWire, because of the object-oriented nature of the WorkPlace Shell, has no
primary executable (EXE) file.  This fact causes problems when other programs
wish to start or manipulate LiveWire for the Workplace Shell.

There are two solutions to the problem. The first, use the text mode version
which is in executable (EXE) form and can be started from the command line
easily. See the text mode documentation for more information about this.

The other solution is to use the LWRexx library, included with the LiveWire 3.0
package. This package allows you to open, close, and launch scripts from an
external REXX script.

To load the LWRexx library in a REXX script, include the following lines:

Call RxFuncAdd 'LWLoadFuncs', 'LWREXX', 'LWLoadFuncs'
Call LWLoadFuncs

Once these lines have executed, the following new commands are available:

LWOpenTerminal(hobject [, scriptfile]);
Opens the terminal object identified by the hobject parameter.  Optionally, an
additional parameter specifies the script filename to run.

LWCloseTerminal(hobject);
Closes the terminal object identified by the hobject parameter.

LWWaitTerminal(hobject);
Waits for the terminal object identified by the hobject parameter to close.  If
the terminal object is already closed, this function returns immediately.
Otherwise this function returns when the user or a script closes the terminal window.


What is an hobject??

Since there may be more than one LiveWire terminal object present on the system
at any time, the WorkPlace Shell assigns a unique 32-bit number to each object.
This object id, called the hobject,  never changes -- even after a reboot.

The hobject allows you to find an object on the system.  To determine the
hobject of a LiveWire terminal object, open its settings notebook and go to the
last page, Path Settings, and look at the object information.  Note that the
hobject is in hexadecimal.


ΓòÉΓòÉΓòÉ 12. Object parameters ΓòÉΓòÉΓòÉ

Object parameters

When creating a LiveWire object, either in Rexx or in C, there is a parameter
that allows you to set object parameters. The object parameters is a string of
the following format:

<setting>=<value>;<setting>=<value>; . . .

These values can also be set through the WinSetObjectData function. The
following settings values are supported for the LiveWire terminal object.

HUPLOAD
hObject of shadow to the Upload folder
HDOWNLOAD
hObject of shadow to the Download folder
PORT
Port this object will be connected to
SPEED
Port speed
PIPE
Pipe name
DATABITS
Number of data bits (7 or 8)
STOPBITS
Number of stop bits (1 or 2)
PARITY
Parity setting (NONE, EVEN, or ODD)
XONXOFF
Xon/Xoff flow control (ON or OFF)
RTSCTS
Rts/Cts flow control (ON or OFF)
BYPASS
Bypass the object setup screen
REXXOPEN
Open terminal, run REXX script specified
REXXCLOSE
Close terminal


ΓòÉΓòÉΓòÉ 13. Reporting bugs and suggestions ΓòÉΓòÉΓòÉ

Reporting bugs and suggestions

      DataMirage Software is committed to developing and delivering
      quality, bug-free software that meets your needs.

      We accept bugs and suggestions from via CompUServe,
      the internet, and our BBS. 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.

      Internet: [e-mail]
      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


ΓòÉΓòÉΓòÉ 14. Shareware License ΓòÉΓòÉΓòÉ

Registration and support

LiveWire Communications 3.0 for the Workplace Shell
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 this
software.

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


 There are two methods of registration:

 1. Basic registration is  $43.00
   Basic registration includes:
   - Your registration number
   - Support through the DataMirage BBS

 2. Complete registration is $73.00
   Complete registration is a shrink-wrapped package containing:
   - The latest version of LiveWire on 3.5" diskettes
   - Information on how to obtain support through DataMirage BBS
   - Complete printed user and script manuals


 One registration per individual using the program, please.
 As with all other software, you must purchase as one copy per person.


ΓòÉΓòÉΓòÉ 15. Registration Information (How to Purchase) ΓòÉΓòÉΓòÉ

Registration information (How to purchase)

 You can purchase LiveWire 3.0 now by calling:

 Office Solutions
 404 Termino Avenue
 Long Beach, CA 90814

 Orders: 310-439-5567
      800-897-APPS
 Fax:   [phone]


 There are two types of registration:
 1. Basic registration is  $43.00
   Basic registration includes:
   - Your registration number
   - Support through the DataMirage BBS

 2. Complete registration is $73.00
   Complete registration is a shrink-wrapped package containing:
   - The latest version of LiveWire on 3.5" diskettes
   - Information on how to obtain support through DataMirage BBS
   - Complete printed user and script manuals

 (+ Shipping costs)

 One registration per individual using the program, please.
 As with all other software, you must purchase one copy per person.