home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
rtsi.com
/
2014.01.www.rtsi.com.tar
/
www.rtsi.com
/
OS9
/
MM1
/
TELECOM
/
linkup12.lzh
/
DOC
/
linkup.doc
< prev
next >
Wrap
Text File
|
1996-04-10
|
48KB
|
1,586 lines
LinkUp For K-Windows
Edition 12
REFERENCE MANUAL
Released April 12, 1996
April 1996 LinkUp Reference Manual Page 2
Foreword
LinkUp has its roots in a programming project I started
several years ago on the Tandy Color Computer 3 under Multi-Vue.
Tentatively named MVTerm, the program was never fully developed
due to the limitations of the CoCo 3. However, the source code
was easily portable to K-Windows, and provided me with a new
opportunity to enhance my original work.
As I began to develop LinkUp, I challenged myself to
exploit the K-Windows environment as much as possible. After
basic functionality was in place, I began to experiment with
more elaborate features such as icons, sound, and colors. The
scope of the project then changed to a quest for that "perfect"
introductory telecommunications program -- one which maintained
a balance between the aesthetic and the practical.
The result is a program which I feel excels in both user
friendliness and features. It is not intended to compete with
more capable K-Windows based communications programs on the
market; nonetheless, it is a testament that user-friendly OS-9
software is not an oxymoron, but a reality.
Acknowledgements
Many thanks go to the following people for their testing,
ideas and suggestions: Eric Crichlow, David Graham, Joel
Hegberg, James Jones, Tim Kientzle, Scott McGee, Colin McKay,
Jim Pruyne, Steve Wegert and Bob van der Poel. Thanks to Ken
Scales for the information he provided me on ANSI emulation.
Special thanks goes to Mike Haaland for allowing me to
include GPort with LinkUp, to Mark Griffith for giving me
permission to integrate his CompuServe B/B+ protocol routines
(which are not a part of this version of LinkUp for various
reasons), to Andrzej Kotanski for making his sound programs
available to the public domain, and to Tim Kientzle for his
permission to incorporate his excellent K, XY and Z programs
into LinkUp.
April 1996 LinkUp Reference Manual Page 3
Introduction
LinkUp is an easy to use communications program which
allows your K-Windows-based OS-9 system to connect to other
computers and information services around the world. It is
fully integrated with the K-Windows environment, giving you
access to all the resources that the windowing system provides.
LinkUp features:
o An easy to use, intuitive graphical user
interface
o Color ANSI emulation which allows you to
view color/animation screens found on many
bulletin board services
o VT-100, K-Windows, Wyse 50 and ADDS
emulation
o X/Y/ZModem and Kermit upload/download
support using Tim Kientzle's excellent
protocol programs.
o ZModem optional auto detection
o Phone Book for commonly used numbers
o Autodialer to monitor progress of dialing
o Fast and easy setup of modem parameters
using GPort
o User selectable fonts, color schemes and
digitized sound for a personalized look and
feel
o Eight (8) programmable keyboard macros
o Support for Hyper-Tech Software's DeskTop
resources, if available
To run LinkUp, you need an OS-9 based computer equipped with:
o K-Windows (Windio Edition #56 or greater)
o a modem (preferably Hayes compatible)
o at least 150K free memory
Installing LinkUp
If you are using a 68070 based MM/1, the script file
'install.68k' will do the necessary installation for your
system. If you have a 68340 based MM/1a, then use the file
April 1996 LinkUp Reference Manual Page 4
'install.cpu32'.
To start the installation process, insert the LinkUp disk
in your drive, and type the following (replacing /d0 with your
disk's device name, if necessary):
chd /d0; /d0/install.68k (68070 MM/1)
OR
chd /d0; /d0/install.cpu32 (68340 MM/1a)
As the files are copied, you can monitor the progress. Be
aware that the install script overwrites existing files of the
same name.
NOTE: /dd is the assumed target device inside of the
script.
Starting LinkUp
From DeskTop:
An AIF and icon file for LinkUp are provided. Once inside
DeskTop, navigate to the directory containing the AIF and double
click on the LinkUp icon with your left mouse button.
From the Keyboard:
At the command prompt, type:
linkup [ENTER]
Running LinkUp for the First Time
At startup, LinkUp looks for the configuration file
.linkupcfg in your home directory (if the HOME environment
variable isn't set, the current directory is the used). If the
file is not found, LinkUp will look in /DD/SYS for a file called
linkupcfg. If either file is found, LinkUp reads the contents
and sets parameters accordingly.
If no configuration file is found, LinkUp assumes that it
is being executed for the first time, and sets the modem
parameters to 2400 baud, 8 bits word size, no parity and 1 stop
bit with hardware and software flow control turned on. It then
creates a configuration file both the /DD/SYS directory and in
your home directory (see appendix B for a detailed look at the
configuration file).
Selecting a Modem Port
There are three ways of specifying a modem port for LinkUp
to use:
o Set the MODEM environment variable to your
modem's port.
e.g. setenv MODEM /t3
April 1996 LinkUp Reference Manual Page 5
o Use the -p option when running LinkUp from
the command line (this overrides the MODEM
environment variable).
e.g. linkup -p=/t3
o If the MODEM environment variable is not set
and there is no .linkupcfg file, LinkUp will
prompt you to make a selection from the
"Modem Ports" selection box. Move the mouse
pointer onto the port you wish to select and
click. If the port cannot be opened, you
have the option to choose another port or
exit the application.
NOTE: Both the MODEM environment variable
and the -p option will override the port
saved in the .linkupcfg file (the port you
last used).
April 1996 LinkUp Reference Manual Page 6
Getting Started
Once a connection to the port has been established, LinkUp
displays the 'About' box. To close the box, you may:
o click on the 'OK' button with the mouse,
o press the [ENTER] key, or
o press the [ALT]-O key combination
NOTE: Buttons that have an underscore in the
button name can always be activated by
depressing [ALT] and then typing the key of
the character which is underscored.
LinkUp utilizes "pull-down" menus aligned along the area
atop the application window (known as the "menu bar"). Moving
the mouse cursor to the menu name and clicking the left mouse
button causes that menu name's pull-down menu to appear.
Each pull-down menu has a given number of "options"
associated with it. Moving the mouse pointer over the option
causes an option to be "highlighted." To select a highlighted
option, click the left mouse button.
In addition to accessing options through the pull-down
menu, some options can be accessed through "hot keys." Options
that can be activated via hot keys have two characters on the
right side of the option name (a lowercase 'a' character and an
uppercase character).
The lowercase 'a' represents the [ALT] key, and the
uppercase character corresponds to the key that must be typed
while the [ALT] key is being held down (.e.g. the 'About' option
in the Files menu contains an 'aA', indicating that this option
can be called by holding down the [ALT] key and pressing the [A]
key)
Just below the menu bar is the title bar. The title bar
gives you at-a-glance information on:
o Baud rate
o Word size, Parity and Stop bits
o CTS/RTS Hardware handshaking status
o XON/XOFF Software handshaking status
o CAPTURE buffer status
The status of CTS/RTS, XON/XOFF and CAPTURE are shown only if
they are activated; if they are not shown, they are considered
off, or inactive.
Moving
Clicking on the double horizontal bar at the upper left
corner of the LinkUp window allows the application window to be
moved around on the screen or even to another screen.
Window Stacking
April 1996 LinkUp Reference Manual Page 7
The icon on the upper right hand corner of the LinkUp
window allows you to move the application window to the back or
front of a stack of windows.
Resizing
LinkUp also allows dynamic resizing of the application
window with the resize icon, found on the lower right hand
corner. When the application window is resized, any VT-100
scrolling regions are deactivated.
April 1996 LinkUp Reference Manual Page 8
LinkUp Menus
Here is a synopsis of each menu in LinkUp and its
associated options.
Files Menu
New Capture (ALT-N)
'New Capture' allows you to capture all incoming and
outgoing data into a file on your system. A dialog box appears
prompting you for a filename. Type the name of the file you
wish to send captured data to and press either [ENTER] or
[ALT]-[O], or click on the 'OK' button with the mouse. If the
file you specified does not already exist, CAPTURE appears
highlighted in the title bar, notifying you that all incoming
modem data is being captured to a file.
If the file exists, you will be notified with an error
box. Click the mouse button or press a key, and type in another
filename. To cancel, press either [ESC] or [ALT]-[C], or click
on the 'Cancel' button.
Open Capture (ALT-O)
'Open Capture' works much the same as 'New Capture', except
that it appends captured data to an existing file. A file
selection box appears, allowing you to navigate directories
until you have selected a file. Once a file is selected,
CAPTURE appears highlighted in the title bar, indicating that
capture mode is on.
TIP: Here's how you can navigate the file selection boxes in
LinkUp:
Keyboard
Up Arrow - Move up one file
Down Arrow - Move down one file
PgUp - Move up one page of filenames
PgDn - Move down one page of filenames
ESC - Dismiss the file selection box and abort
Mouse
Up Arrow - Move up one file
(slightly above moves up one page)
Down Arrow - Move down one file
(slightly below moves down one page)
<PARENT> - Move up one level in the directory tree
Filename - Select the file
Close Box - Dismiss the file selection box and abort
Close Capture
When you are finished capturing your data, you can close
the capture file by selecting this option. The highlighted
CAPTURE message then disappears from the title bar. If you exit
LinkUp while the capture file is open, it is automatically
April 1996 LinkUp Reference Manual Page 9
closed.
Change Folder (ALT-F)
Your default working directory is where transferred files
are referenced. To change your default directory to another
location, select this option. This directory pathlist will be
saved when you exit LinkUp.
The dialogue box shows your default working directory and
an input field. Type the name of the new directory you wish to
change to, then type [ENTER] (or [ALT]-[O]) or use the mouse and
click on the 'OK' button. This directory must be an absolute
pathlist (it must begin with a '/' character).
If you change your mind and wish to keep the default
working directory, type [ALT]-[C] or press [ESC], or click on
the 'Cancel' button.
NOTE: As you move around the file system in the file
selection box, the current working directory is
changed; therefore, your current may or may not be the
default working directory at the time you select this
option.
OS-9 Shell (ALT-K)
This option will open an overlay window and fork an OS-9
shell. If the SHELL environment variable is set, that shell
will be used; otherwise the command interpreter 'shell' is
used. When selected, the mouse cursor changes to a sleep icon,
and LinkUp waits until you exit the shell.
Pipe Command (ALT-I)
This option will ask you for a command line to execute.
The output of the command will then be piped back into LinkUp's
terminal area. This can be useful if you want to upload the
contents of a file or display the output of a command directly
into your communication session.
About LinkUp (ALT-A)
The 'About' box shows the LinkUp icon and copyright
information, as well as the current size of the terminal area
(in characters). To exit, press [ENTER] or [ALT]-[O], or click
on the 'OK' button with the mouse.
Quit (ALT-Q)
When you wish to quit LinkUp, you can select this option.
A dialogue box will appear to verify that you indeed want to
exit LinkUp. Move the mouse pointer to the 'OK' button and click
to exit. To exit using the keyboard, press the [ENTER] key, or
If you do not want to quit, move the mouse outside of the
'OK' button and click, or using the keyboard, press the [ESC]
April 1996 LinkUp Reference Manual Page 10
key. You will be returned to the terminal screen.
April 1996 LinkUp Reference Manual Page 11
Settings Menu
ANSI
This option allows LinkUp to interpret ANSI escape codes
found on many BBS and on-line services. In addition, ANSI color
and arrow keys are also supported. ANSI emulation is active
when a checkmark appears by the option.
NOTE: For notes on ANSI emulation, see appendix A.
VT-100
Using this option, LinkUp behaves like a VT-100 terminal
and the arrow keys produce their respective ANSI character
strings. A checkmark by this option indicates that it is
active.
NOTE: Most, but not all VT-100 features are emulated
by LinkUp. Specifically, the VT-100 keypad has not
been implemented. Scrolling regions have been
implemented, but when the LinkUp screen is resized,
any active scrolling regions become deactivated.
K-Windows
Use this option for native K-Windows emulation. Only a
subset of K-Windows features are supported (basic cursor
positioning and line manipulation). A checkmark by this option
indicates that it is active.
This emulation mode is also compatible with the Tandy Color
Computer 3/OS-9 Level II emulation codes.
NOTE: For notes on K-Windows emulation, see appendix
A.
Wyse 50
This option allows LinkUp to behave like a Wyse 50
terminal. Most Wyse 50 behaviors are emulated. A checkmark by
this option indicates that it is active.
ADDS
This option allows LinkUp to behave like an ADDS terminal.
Most ADDS capabilities are emulated. A checkmark by this option
indicates that it is active.
Events (ALT-E)
Events allow you to associate sounds with certain LinkUp
events. You may chose not to utilize events in LinkUp, or you
may only want specific events to trigger a sound.
Upon selecting this option, a dialogue box with eight text
areas appears. The first text area is the path to sound files
that you wish to use for events. All remaining boxes are
associated with the labeled event. LinkUp can play .WAV, .AU,
.IFF and .VOC sound files.
April 1996 LinkUp Reference Manual Page 12
To navigate inside the Event box, you can click on the area
where you wish to type, or use the down-arrow/TAB to move down
and up-arrow/SHIFT-TAB to move up a text box. To accept the
changes, click on the 'OK' button, else click on the 'Cancel'
button.
Events can be triggered:
o When LinkUp is started up
o When a modem connection is made (carrier goes high)
o When a file transfer is completed
o When a modem connection is dropped (carrier goes low)
o When a bell character is received from the modem
o When an alert box appears
o When the user exits LinkUp
Macros (ALT-J)
Macros allow you to store a string of up to 39 characters
that can be recalled by a keystroke. LinkUp has room for eight
(8) macros which are accessed via keys ALT-1 through ALT-8.
Upon selecting this option, a dialogue box with eight text
areas appears. To navigate inside the Macro box, you can click
on the area where you wish to type, or use the down-arrow/TAB to
move down and up-arrow/SHIFT-TAB to move up a text box. To
accept the changes, click on the 'OK' button, else click on the
'Cancel' button.
The string '' can be used inside of a macro. When the
macro is used, this string will be replaced by a carriage return
($0D) character.
ZModem Detect
If this option is on (as indicated by the checkmark), then
LinkUp will automatically invoke ZModem Send/Receive without the
need for user intervention.
7 Bit Mask
If you find that you are having problems with garbled
characters, this option may help alleviate the problem. The 7
bit mask removes the high order bit of each incoming character,
and ultimately defeats parity checking. Use it only if
necessary.
Sound
If this option is checkmarked, then sound events are
activated; otherwise, you will not hear any sound when an
associated event occurs.
NOTE: Performance degradation can occur if running
LinkUp from a floppy disk due to the necessary loading
of the sound file each time it is played. For best
performance, store the sounds on a hard drive or RAM
April 1996 LinkUp Reference Manual Page 13
disk. Enabling disk caching with Microware's
diskcache utility can also help improve load time.
April 1996 LinkUp Reference Manual Page 14
Modem Menu
Phone Book (ALT-P)
The Phone Book allows you to store up to 16 commonly used
phone numbers of computer systems and the modem parameters
required to connect to them. These numbers are stored in a file
in your home directory called .linkupdial (see appendix B for a
detailed look at the dial file).
Upon selecting this option, the Phone Book box appears. If
there are dial entries in the entry portion of the box, you may
select one by moving the mouse over the entry and clicking. A
second click on a highlighted entry will cause that entry to be
dialed. You can also use the up-arrow and down-arrow keys to
traverse the list, and the [ENTER] key to dial the highlighted
entry.
Along the left side of the box are four buttons:
Dial
If a dial entry is selected, it can be dialed by
clicking on this button. Once clicked upon, LinkUp
hangs up the modem if it is off-hook and attempts to
dial the number associated with the entry. If no
entry is selected, this button is inoperative.
The autodialer will appear and attempt to dial the
number, up to 'Retries' times, and waiting 'Wait time'
for each dial attempt before trying again. Status
messages are printed inside of the autodialer window
so you can monitor the progress of the call. To
cancel the dial, click on the 'Cancel' button (or type
[ALT]-[C] or [ESC]).
The [ALT]-D key combination can also be used to
call this option.
Insert
You may insert a new dial entry by clicking on
this button. A dialogue box will appear prompting you
for a name and a number. Terminal emulation, ZModem
detection, 7 bit masking and sound for the entry can
also be changed by clicking on the button box next to
the option. A checkmark indicates that the option is
turned on. No checkmark indicates that the option is
turned off.
At the lower right hand corner of the 'Settings' box
are the 'Wait time' and 'Retries' values. 'Wait time'
corresponds to the number of seconds to wait for a
connection, and 'Retries' determines the number of
attempts that will be made to call an entry before
LinkUp gives up. You can change the values of either
of these by clicking on the arrows provided.
Once the entry has been entered, click on the 'OK'
button (or press [ALT]-O) to accept the input as well
April 1996 LinkUp Reference Manual Page 15
as the current port parameters. If you wish to change
the serial port parameters for the entry, click on
the 'Port' button (or, using the keyboard, type
[ALT]-[P]) and GPort will appear, allowing you to
modify modem parameters for this entry. If you decide
to cancel your entry, click on the 'Cancel' button (or
press [ALT]-[C] or [ESC]).
The [ALT]-I key combination can also be used to
call this option.
TIP: Here's how you can navigate through the text
entry fields:
Keyboard
Left Arrow - Move cursor left
Right Arrow - Move cursor right
HOME - Move to the first character
END - Move past last character
DEL - Delete character under cursor
BACKSPACE - Delete character to left of cursor
CTRL-X - Erase entire field
Up Arrow - Move to previous field
Down Arrow - Move to next field
TAB - Move to next field
ENTER - Next field
NOTE: You must fill in both 'Name' and 'Number' fields
before you can select the 'OK' or 'Port' buttons.
Change
If a dial entry is highlighted, it can be changed
by clicking on this button. A new dialogue box will
appear with the selected entry's name, number and
terminal type.
The same selection options which applied to
'Insert' apply to this operation as well.
Remove
The dial entry that is selected can be removed by
clicking on this button.
The [ALT]-R key combination can also be used to
call this option.
You can exit the Phone Book by clicking on the
'close icon' located on the upper left hand corner of
the box or pressing the [ESC] key. Any changes made
to the Phone Book will be saved at that time.
Hangup (ALT-H)
Use this option when you wish to terminate the current
on-line session. An alert dialogue box will appear to notify
April 1996 LinkUp Reference Manual Page 16
you that the modem is hanging up. After the connection has been
severed, you will be returned to the terminal screen.
If the modem is on-hook (not connected to a host), this
option will not be accessible.
Port Setup (ALT-S)
This option calls up GPort, an easy-to-use interface which
allows you to set your modem port options. For more information
about GPort, see the GPort documentation file.
Modem Strings (ALT-M)
When LinkUp starts, it sends an initialization string to
your modem (default is ATZ). Many users want to customize their
modem to turn on certain features, such as flow control, timing
delays, etc. This option allows you to input a modem
initialization string of up to 32 characters. The next time you
start up LinkUp, that string will be sent to your modem.
The dial prefix string (default is ATDT) may also be
modified. Users with call-waiting and slow off-hook to
dial-tone transition can insert strings to deal with these
problems. See your modem manual for more information on modem
dial prefix strings.
Port Snooze (ALT-Z)
At times you may want to close the modem port without
disrupting your LinkUp session. This option will close the path
to the modem, allowing other programs (such as external transfer
protocols) to access the port. To reestablish LinkUp's
connection to the port, press [ENTER] or [ALT]-[W], or click on
the 'Wake Up!' button with the mouse.
April 1996 LinkUp Reference Manual Page 17
Send & Receive Menus
LinkUp gives you many options to transfer files to and from
your OS-9 computer. Thanks to Tim Kientzle's K, XY and Z
programs, which are tightly coupled with LinkUp, you can choose
from a number of protocols. Consult the K, XY and Z
documentation file for more information on these fine programs.
Once a transfer has been started, it can be aborted.
Should you decide to abort your transfer, you may do so by
pressing [ESC]. If the protocol has not aborted at that time,
pressing [ESC] a second time will unconditionally terminate the
program.
When any of the protocol functions in the Send menu are
selected, a file selection box will appear. Use the mouse or
keyboard to select a file to send, or press [ESC] at the file
selection box to abort the send. Both Send and Receive
protocols create an overlay window which reports the progress of
the transfer.
Here are the available protocols:
XModem CRC - XModem protocol with CRC checking
XModem Checksum - XModem protocol with checksum
XModem-K - XModem protocol with 1K block transfers
YModem - Simple YModem protocol
YModem-G - Faster YModem protocol
YModem Batch - A multi-file YModem protocol
ZModem - ZModem is currently one of the faster and more
popular protocols; because of this, it was integrated with
LinkUp. Note that if ZModem auto-detection is turned on when
sending a file, a file selection box appears automatically.
Kermit Binary - Kermit transfer for binary files
Kermit Text - Kermit transfer for ASCII/text files
April 1996 LinkUp Reference Manual Page 18
Fonts Menu
The font in the terminal area can be changed to any of five
unique K-Windows fonts: Standard, Macintosh, Gothic, IBM and
Cast. LinkUp remembers which font you last selected and will use
that font when it starts up. The initial default is Standard.
NOTE: LinkUp expects to find font files in the
standard directory /DD/SYS/.BITMAPS/FONTS. You can
change this behavior by setting the FONTPATH
environment variable to the directory where your fonts
are located. However, each font file must conform to
standard group/buffer number assignments and naming
conventions. For this reason, fonts are provided on
the LinkUp distribution disk.
April 1996 LinkUp Reference Manual Page 19
Colors Menu
Menu colors can be changed to one of nine different
colorsets provided:
o Blue
o Grey
o Dark Grey
o Green
o Aqua
o Red
o Purple
o Yellow
o DeskTop
Your last selected colorset will be saved when you exit
LinkUp. For DeskTop users, the DeskTop option uses the default
colorset found in the /DD/SYS/deskrc or the .deskrc file in your
home directory.
April 1996 LinkUp Reference Manual Page 20
Feedback on LinkUp
Like any other software author, I enjoy hearing ideas and
criticisms on my software. Feel free to send me your comments
via the Internet: boisy@os9er.waukee.ia.us. I am also on Delphi
as BOISY.
I can also be reached via US Mail:
Boisy G. Pitre
PO Box 523
Waukee, IA 50263
If you should encounter any strange or undocumented
behavior that might be considered a bug, please let me know,
with as much detail as possible as to how the problem can be
duplicated.
April 1996 APPENDIX A -- Terminal Emulation Notes Page 21
Terminal Emulation Notes
ANSI NOTES
While the ANSI engine in LinkUp is virtually
complete, there are a few behaviors that may not conform to the
ANSI graphic standard:
o Some PC BBS's use ANSI screens with embedded IBM
characters from 01 to 26. K-Windows does not have a
corresponding character for this range; hence, these
characters are replaced with spaces.
o K-Windows does not currently support blink mode so
ANSI blinking is not possible. The ANSI blink
sequence is ignored.
If you find that a particular ANSI screen is not displaying
properly in LinkUp, capture the ANSI file using the capture
feature in the File menu and e-mail the file to:
boisy@os9er.waukee.ia.us
Furthermore, I would be interested in any ANSI graphic art
that is available in order to more fully test the ANSI engine of
LinkUp.
K-WINDOWS NOTES
The K-Windows emulation engine in LinkUp covers basic text
features of the K-Windows environment. Specifically, commands
dealing with cursor movement, underline, bold, reverse and
character/line/screen deletion sequences are emulated.
K-Windows emulation ignores font selection, overlay
windows, and other windowing commands.
April 1996 APPENDIX B -- LinkUp Specific Files Page 22
LinkUp Specific Files
LinkUp creates two files on your system disk: .linkupcfg
and .linkupdial. The former contains configuration information
for LinkUp and the latter contains system names, phone numbers
and settings for each entry.
LinkUp attempts to reference and store these two files in
your home directory. If LinkUp is not successful in determining
your home directory (through the HOME environment variable), the
directory /DD/SYS/LINKUP will be created to store the two
files.
The .linkupcfg file
Although all options should be set from within LinkUp, you
may wish to edit or consult the .linkupcfg file from time to
time. The format of the file is:
NAME = VALUE
A '#' as the first character in the line indicates a
comment.
Here is an explanation of each entry in the configuration
file:
Port
The string value which is the name of the serial
port.
BaudRate
A numeric value which specifies the baud rate of
the serial port. Valid values are 300, 1200, 1800,
2400, 4800, 9600, 19200 and 38400.
WordSize
A numeric value which indicates the word size of
each byte. Valid values are 5, 6, 7 and 8.
Parity
A string value which indicates the parity. Valid
values are ODD, EVEN and NONE.
StopBits
A numeric value which indicates the number of
stop bits. Valid values are 1, 1.5 and 2.
XOnXOff
A boolean value indicating whether software
handshaking (XON/XOFF) will be used. If set to ON or
TRUE, software handshaking is active. If set to OFF
or FALSE, it is inactive.
CTSRTS
April 1996 APPENDIX B -- LinkUp Specific Files Page 23
A boolean value indicating whether hardware
handshaking (CTS/RTS) will be used. If set to ON or
TRUE, hardware handshaking is active. If set to OFF
or FALSE, it is inactive. Your serial port must
support hardware handshaking for this feature to
work.
ModemInitString
A string value which is set to the initialization
string that is sent to the modem when LinkUp first
starts. The default value for this string is ATZ.
ModemDialPrefix
A string value which is set to the dial prefix
string that is sent to the modem when LinkUp dials a
number. The default value for this string is ATDT.
ColorSet
A numeric value which corresponds to the colorset
that LinkUp will use.
ZModemAutoDetect
A boolean value which indicates whether ZModem
auto-detection is enabled. If set to ON or TRUE,
auto-detection is active. If set to OFF or FALSE, it
is inactive.
WorkDirectory
The default working directory that LinkUp changes
to when it starts up.
Sound
A boolean value which indicates whether sound
will be played during certain application events. If
set to ON or TRUE, sound will be played. If set to
OFF or FALSE, no sound will be played during
application events.
7BitMask
A boolean value which indicates whether the high
bit of all bytes coming from the serial port will be
cleared. If set to ON or TRUE, the high bit will be
masked. If set to OFF or FALSE, bytes coming in will
remain intact without masking.
Emulation
A string value which LinkUp uses to determine
which terminal emulation it will use. Valid values
are ANSI, VT100, ADDS, KWINDOWS and WYSE50.
Font
A string value which sets up the default font
used by LinkUp for displaying text in the terminal
area of the application window. Valid values are
STANDARD, MACINTOSH, GOTHIC, IBM and CAST.
SoundDir
A string value which is set to the directory
April 1996 APPENDIX B -- LinkUp Specific Files Page 24
where the sound files for the various events are
located. This must be a valid OS-9 directory
pathlist.
The names of the following variables indicate the
event in which they play a sound file. Their values
are the names of the files which are played for that
particular event.
Sound_Intro
This sound is played when LinkUp first starts.
Sound_Goodbye
This sound is played when the user exits LinkUp.
Sound_Bell
This sound is played when a bell character ($7)
is received. If sound is turned off, the normal
terminal bell sound will be generated.
Sound_Transfer
This sound is played when a file transfer has
completed.
Sound_Alert
This sound is played when the user is alerted to
an error.
Sound_Connect
This sound is played when LinkUp successfully
connects (the carrier detect goes high).
Sound_Disconnect
This sound is played when LinkUp disconnects (the
carrier detect goes low).
Macro[1-8]
The values of macros 1-8 are stored here.
The .linkupdial file
This file contains system names, numbers and information
used by LinkUp's phone book. Each line in the file is an entry,
with fields in the entry separated by a colon.
The format of an entry is:
Name:Number:Baud rate:Wordsize:Parity:Stop bits:Emulation:
CTS/RTS:XON/XOFF:ZModem Detect:7 bit mask:Sound
An example entry might look like this:
CompuServe:276-7231:38400:8:None:1:vt100:on:on:off:on:on
