home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Professional
/
OS2PRO194.ISO
/
os2
/
com
/
utils
/
lw21
/
lw21.inf
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1993-12-16
|
108KB
|
3,393 lines
ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
LiveWire Communications Version 2.1
Professional Shareware Software
User Manual
&
Script Language Reference
Copyright 1990-1993 Les Novell
ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
Introduction
LiveWire Communications is the 32-bit, mult-threaded
text-basedtele-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 andconfigure,
especially for users familiar with other communications software. LiveWire also
has many features unavailable in other communicationsprograms. The following is
a list of major features incorporated in LiveWire 2.1.
o Full TTY, ANSI, OS2You, and VT-100 emulations
o REXX script language
o BPS rates up to 57,600 without loss of data
o High performance output in windowed and full screen
o Unlimited scroll-back buffer
o 80 preset modem configurations to choose from
o Internal public domain Zmodem-32
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
ΓòÉΓòÉΓòÉ 3. Installation ΓòÉΓòÉΓòÉ
Installation
To install LiveWire, first copy the source files from the
distribution diskette into a directory on your hard drive, for
example LWOS2. Then, change to that directory and drive and type
INSTALL.
Example:
C:\>mkdir LWOS2
C:\>A:
A:\>copy *.* C:\LWOS2
A:\>C:
C:\>cd LWOS2
C:\LWOS2>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. It will then
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.
ΓòÉΓòÉΓòÉ 4. Running LiveWire for the first time ΓòÉΓòÉΓòÉ
Running LiveWire for the first time
The first time LiveWire is started you will have to tell it a few
things about your computer setup. The first thing you must specify is
which communications port your 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. Press ENTER
when you've made your selection.
Next, LiveWire must know what type of modem you have in your
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 you own. If your modem is not listed,
choose "Other modem not listed." In this case, you may have to do
additional modem setup. Refer to your modem manual for more
information.
LiveWire now needs to know the highest speed your modem will
communicate at. If you have chosen a listed modem the correct speed
will be selected for you, simply press ENTER. If you selected "Other
modem not listed" you must set your modem speed according to your
modem manual. Make the speed selection by moving the highlight bar to
the correct speed and press ENTER.
LiveWire will now prompt you for a default color scheme. To select
the desired color scheme, use the arrow keys to move the highlight
bar to the color scheme you want and press ENTER. Colors can later be
customized.
You'll 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. If you want to emulate another
program's keyset then 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.
ΓòÉΓòÉΓòÉ 5. Configuration ΓòÉΓòÉΓòÉ
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 two options: "Port Configuration..." and "Modem Commands..." 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 yet 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
with which you can edit the option to your preference. When you are
done editing this option, press ENTER and the cursor will disappear.
Pressing the ESC key while not editing an item 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.
ΓòÉΓòÉΓòÉ 5.1. Modem ΓòÉΓòÉΓòÉ
Modem
Under this menu you can set up specific information concerning your
modem. The menu has two options. The first, Port Configuration, will
allow you to tell LiveWire your PC's hardware specific information
such as the communications port number and baud rate. The second,
Modem Commands, specifies your modem's commands and responses. Here
you can set what command initializes the modem, dials the modem, and
hangs it up. You can also specify what messages LiveWire will expect
the modem to respond with when it gets connected to another computer
or encounters a problem.
ΓòÉΓòÉΓòÉ 5.2. Port Configuration ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 5.3. Modem Commands ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 5.4. Defaults ΓòÉΓòÉΓòÉ
Defaults
Under this menu you can set up the default configuration of LiveWire.
Echo Keystrokes
Selecting this option turns LiveWire's echo (display) of
your 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.
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.
VGA 50 line mode
Selecting this option turns VGA 50 line mode on or off. If
you have a VGA 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.
Popup on connect
Turning this option on causes LiveWire's dialer to
interrupt your current program by switching to full screen
mode and notifying you when you have established a
connection.
Music
Turning this option off stops LiveWire from making sound.
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.
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.
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 previous lines for review.
scroll-back Quote
When you quoting a portion of the text from your scroll
back buffer you may want a character or characters to
precede each line of quoted text. This indicates to the
reader that the text he is reading has been quoted from
another source. By default this option is a single caret
(>).
Connect timeout
Selecting this option allows you to change the time
LiveWire will spendwaiting 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. NOTE: You may want to reduce this
number to 0 because all macros also adhere to this setting.
Therefore, sending macros will be slowed if this setting is
not 0.
ΓòÉΓòÉΓòÉ 5.5. Files ΓòÉΓòÉΓòÉ
Files
Under the file configuration menu you can set up file specifications and file
transfer protocols.
Editor
Selecting this option allows you to change the editor that
LiveWire uses to view and edit files. By default LiveWire
uses OS/2's system editor, E.
Transfer protocols...
This menu allows you to add external file transfer
protocols to LiveWire.
- auto-find protocols -
Selecting this option will make LiveWire
automatically look for and install external
protocols it knows about. LiveWire recognizes the
following protocols: M2Zmodem, ZedZap (Cexyz2),
SEALink, CKermit, Puma, MPt, Lynx, Jmodem,
Punter, Bimodem, and Super Zmodem. In addition,
LiveWire includes its own ASCII, message, Xmodem,
Xmodem CRC, and Xmodem-1k, and Zmodem internal
protocols. When searching for protocols, LiveWire
will search the current directory, then
.\PROTOCOL, then \PROTOCOL, and finally it will
search through all of the directories listed in
your OS/2 path environment variable. If any
protocols are found, they are added to the list
automatically.
Edit 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
protocolyou 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:\TMPARCS2
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:\TMPARCS2\READ.ME
This replacement is done automatically
by LiveWire, all you need to do is put
the percent commands in the correct
place.
Upload directory
Selecting this option will allow you to change which
directory uploads (files to be sent) can be found. Normally
this option is blank, allowing you to enter your own path
at the time of the upload. However, if you have a directory
where you keep all or most of the files you send, typing
the path here will save time.
Download Directory
Selecting this option will allow you to change which
directory downloads are sent to. Normally this option is
blank, allowing you to enter the path to send the download
on each download. Protocols that do not prompt you for a
download path (such as Zmodem) will automatically use the
download directory you specify.
Usage Log
Selecting this option will allow you to change the path and
file of LiveWire's usage log file. If this is left empty,
LiveWire will ask you to provide a log file when you turn
the usage log on.
Capture file
Selecting this option allows you to change the default path
and filename for the capture file.
Scroll back save
Selecting this option allows you to change the default path
and filename for scroll back save.
Screen Dump
Selecting this option allows you to change 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.
ΓòÉΓòÉΓòÉ 5.6. Colors ΓòÉΓòÉΓòÉ
Colors
Under this configuration menu you can set up all of the colors that LiveWire
uses. To do this, simply select one of the below. A color selection box, like
the one to the right, will appear. To change the color use the up and down
arrow keys to change the background color and the right left arrow keys to
change the foreground color. A sample of the color you've selected will appear.
When you have the desired color, press ENTER to finalize your decision.
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.
ΓòÉΓòÉΓòÉ 5.7. Keys ΓòÉΓòÉΓòÉ
Keys
Macros...
Selecting this option allows you to change LiveWire's
macros. 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.
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-100 emulation, F1-F4 keys are (by default) reserved for
PF keys.
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
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 printscreen)
{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 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 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.
ΓòÉΓòÉΓòÉ 5.8. Terminal Emulations ΓòÉΓòÉΓòÉ
Terminal Emulations
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 ALT-keys remotely. In addition,
pressing ALT-= (alt-equals, hex keycode 8300) causes the
OS2You services menu to appear.
VT-100
Selecting this option will make LiveWire emulate the DEC VT-100
terminal. DEC VT-100 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...
Currently this option only works if VT-100 is the current
emulation. The followings are customizable settings for the
VT-100 emulation. The default settings are those of a
VT-100 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 Defaultsconfiguration menu.
Destructive BS
If Destructive BS is true, then backspace erases characters
as it moves back one position. By default in VT-100
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-100.
PFKeys
Some programs which utilize VT-100 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-100 automatically
scrolls when its output reaches the last column (the
rightmost edge) on the screen.
Command pacing
This option controls the pacing, in miliseconds, between
each character when a VT-100 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...
This option allows you to edit the default VT-100 tab
settings. Pressing ENTER on this option will bring up a
window showing the current tab stops. 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-100
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.1."
Answerback This setting indicates
whether LiveWire should
respond to the ENQuiry and
send the Answerback message.
By default this is yes.
ΓòÉΓòÉΓòÉ 5.9. Exit config ΓòÉΓòÉΓòÉ
Exit
Pressing ESC while not in any configuration menu gets you to the Exit menu. To
return to configuration, press ESC again.
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.
ΓòÉΓòÉΓòÉ 6. The Terminal Mode ΓòÉΓòÉΓòÉ
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 dothis, because if either computer hangs up
the phone the modem will return to command mode automatically.
ΓòÉΓòÉΓòÉ 7. The Command Screen ΓòÉΓòÉΓòÉ
The Command Screen
LiveWire[Home]
Procomm+[Alt-Z]
Qmodem[Home]
Telix[Alt-Z]
Boyan[Ctrl-Home]
Universal[Ctrl-\]
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. Note that,
in any case, the command screen can be activated by pressing and
holding the Ctrl key, then hitting the back slash (\) key. 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
you
wish
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.
ΓòÉΓòÉΓòÉ 7.1. Phone book ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.2. Clear screen ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.3. Scroll back ΓòÉΓòÉΓòÉ
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 scrollback 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 occurence 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.
ΓòÉΓòÉΓòÉ 7.4. Capture ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.5. Dump screen ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.6. ANSI color ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.7. Hang-up ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.8. Exit ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.9. Configuration program ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.10. Port setup ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.11. Macros ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.12. X-late Tables ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.13. Config keys ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.14. Set Emulation ΓòÉΓòÉΓòÉ
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
informaton, see Terminal Emulations.
ΓòÉΓòÉΓòÉ 7.15. Run script ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.16. Learn script ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.17. Send files ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.18. Receive files ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.19. OS/2 shell ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.20. Change drive ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.21. Change dir ΓòÉΓòÉΓòÉ
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. This
directory selection method uses a tree-like representation of the
directories rather than typing a path. The first time this command is
run LiveWire will scan the disk to make the directory structure. This
may take some time.
The following keys will work in the directory changer:
ENTER - Select highlighted directory as the current
directory
Arrow keys - Move the highlight bar up or down the tree
INS - Create a directory under the highlighted
directory
DEL - Delete highlighted directory
While in the directory changer, you can use the up and down arrow
keys to move the highlight bar to the desired directory. The full
path is shown at the bottom of the window. Pressing ENTER selects
that directory as the current directory. Pressing the INS creates a
new directory. Pressing DEL will allow you to remove a directory.
ΓòÉΓòÉΓòÉ 7.22. Directory ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.23. View file ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.24. Send BREAK ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.25. Log ΓòÉΓòÉΓòÉ
Log
LiveWire[Alt-1]
Procomm+[Alt-F1]
Qmodem[Alt-0]
Telix[Alt-U]
Boyan[Alt-U]
This turns the useage 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.
ΓòÉΓòÉΓòÉ 7.26. Printer ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.27. Echo ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.28. Scroll-back ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.29. Xon/Xoff ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.30. Doorway ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.31. Status Line ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.32. Linefeeds ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.33. 50 lines ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.34. Backspace=DEL ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 8. The Phone Book ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 8.1. Entering a phone number ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 8.2. Loading another programs dialing directory ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 8.3. Dialing out ΓòÉΓòÉΓòÉ
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 redialing
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.
ΓòÉΓòÉΓòÉ 8.4. Marking entries to dial multiple phone numbers ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 8.5. Dialing commands ΓòÉΓòÉΓòÉ
Dialing commands
dial entry [ENTER]
The Start Dial command will start redialing either the entry the
highlight bar is on or, if there are marked entries, the marked
entries will be dialed. The dialer will continue redialing 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. Move the highlightbar 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 through 20.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 ifhe 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 LiveWire 2.1 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 the number 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. WARNING: It IS possible to
create recursive infinite loops using dialing codes. I don't suggest
it, though.
edit Comment file [C]
This command brings up the editor on the file specified in the Info
file field for the highlighted entry.
ΓòÉΓòÉΓòÉ 9. Transferring Files ΓòÉΓòÉΓòÉ
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 unuseable.
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:\LWOS2\LW21.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 you can only send one file. If the protocol is Zmodem or
Ymodem you may enter as many files as you wish. When you are finished
entering files you can begin thetransfer 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 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.
ΓòÉΓòÉΓòÉ 10. File Transfer Monitor ΓòÉΓòÉΓòÉ
File Transfer Monitor
Included in the LiveWire 2.1 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 montor, 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.
ΓòÉΓòÉΓòÉ 11. Named Pipes ΓòÉΓòÉΓòÉ
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 statusline
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 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.
ΓòÉΓòÉΓòÉ 12. REXX Scripting Functions ΓòÉΓòÉΓòÉ
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.1.
REXX extensions
REXX scripts are plain ASCII text, and must end with the .CMD
extension. LiveWire registers itself as a subcommand 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.
ΓòÉΓòÉΓòÉ 12.1. GetLW(attribute) ΓòÉΓòÉΓòÉ
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 "".
ΓòÉΓòÉΓòÉ 12.2. SetLW(attribute, attribute_value) ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.1. TimeOut ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.2. Echoback ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.3. FgColor ΓòÉΓòÉΓòÉ
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
ΓòÉΓòÉΓòÉ 12.2.4. BgColor ΓòÉΓòÉΓòÉ
BgColor
BgColor - represents the current local LiveWire background color.
May be set with the same values as above, except only the range from
1 to 7, inclusive, integer values only, will work. Note: Clearing
the screen after modifying background colors causes the entire screen
to immediately change to that background color.
ΓòÉΓòÉΓòÉ 12.2.5. CursorX ΓòÉΓòÉΓòÉ
CursorX
CursorX - the cursor X position, where X_Coordinate is an integer
value in the range 1 to 80, inclusive.
ΓòÉΓòÉΓòÉ 12.2.6. CursorY ΓòÉΓòÉΓòÉ
CursorY
CursorY - the cursor position, where Y_Coordinate is an integer value
in the range 1 to screen length, inclusive.
ΓòÉΓòÉΓòÉ 12.2.7. Online ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.8. CurrentDir ΓòÉΓòÉΓòÉ
CurrentDir
CurrentDir - represents the current directory.
Example: SetLW( CurrentDir, "C:\LiveWire\Info" );
ΓòÉΓòÉΓòÉ 12.2.9. CurrentDisk ΓòÉΓòÉΓòÉ
CurrentDisk
CurrentDisk - represents the current default disk drive.
Example: SetLW( CurrentDisk, "D:" );.
ΓòÉΓòÉΓòÉ 12.2.10. Emulation ΓòÉΓòÉΓòÉ
Emulation
Emulation - represents the current emulation.
Emulation values are as follows: 0=TTY, 1=ANSI-BBS, 2=OS2YOU,
3=VT-100.
Example: SetLW( Emulation, 1 );
This set the current emulation to ANSI-BBS.
ΓòÉΓòÉΓòÉ 12.2.11. Capture ΓòÉΓòÉΓòÉ
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.
Note: When used with GetLW, only returns 1 or 0.
Example: SetLW(Capture, ON);
ΓòÉΓòÉΓòÉ 12.2.12. CaptureFile ΓòÉΓòÉΓòÉ
CaptureFile
CaptureFile - represents the name of the current capture file.
ΓòÉΓòÉΓòÉ 12.2.13. LogFile ΓòÉΓòÉΓòÉ
LogFile
LogFile - represents the name of the current log file.
ΓòÉΓòÉΓòÉ 12.2.14. Log ΓòÉΓòÉΓòÉ
Log
Log - determines whether or not LiveWire's log feature is active.
ΓòÉΓòÉΓòÉ 12.2.15. Echo ΓòÉΓòÉΓòÉ
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);
ΓòÉΓòÉΓòÉ 12.2.16. Linefeeds ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.17. RtsCts ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.18. StatusLine ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.19. DoorWay ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.20. Printer ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.21. BSisDEL ΓòÉΓòÉΓòÉ
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 returns1 or 0.
ΓòÉΓòÉΓòÉ 12.2.22. PhoneFile ΓòÉΓòÉΓòÉ
PhoneFile
PhoneFile - represents the current phone directory file.
ΓòÉΓòÉΓòÉ 12.2.23. MacroFile ΓòÉΓòÉΓòÉ
MacroFile
MacroFile - represents the current macro file.
ΓòÉΓòÉΓòÉ 12.2.24. XlateFile ΓòÉΓòÉΓòÉ
XlateFile
XlateFile - represents the current translation table file.
ΓòÉΓòÉΓòÉ 12.2.25. Port ΓòÉΓòÉΓòÉ
Port
Port - represents the current communications port being used.
ΓòÉΓòÉΓòÉ 12.2.26. Speed ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.27. Parity ΓòÉΓòÉΓòÉ
Parity
Parity - represents the current parity checking in effect.
Parity values are as follows:
0=No Parity
1=Even Parity
2=Odd Parity
ΓòÉΓòÉΓòÉ 12.2.28. DataBits ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.29. StopBits ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.30. LockedPort ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.31. PipeName ΓòÉΓòÉΓòÉ
PipeName
PipeName - represents the name of the current named pipe.
ΓòÉΓòÉΓòÉ 12.2.32. XonXoff ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.33. IgnoreCarrier ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.34. ConnectPopup ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.35. Music ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.36. DialerOnStartup ΓòÉΓòÉΓòÉ
DialerOnStartup
DialerOnStartup - determines whether or not to dial a specified phone
directory entry immediately upon LiveWire startup.
ΓòÉΓòÉΓòÉ 12.2.37. ScrollBack ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.38. ConnectTimeout ΓòÉΓòÉΓòÉ
ConnectTimeout
ConnectTimeout - represents the maximum amount of time LiveWire will
wait to connect to each computer system dialed.
ΓòÉΓòÉΓòÉ 12.2.39. RedialWait ΓòÉΓòÉΓòÉ
RedialWait
RedialWait - represents the amount of time LiveWire will wait between
dialing attempts.
ΓòÉΓòÉΓòÉ 12.2.40. Pacing ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.41. Editor ΓòÉΓòÉΓòÉ
Editor
Editor - represents the full path of the current default LiveWire
text editor.
ΓòÉΓòÉΓòÉ 12.2.42. ULDir ΓòÉΓòÉΓòÉ
ULDir
ULDir - represents the directory where uploaded files will go. If
this value is "", then the upload directory is the current directory.
ΓòÉΓòÉΓòÉ 12.2.43. DLDir ΓòÉΓòÉΓòÉ
DLDir
DLDir - represents the directory where downloaded files will go. If
this value is "", then the download directory is the current
directory.
ΓòÉΓòÉΓòÉ 12.2.44. DumpFile ΓòÉΓòÉΓòÉ
DumpFile
DumpFile - represents current dump file name including path.
ΓòÉΓòÉΓòÉ 12.2.45. MacroFile ΓòÉΓòÉΓòÉ
MacroFile
MacroFile - represents the name of the current macro file including
path.
ΓòÉΓòÉΓòÉ 12.2.46. LocalOnly ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.47. DialerNumber ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.2.48. DialerName ΓòÉΓòÉΓòÉ
DialerName
DialerName - The name of the current entry in the dialing directory.
ΓòÉΓòÉΓòÉ 12.2.49. DialerPhoneNumber ΓòÉΓòÉΓòÉ
DialerPhoneNumber
DialerPhoneNumber - The number of the current entry in the dialing
directory.
ΓòÉΓòÉΓòÉ 12.2.50. DialerInfoFile ΓòÉΓòÉΓòÉ
DialerInfoFile
DialerInfoFile - The name of the comments/information file of the
current entry.
ΓòÉΓòÉΓòÉ 12.2.51. DialerScriptFile ΓòÉΓòÉΓòÉ
DialerScriptFile
DialerScriptFile - The name of the script file of the current entry.
ΓòÉΓòÉΓòÉ 12.2.52. DialerSpeed ΓòÉΓòÉΓòÉ
DialerSpeed
DialerSpeed - The communications speed of the current entry.
ΓòÉΓòÉΓòÉ 12.2.53. DialerParity ΓòÉΓòÉΓòÉ
DialerParity
DialerParity - The parity of the current entry. (N, E, or O)
ΓòÉΓòÉΓòÉ 12.2.54. DialerBits ΓòÉΓòÉΓòÉ
DialerBits
DialerBits - The data bits of the current entry. (7 or 8)
ΓòÉΓòÉΓòÉ 12.2.55. DialerStop ΓòÉΓòÉΓòÉ
DialerStop
DialerStop - The stop bits of the current entry. (1 or 2)
ΓòÉΓòÉΓòÉ 12.2.56. DialerDuplex ΓòÉΓòÉΓòÉ
DialerDuplex
DialerDuplex - The duplex of the current entry. (F=Full, H=Half)
ΓòÉΓòÉΓòÉ 12.2.57. DialerPassword ΓòÉΓòÉΓòÉ
DialerPassword
DialerPassword - The password of the current entry.
ΓòÉΓòÉΓòÉ 12.2.58. DialerProtocol ΓòÉΓòÉΓòÉ
DialerProtocol
DialerProtocol - The hotkey (highlighted character in the menu) of
the protocol of the current entry. (EG: Zmodem is Z, Xmodem-1K is 1)
ΓòÉΓòÉΓòÉ 12.2.59. DialerEmulation ΓòÉΓòÉΓòÉ
DialerEmulation
DialerEmulation - The emulation of the current entry.
ΓòÉΓòÉΓòÉ 12.2.60. DialerLastCall ΓòÉΓòÉΓòÉ
DialerLastCall
DialerLastCall - The date of the last call of the current entry.
ΓòÉΓòÉΓòÉ 12.2.61. DialerTotalCalls ΓòÉΓòÉΓòÉ
DialerTotalCalls
DialerTotalCalls - The number of total calls to the current entry.
ΓòÉΓòÉΓòÉ 12.3. DispLW(string) ΓòÉΓòÉΓòÉ
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 cariage return immediately followed by a line feed.
Example:
DispLW("This will display a string and drop down to the next
line^M^J");
ΓòÉΓòÉΓòÉ 12.4. SendLW(string) ΓòÉΓòÉΓòÉ
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 cariage return immediately followed by a line feed.
Example:
DispLW("This will send a string to the modem and press [ENTER]^M");
ΓòÉΓòÉΓòÉ 12.5. DiseLW(string) ΓòÉΓòÉΓòÉ
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 cariage 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");
ΓòÉΓòÉΓòÉ 12.6. FindLW(string, string, ) ΓòÉΓòÉΓòÉ
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 cariage return immediately followed by a
line feed.
ΓòÉΓòÉΓòÉ 12.7. GetKeyLW() ΓòÉΓòÉΓòÉ
GetKeyLW()
GetKeyLW() - returns a single keystroke of input from either the
local end or remote computer.
ΓòÉΓòÉΓòÉ 12.8. GetKeyLocalLW() ΓòÉΓòÉΓòÉ
GetKeyLocalLW()
GetKeyLocalLW() - returns a singe keystroke of input from the local
end of LiveWire.
ΓòÉΓòÉΓòÉ 12.9. GetKeyRemoteLW() ΓòÉΓòÉΓòÉ
GetKeyRemoteLW()
GetKeyRemoteLW( ) - returns a single keystroke of input from the
remote computer.
ΓòÉΓòÉΓòÉ 12.10. GetStrLW(string, maxlen) ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.11. GetStrLocalLW(string, maxlen) ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.12. GetStrRemoteLW(string, maxlen) ΓòÉΓòÉΓòÉ
GetStrRemoteLW(string, maxlen)
GetStrRemoteLW(string, maxlen) - similar to GetStrLW, except this
command only receives a string from the remote computer.
ΓòÉΓòÉΓòÉ 12.13. DialLW(markstring) ΓòÉΓòÉΓòÉ
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 is case
insensitive.
1,Data,5..20 Marks entry 1, all entries containing "Data", and
entries 5 through 20, inclusive.
ΓòÉΓòÉΓòÉ 12.14. ClrScrLW() ΓòÉΓòÉΓòÉ
ClrScrLW()
ClrScrLW() - clears the local screen.
ΓòÉΓòÉΓòÉ 12.15. SendBreakLW() ΓòÉΓòÉΓòÉ
SendBreakLW()
SendBreakLW() - sends a break signal over the modem for 1/4 of a
second.
ΓòÉΓòÉΓòÉ 12.16. SendFilesLW(protocol, filelist) ΓòÉΓòÉΓòÉ
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 files and their paths to send all in one
string.
ΓòÉΓòÉΓòÉ 12.17. ReceiveFilesLW(protocol, filelist) ΓòÉΓòÉΓòÉ
ReceiveFilesLW(protocol, filelist)
ReceiveFilesLW(protocol, filelist) - 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.
<filelist> is a list of files and their paths to send all in one
string. Received files are placed in the default download directory.
Batch protocols such as Zmodem and Ymodem ignore the <filelist>
parameter.
ΓòÉΓòÉΓòÉ 12.18. AnsiColorLW(fg, bg) ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.19. DumpScreenLW(filename) ΓòÉΓòÉΓòÉ
DumpScreenLW(filename)
DumpScreenLW(filename) - dumps the current screen to <filename>, the
specified dump file.
ΓòÉΓòÉΓòÉ 12.20. ExitLW() ΓòÉΓòÉΓòÉ
ExitLW()
ExitLW() - exits the LiveWire program.
ΓòÉΓòÉΓòÉ 12.21. DelayLW(ms) ΓòÉΓòÉΓòÉ
DelayLW(ms)
DelayLW(ms) - delays for <ms> milliseconds before resuming the
script.
ΓòÉΓòÉΓòÉ 12.22. SleepLW(seconds) ΓòÉΓòÉΓòÉ
SleepLW(seconds)
SleepLW(seconds) - sleeps (does nothing) for <seconds> amount of time
before resuming the script.
ΓòÉΓòÉΓòÉ 12.23. WaitTimeLW(hr, min) ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 12.24. HangUpLW() ΓòÉΓòÉΓòÉ
HangUpLW()
HangUpLW() - attempts to disconnect the current modem session.
ΓòÉΓòÉΓòÉ 13. Learning scripts ΓòÉΓòÉΓòÉ
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
ΓòÉΓòÉΓòÉ 13.1. Editing a learned script file ΓòÉΓòÉΓòÉ
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!
ΓòÉΓòÉΓòÉ 14. Host mode script ΓòÉΓòÉΓòÉ
Host mode script
LiveWire 2.1 includes a Host Mode REXX script. The host mode script
allows you to setup your computer to accept incoming calls. Callers
can then access your 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.
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. 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.
ΓòÉΓòÉΓòÉ 15. Reporting bugs and suggestions ΓòÉΓòÉΓòÉ
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 (accounts not necessarily held by DataMirage Software):
Internet submission : eaiu278@orion.oac.uci.edu
CompUServe submission: above internet address, or 73631,1233
PRODIGY submission : JWWJ64A
US Mail : 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
ΓòÉΓòÉΓòÉ 16. Registration and support ΓòÉΓòÉΓòÉ
Registration and support
LiveWire 2.1 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 discountinue 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 version of LiveWire. All
futureversions 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 home of LiveWire -- DataMirage Bulletin Board System.
By using this software you are agreeing to the above terms.
Basic registration is $30
That includes:
- Your registration number
- Support through the DataMirage BBS
Extended registration is $40
That includes:
- Your registration number
- A registered copy of the latest version of LiveWire
- Support through the DataMirage BBS
Complete registration is $60
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.1 release
to register, mail the registration blank on the following page to:
DataMirage Software585 Hyde Park Drive
San Jose, CA 95136
ΓòÉΓòÉΓòÉ 17. Registration form ΓòÉΓòÉΓòÉ
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
( ) $30 Basic Registration = registration #
( ) $40 Extended Registration = registration # + newest version
( ) $60 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. If you send a purchase
order, please make it clear where the invoice should be mailed. For
information onregistering with a credit card number, please call DataMirage
BBS at (714) 856-2071 where we hope to have an automated registration program.