home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Crawly Crypt Collection 1
/
crawlyvol1.bin
/
telecomm
/
conn246e
/
connect
/
connect.hlp
< prev
next >
Wrap
Text File
|
1994-02-27
|
148KB
|
5,864 lines
§§Index§
§Answering Machine§_Anrufbeantworter§
§Answering Params§_Anrufparameter§
§ASCII Upload§_Asciiupload§
§Baud Rate§Baudrate§
§Binary Files§Binärdateien§
§Break§T\BREAK§
§Buffer§_Puffer§
§Bugreports§Fehler§
§Capture§_Protokoll§
§Character Set§_Zeichensatz§
§Clear Buffer§T\CLRPUF§
§Clear Screen§T\CLRSCR§
§Clipboard Intro'§Klemm-Allg§
§Clipboard§Klemmbrett§
§Close§gl_Schlieβen§
§Colours§_Farben§
§Comms Reset§T\KRESET§
§Compatibility§_Kompatibilität§
§COSHY\ALERT§COSHYHLP\ALERT§
§COSHY\ALIAS§COSHYHLP\ALIAS§
§COSHY\BAUD§COSHYHLP\BAUD§
§COSHY\BELL§COSHYHLP\BELL§
§COSHY\BLITMODE§COSHYHLP\BLITMODE§
§COSHY\BREAK§COSHYHLP\BREAK§
§COSHY\CASE§COSHYHLP\CASE§
§COSHY\CARRIER§COSHYHLP\CARRIER§
§COSHY\CD§COSHYHLP\CD§
§COSHY\CMDTR§COSHYHLP\KMDTR§
§COSHY§CoSHy§
§COSHY\CTTY§COSHYHLP\CTTY§
§COSHY\DEBUG§COSHYHLP\DEBUG§
§COSHY\DIAL§COSHYHLP\DIAL§
§COSHY\DOWNLOAD§COSHYHLP\DOWNLOAD§
§COSHY\ECHO§COSHYHLP\ECHO§
§COSHY\ENV§COSHYHLP\ENV§
§COSHY\EVAL§COSHYHLP\EVAL§
§COSHY\EXIT§COSHYHLP\EXIT§
§COSHY\EXPR§COSHYHLP\EXPR§
§COSHY\EXPRESSION§COSHYHLP\AUSDRUCK§
§COSHY\FALSE§COSHYHLP\FALSE§
§COSHY\FILESEL§COSHYHLP\FILESEL§
§COSHY\FKY§COSHYHLP\FKY§
§COSHY\FLUSH§COSHYHLP\FLUSH§
§COSHY\FOR§COSHYHLP\FOR§
§COSHY\FUNCTION§COSHYHLP\FUNCTION§
§COSHY\GETKEY§COSHYHLP\GETKEY§
§COSHY\GET§COSHYHLP\GET§
§COSHY\GETTONE§COSHYHLP\GETTONE§
§COSHY\HANGUP§COSHYHLP\HANGUP§
§COSHY\HOLDSCRN§COSHYHLP\HOLDSCRN§
§COSHY\IF§COSHYHLP\IF§
§COSHY\IOREDIR§COSHYHLP\IOREDIR§
§COSHY\LOG§COSHYHLP\LOG§
§COSHY\METAS§COSHYHLP\METAS§
§COSHY\MISC§CoSHy-Allg§
§COSHY\NOISE§COSHYHLP\NOISE§
§COSHY\NOT§COSHYHLP\NOT§
§COSHY\OVERALL§COSHYHLP\OVERALL§
§COSHY\PLAY§COSHYHLP\PLAY§
§COSHY\PROT§COSHYHLP\PROT§
§COSHY\QUIT§COSHYHLP\QUIT§
§COSHY\QUOTES§COSHYHLP\QUOTES§
§COSHY\READ§COSHYHLP\READ§
§COSHY\READKEY§COSHYHLP\READKEY§
§COSHY\RECORD§COSHYHLP\RECORD§
§COSHY\REDRAW§COSHYHLP\REDRAW§
§COSHY\SAVEBUF§COSHYHLP\SAVEBUF§
§COSHY\SCANTABLE§COSHYHLP\SCANTABLE§
§COSHY\SCRIPT§COSHYHLP\SCRIPT§
§COSHY\SEND§COSHYHLP\SEND§
§COSHY\SENDBREAK§COSHYHLP\SENDBREAK§
§COSHY\SETENV§COSHYHLP\SETENV§
§COSHY\SET§COSHYHLP\SET§
§COSHY\SHIFT§COSHYHLP\SHIFT§
§COSHY\SLEEP§COSHYHLP\SLEEP§
§COSHY\SLOT§COSHYHLP\SLOT§
§COSHY\START§gl_CoSHystart§
§COSHY\TEST§COSHYHLP\TEST§
§COSHY\TIMEFORM§COSHYHLP\TIMEFORM§
§COSHY\TRUE§COSHYHLP\TRUE§
§COSHY\TRUE1§COSHYHLP\TRUE1§
§COSHY\UNALIAS§COSHYHLP\UNALIAS§
§COSHY\UNSET§COSHYHLP\UNSET§
§COSHY\UPLOAD§COSHYHLP\UPLOAD§
§COSHY\VERSION§COSHYHLP\VERSION§
§COSHY\WAITFOR§COSHYHLP\WAITFOR§
§COSHY\WHILE§COSHYHLP\WHILE§
§COSHY\WORD§COSHYHLP\WORTE§
§Data Bit§Datenbit§
§Dialling§_Wahl§
§Dialling Editor§T-Editor§
§Dial with K'board§Wahltastatur§
§Dial with Mouse§Wahlmaus§
§Display§_Darstellung§
§Download§T\DOWNLOAD§
§Echo§Echo§
§Editing of Help§Edithelp§
§Emulation§_Emulation§
§Emulation Intro'§Emulation-Einf§
§Environment§Environment§
§File Transfer§_Transfer§
§Fix Setup§T\FIXSET§
§Full Size§gl_Volle_Gröβe§
§Function Keys§_Funktionstasten§
§Green§Grünen§
§Handshake§Handshake§
§Hangup§T\HANGUP§
§History§History§
§Hold Screen§holdscreen-aktiv§
§Hotkeys§_Hotkeys§
§Information§_Info§
§IO-Buffer§Schnittstellenpuffer§
§Joke§Witz§
§Learn§_Lernen§
§Load Setup§T\LOASET§
§Load Numbers§T-Laden§
§General§_Allgemeines§
§Main Menu§Hauptmenü§
§Manual§Handbuch§
§Mark§Markieren§
§Men§männerfeindlich§
§Michael Ziegler§Ziegler§
§Modem Parameters§Modemparameter§
§New in 2.00§Neues2.0n§
§New in 2.01§Neues2.0n§
§New in 2.02§Neues2.0n§
§New in 2.10§Neues2.10§
§New in 2.20§Neues2.20§
§New in 2.4x§Neues2.40§
§On-line Help§Onlinehilfe§
§Open§gl_Öffnen§
§Options§gl_Optionen§
§Parity§Parität§
§Paste§Paste§
§Paths & Filenames§pathsel§
§Police§Polizei§
§Port§Port§
§Port§_Port§
§Prices§Preisliste§
§Programmer§Programmierer§
§Program Start§Programmstart§
§Quit§gl_Beenden§
§Quote§quoten§
§Registration§_Registrierung§
§Replay§T\REPLAY§
§Rotate Windows§gl_Rotieren§
§Save Buffer§T\SAVPUF§
§Save Setup§T\SAVSET§
§Scan Tables§Scantabelle§
§Start a Script§gl_Scriptstart§
§Shareware§Shareware§
§Start a Shell§gl_Shellstart§
§Size§_Size§
§Smiley§Smiley§
§Sounds§_Sound§
§Statistics§_Statistik§
§Status line§_Statuszeile§
§Remember§Erinnerungshilfe§
§Sending Keys§TastenVersenden§
§Smile§Lächeln§
§Tabulator§_Tabulator§
§Tektronix Menu§Menue-Tek§
§Tektronix Setup§_Teksetup§
§Tektronix Window§Tektronixfenster§
§Terminal§Term-Allg§
§Terminal Menu§Menue-Term§
§Terminal Reset§T\RESET§
§Terminal Window§Terminalfenster§
§TOS-Shell§T\TOSSHELL§
§Trash Can§Papierkorb§
§Transfer Info'§_DerTransfer§
§Type Ahead Buffer§_Vorschreibzeile§
§Upload§T\UPLOAD§
§Updates§Updates§
§User§Anwender§
§Window§Fenster§
§Window Dialogues§Fensterdialoge§
§Windows General§Fens-Allg§
§Window Menu§Fenstermenü§
§Window Names§gl_Fensternamen§
§Z-Modem Params§Zmodemparameter§
§
CoNnect Index
¯¯¯¯¯¯¯¯¯¯¯¯¯
Answering Machine
Answering Params
ASCII Upload
Baud Rate
Binary Files
Break
Buffer
Bugreports
Colours
Comms Reset
Compatibility
Capture
Character Set
Clear Buffer
Clear Screen
Clipboard
Clipboard Intro'
Close
COSHY
COSHY\ALERT
COSHY\ALIAS
COSHY\BAUD
COSHY\BELL
COSHY\BLITMODE
COSHY\BREAK
COSHY\CARRIER
COSHY\CASE
COSHY\CD
COSHY\CMDTR
COSHY\CTTY
COSHY\DEBUG
COSHY\DIAL
COSHY\DOWNLOAD
COSHY\ECHO
COSHY\ENV
COSHY\EVAL
COSHY\EXIT
COSHY\EXPR
COSHY\EXPRESSION
COSHY\FALSE
COSHY\FILESEL
COSHY\FKY
COSHY\FLUSH
COSHY\FOR
COSHY\FUNCTION
COSHY\GET
COSHY\GETKEY
COSHY\GETTONE
COSHY\HANGUP
COSHY\HOLDSCRN
COSHY\IF
COSHY\IOREDIR
COSHY\LOG
COSHY\METAS
COSHY\MISC
COSHY\NOISE
COSHY\NOT
COSHY\OVERALL
COSHY\PLAY
COSHY\PROT
COSHY\QUIT
COSHY\QUOTES
COSHY\READ
COSHY\READKEY
COSHY\RECORD
COSHY\REDRAW
COSHY\SAVEBUF
COSHY\SCANTABLE
COSHY\SCRIPT
COSHY\SEND
COSHY\SENDBREAK
COSHY\SET
COSHY\SETENV
COSHY\SHIFT
COSHY\SLEEP
COSHY\SLOT
COSHY\START
COSHY\TEST
COSHY\TIMEFORM
COSHY\TRUE
COSHY\TRUE1
COSHY\UNALIAS
COSHY\UNSET
COSHY\UPLOAD
COSHY\VERSION
COSHY\WAITFOR
COSHY\WHILE
COSHY\WORD
Data Bit
Dialling
Dialling Editor
Dial with K'board
Dial with Mouse
Display
Download
Echo
Editing of Help
Emulation
Emulation Intro'
Environment
File Transfer
Fix Setup
Full Size
Function Keys
General
Green
Handshake
Hangup
History
Hold Screen
Hotkeys
Information
IO-Buffer
Joke
Learn
Load Numbers
Load Setup
Main Menu
Manual
Mark
Men
Michael Ziegler
Modem Parameters
New in 2.00
New in 2.01
New in 2.02
New in 2.10
New in 2.20
New in 2.4x
On-line Help
Open
Options
Parity
Paste
Paths & Filenames
Police
Port
Prices
Program Start
Programmer
Quit
Quote
Registration
Remember
Replay
Rotate Windows
Save Buffer
Save Setup
Scan Tables
Sending Keys
Shareware
Size
Smile
Smiley
Sounds
Start a Script
Start a Shell
Statistics
Status line
TOS-Shell
Tabulator
Tektronix Menu
Tektronix Setup
Tektronix Window
Terminal
Terminal Menu
Terminal Reset
Terminal Window
Transfer Info'
Trash Can
Type Ahead Buffer
Updates
Upload
User
Window
Window Dialogues
Window Menu
Window Names
Windows General
Z-Modem Params
§§_Warn1§
§
A baud rate was demanded which is not available
on this port. Either choose another port or
another baud rate in the 'Port' dialogue or
select another compression method (celp) if the
answering machine has produced this warning
message.
§§_Warn6§
§
Windows running CoSHy or external shells, must
be completely visible on operating systems
without 'pipes', (only MiNT utilises pipes so
far). Move the window to place its working area
inside the screen.
§§_Warn8§
§
CoNnect needs the GEM-Clipboard for various
purposes. It searches for an installed
Clipboard in the following ways:
1) scrp_read(): Looks for a clipboard.
Installed by another GEM application. For
instance CLIPBORD.CPX does install a
Clipboard and CoNnect will no longer ask
the user to do this.
2) The environment variable CLIPBRD.
CoNnect will read the contents of this
variable as the current clipboard. You
can use ENVIRON.PRG in your AUTO-Folder to
permanently install this variable and get
rid of CoNnect's questions for a
clipboard.
3) C:\CLIPBRD: If this path is available.
CoNnect will use is as the GEM-Clipboard.
4) If 1-3 fail, CoNnect will ask the user.
You may help yourself with points 1-3 to
get rid of CoNnect's demand for installing
a clipboard.
§§_Warn24§
§
CoNnect says:
You are already CoNnected to an host with this
window.
This means CoNnect sees a carrier signal from
your modem. There may be several reasons:
1)
You really are connected to a host. In
this case it is not a good idea to dial
and this is why CoNnect warns you.
2)
Your Modem sends a carrier detect, even
though you are not connected. Either your
modem is badly configured or it's carrier
detect signal does not work at all.
3)
You are using a bad cable to connect modem
and the Atari. Use a good cable.
In the last two cases you might find a
possibility to fix your problem. Otherwise you
can (losing CoNnect's charge statistics) switch
off the button 'check carrier' in the modem
dialogue 1. This will help you to at least be
able to dial.
§§_Warn44§
§register§Shareware§
§
CoNnect is a Shareware program.
As you have tested it for a very
long time, you must register if
you want to continue using it.
§§_Warn57§
§here§_Warn24§
§
CoNnect sees that the port is
currently locked by another part
of the program. Though this is
nearly always true, there may be
a reason why CoNnect believes it
has received a Carrier signal
from you modem even though it has
not. A possible solution for a
similar problem is given here.
§§_Warn78§
§
You started a new CoNnect Version
using and old .OPT file. CoNnect
now tries to evaluate the old
information as much as possible.
You will have to check this
conversion afterwards.
§§Warn82§
§here§Compuserveport§
§
Your port setup doesn't allow a secure
file transmission to or from Compuserve.
You need the setting:
'8N1 Strip 8.Bit'
Exact instructions are given here.
§§Menue-Term§
§Answering Machine§_Anrufbeantworter§
§ASCII-Upload§_Asciiupload§
§Capture§_Protokoll§
§Character Set§_Zeichensatz§
§Clear Buffer§T\CLRPUF§
§Clear Screen§T\CLRSCR§
§Close Window§CLOWIN§
§Compatibility§_Kompatibilität§
§Commun. Reset§T\KRESET§
§Copy Buffer§_Puffer§
§CoSHy§CoSHy§
§Dial§_Wahl§
§Display§_Darstellung§
§Download§T\DOWNLOAD§
§Emulation§_Emulation§
§File Transfer§_Transfer§
§Fix Setup§T\FIXSET§
§Function Keys§_Funktionstasten§
§Hangup§T\HANGUP§
§Learn A Script§_Lernen§
§Load Setup§T\LOASET§
§Port§_Port§
§Replay§T\REPLAY§
§Save Buffer§T\SAVPUF§
§Save Setup§T\SAVSET§
§Script§CoSHy§
§Status Line§_Statuszeile§
§Send Break§T\BREAK§
§Terminal Reset§T\RESET§
§Terminal Size§_Size§
§Tabulator§_Tabulator§
§TEK Parameters§_Teksetup§
§TEK 4014 Window§Tektronixfenster§
§TOS-Shell§T\TOSSHELL§
§Upload§T\UPLOAD§
§
Terminal Menu
¯¯¯¯¯¯¯¯¯¯¯¯¯
-------------------------------------------------------------
Terminal Setup Misc
-------------------------------------------------------------
File Transfer Emulation... CoSHy
Terminal Size Character Set... Script...
-------------- Display... Learn A Script...
Terminal Reset Capture... TOS-Shell
Commun. Reset Tabulator... TEK 4014 Window
Hangup Port... Answering Machine
Clear Screen Function Keys... Fax...
Clear Buffer Compatibility... -----------------
Save Buffer... Status Line... Dial...
Copy Buffer TEK Parameters... -----------------
Send Break -------------- ASCII-Upload
-------------- Fix Setup Upload
Close Window -------------- Download
Load Setup... Replay
Save Setup...
§§T\UPLOAD§
§file transfer dialogue§_Transfer§
§
Upload
¯¯¯¯¯¯
Using the menu item "Upload..." you can
send a file with the parameters specified
in the file transfer dialogue.
§§T\DOWNLOAD§
§file transfer dialogue§_Transfer§
§
Download
¯¯¯¯¯¯¯¯
Using the menu item "Download..." you can
receive a file with the parameters
specified in the file transfer dialogue.
§§T\REPLAY§
§ASCII-Upload§_Asciiupload§
§emulation§_Emulation§
§Upload§T\UPLOAD§
§
Replay
¯¯¯¯¯¯
A file from disk will be displayed using
the current emulation.
ATTENTION:
No characters of the file will be sent to
the modem. If you want to do this, use the
commands "Upload" or "ASCII-Upload".
§§T\TOSSHELL§
§SHELL§Environment§
§
TOS-Shell (Terminal Menu)
¯¯¯¯¯¯¯¯¯
Start the TOS-Shell in the current
window if one is available. Use the
environment variable $SHELL or the
_shell_p pointer to install a TOS-
Shell.
§§T\SAVPUF§
§
Save Buffer
¯¯¯¯¯¯¯¯¯¯¯
All data in the current history
buffer will be saved to a disk file.
§§T\CLRPUF§
§
Clear Buffer
¯¯¯¯¯¯¯¯¯¯¯¯
All data in the current history
buffer will be cleared.
§§T\BREAK§
§sendbreak§COSHYHLP\SENDBREAK§
§
Send a Break
¯¯¯¯¯¯¯¯¯¯¯¯
CoNnect sends a break signal to the
modem.
SEE ALSO: sendbreak (CoSHy Command)
§§CLOWIN§
§
Close Window
¯¯¯¯¯¯¯¯¯¯¯¯
The top window will be closed.
§§T\RESET§
§Fix Setup§T\FIXSET§
§Load Setup§T\LOASET§
§Save Setup§T\SAVSET§
§
Terminal Reset
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The terminal window will
be reset to the values
of the last Fix Setup,
Save Setup or Load Setup.
§§T\CLRSCR§
§
Clear Screen
¯¯¯¯¯¯¯¯¯¯¯¯
The current window will be cleared.
§§T\KRESET§
§hold screen§holdscreen-aktiv§
§
Communication Reset
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
All characters pending in the IO-Queue
will be discarded. A possible state of
hold screen will be cleared.
§§T\HANGUP§
§Dial§_Wahl§
§'hangup'§COSHYHLP\HANGUP§
§
Hangup
¯¯¯¯¯¯
The modem will be forced to hangup the
phone. The way this is done can be
set in the "Dial" dialogue.
SEE ALSO: 'hangup' (CoSHy Command)
§§T\FIXSET§
§terminal reset§T\RESET§
§
Fix Setup
¯¯¯¯¯¯¯¯¯
All current settings will be remembered
for a later terminal reset.
§§T\LOASET§
§Save Setup§T\SAVSET§
§
Load Setup
¯¯¯¯¯¯¯¯¯¯
This option will load a terminal setup,
saved by "Save Setup", from disk.
§§T\SAVSET§
§Dial§_Wahl§
§Fix Setup§T\FIXSET§
§Load Setup§T\LOASET§
§terminal menu§Menue-Term§
§
Save Setup
¯¯¯¯¯¯¯¯¯¯
The current terminal settings will be saved to
disk. Terminal settings are all possible settings
that can be changed within the terminal menu.
There is one exception to this rule; telephone
numbers in the "Dial" dialogue are stored in the
telephone book. Only the name of this telephone
file will be stored in the setup.
Using "Load Setup", you can reload a saved setup.
Before a "Save Setup" is performed, CoNnect will
automatically do a "Fix Setup".
§§_Puffer§
§selecting, sending§Markieren§
§
The Buffer Window
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The buffer window is opened by the menu item
"Copy Buffer" in the terminal menu.
The buffer window enables you to have the history
buffer in a separate window while your data-flow
is running in the terminal window.
Using the buffer window you can perform any marked
text operations (selecting, sending), exactly as
if they were being done from the terminal window.
§§_Wahl§
§clipboard§Klemmbrett§
§trash can§Papierkorb§
§modem parameter§Modemparameter§
§phone editor§T-Editor§
§load numbers§T-Laden§
§save numbers§T-Laden§
§the mouse§Wahlmaus§
§or the keyboard§Wahltastatur§
§
In the "Dial" dialogue, the telephone book is displayed
on the right-hand side and the repeated dial memory is
displayed on the left-hand side. Dragging entries from
the telephone book to the repeated dial memory and then
clicking on the telephone icon, will cause CoNnect to
dial all of the numbers in the repeated dial memory.
When the last entry has been dialled, CoNnect will start
again at the first entry.
There are many icons to manipulate the telephone book or
modem settings. The icons from top to bottom are, the
phone editor, load numbers, save numbers, and the sorter
icon. The line of icons at the bottom of the dialogue
box are, the trash can, the clipboard, and the two modem
parameter icons. Finally, above the repeated dial memory
there is the telephone icon.
You can use either the mouse or the keyboard to operate
the "Dial" dialogue.
§§Wahlmaus§
§
Dialling with the Mouse
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
You may select entries in the telephone book by clicking on
them. Doing this while pressing the SHIFT key will append
the new item to a previously made selection. If you click
to the left of the telephone book and hold the mouse button
down, you can use a rubber-band to select several items at
once. If you click to the left of the telephone book but do
not hold the mouse button down, you will deselect all
selected entries. You may use the repeated dial memory in
an identical fashion.
You may add entries to the repeated dial memory by dragging
them from the telephone book to the repeated dial memory
(moving the mouse while the left button is held down).
Deleting entries from the telephone book, or the repeated
dial memory, is done by dragging them to the trash can. In
the repeated dial memory, a double-click on an entry will
cause the number to be dialled (and deleted from the list
if a connection is made).
You can change the order of entries in the telephone book,
or in the repeated dial memory, by simply dragging them to
their new location.
The Most Important Icon: The Telephone
Clicking on the telephone icon will cause CoNnect to start
dialling the entries within the repeated dial memory, and
continue dialling until a connection can be established or
a user definable event (SEE: modem parameter) occurs.
Dragging an item onto the telephone icon will cause CoNnect
to start a single dialling attempt.
Double-clicking on an entry in the telephone book while
pressing SHIFT will start dialling attempts to this entry
until a connection is established.
§§Wahltastatur§
§
Dialling with the Keyboard
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
You can operate the "Dial" dialogue with the following keys:
Cursor Keys
UP, DOWN: - Moves the cursor (a rubber-band) up and down one
entry at a time.
LEFT, RIGHT: - Moves the cursor from the repeated dial
memory to the telephone book and back again.
SHIFT + UP:
SHIFT + DOWN: - Moves the cursor up and down one page at a time.
Pressing normal keys will cause connect to move the cursor to the
entry with a name that matches the pressed keys.
CLRHOME: - Move to the first entry.
SHIFT + ClrHome: - Move to the last entry.
INSERT: - Marks an entry as being selected.
SHIFT+INSERT: - Marks an entry as being selected,
without deselecting previously selected
entries.
CONTROL+INSERT: - Moves an entry to the repeated dial
memory or moves it back to the telephone
book.
SHIFT+CONTROL+INSERT: - Performs a single dialling attempt on the
entry.
DELETE: - Mark an entry as deselected.
^E: - Enter the dialling editor. If there are selected
entries, they can all be edited.
^M: - Enter the first modem configuration dialogue box.
^N: - Enter the second modem configuration dialogue box.
^S: - Save the telephone book (and the repeated dial memory)
to disk.
^O: - Load the telephone book (and the repeated dial memory)
from disk.
^I: - Toggle sorting of numbers (off, alphabetical, or by
numbers).
^V: - Copy the clipboard to the telephone book.
^C: - Copies marked numbers to the clipboard.
^W: - Dial the selected entries.
^A: - Select all entries in the telephone book or the
repeated dial memory, depending on where the cursor is.
^R: - Rotate the repeated dial memory.
^T: - Copy all selected entries to the repeated dial memory.
^X: - Mark all selected entries as deselected.
§§T-Laden§
§
Load Numbers
¯¯¯¯¯¯¯¯¯¯¯¯
The two disk icons are used to save and load
telephone books.
Loading a telephone book will replace the
old one, unless the SHIFT key is held down.
If you hold the SHIFT key down, the new
telephone book will be appended to the old
one.
The same applies for saving. Saving the
telephone book will delete an existing
telephone book file. If the SHIFT key is
held down, the telephone book will be
appended to the existing file.
§§T-Editor§
§
The Phone Editor
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
This editor may be used to change the data
in your telephone book.
Clicking on the editor icon without any
telephone book entry selected will allow you
to create a new entry.
Dragging existing entries to this icon will
allow you to modify them.
The telephone number is the number you have
to dial to get a line to a given bbs. The
reset and the init strings are of similar
meaning; they contain strings to setup your
modem before dialling starts. The dial
string itself (normally ATD#|) starts the
dialling sequence.
All three strings may contain three special
characters:
| = Carriage Return
~ = 0.5 Second Delay
^ = Pull DTR Low (0.5 Seconds)
You may also select a script to be executed
as an automatic login script to your bbs if
the connection is established.
The information button enables you to add
some extra information to an entry in the
phone editor.
§§Modemparameter§
§
Modem Reactions
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
By clicking on the first modem icon, you can
setup the way CoNnect reacts to modem return
codes while dialling. In the first row you
enter the modem messages. To the right of
the modem messages, you can specify how
CoNnect reacts. If you do not want CoNnect
to act on a specific modem response just
remove this response from the response list.
Normally, CoNnect reacts on any modem
response BEGINNING with the entered
characters. If you want CoNnect to only
react to identical responses, append a
CONTROL-M (CR) to the response string.
There are also waiting parameters. You can
specify how long CoNnect waits until it
dials the next number in the dialling list
(first parameter) and how long it waits
until dialling the first number in the list
again.
By clicking on the second modem icon you can
specify the delay between the characters
sent to the modem when dialling. Some low
quality modems need long delays like 100MS.
You can also enter the default dialling
sequence strings used when you enter new
numbers in the phone editor, or when reading
in a SCRAP.TXT file from the clipboard.
§§Klemmbrett§
§
Clipboard
¯¯¯¯¯¯¯¯¯
The CoNnect clipboard is compatible with the
GEM-Clipboard. CoNnect will ask you to
install a Clipboard if this has not been
done on your system yet (there are many
public domain programs to do this) or if
CoNnect cannot find the folder C:\CLIPBRD.
If there is anything in the clipboard, the
clipboard icon will have a written piece of
paper on it. If the clipboard contains
telephone book information, it may be
dragged to the telephone book. You can drag
numbers from the telephone book or the
repeated dialling memory to the clipboard.
Pressing SHIFT during this action causes
CoNnect to append the entry to the clipboard
data, rather than write over it.
§§Papierkorb§
§
The Trash Can
¯¯¯¯¯¯¯¯¯¯¯¯¯
Everything you drag onto the trash can will
be lost. An "UNDO" is only possible if you
leave the dialling dialogue by CANCEL; in
which case all changes to this dialogue will
be discarded. When dragging the clipboard
onto the trash can, the contents of the
clipboard will always be lost. No "UNDO" is
possible.
§§_Vorschreibzeile§
§
The Type Ahead Buffer
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
You can activate the type ahead buffer by
pressing CONTROL+INSERT from within a
terminal window. Everything you type inside
this window will be sent to the modem if you
end this input with an ENTER or RETURN.
Pressing "UNDO" will cancel your input.
Pressing Cursor UP/DOWN will let you use
a 20 line buffer for the type ahead buffer.
§§_DerTransfer§
§multi-tasking§_Transfer§
§
File transfer is in progress.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
To cancel just press the cancel button or type
^C in case you disabled the multi-tasking.
³ In the upper box you see:
+--------------------------------+
| 111111111111111111 22222 |
| 333333333333333333 44444 |
| 555555555555555555 77777 |
| 666666666666666666 |
+--------------------------------+
1) A bar that displays the amount of data
already transferred.
2) The protocol options.
3) In multiple-file transfers another bar
displaying the status of the whole
transfer.
4) In multiple-file transfers the number of
files in total.
5) The filename.
6) The path.
7) The current block size.
³ In the middle box you will find:
+--------------------------------+
| 1111/2222 3333/4444 5555/6666 |
| 7777/8888 9999 aaaa/bbbb |
+--------------------------------+
1) The amount of data already transferred in
bytes.
2) The total size of the current file.
3) The current speed of the transfer.
4) The average speed of the transfer.
5) The time spent so far.
6) The estimated time needed.
For multiple-file transfers only:
7) The amount of data already transferred in
bytes.
8) The total size of all files.
9) The average speed of the transfer.
a) The time spent so far.
b) The estimated time needed in total.
³ In the lower box:
... you will get status reports about the
protocol.
§§Compuserveport§
§port§_Port§
§databits§Datenbit§
§parity§Parität§
§stopbit§Datenbit§
§8N1§COSHYHLP\BAUD§
§7E1§COSHYHLP\BAUD§
§compatibility§_Kompatibilität§
§
For a file transfer with CompuServe you
need the following setup for your serial
port:
8 databits | no parity | 1 stopbit (8N1)
With CompuServe sending in 7E1 mode you
need to get rid of the 8th databit for a
clean display. The 8th bit should be
stripped in the compatibility dialog.
§§Zmodemparameter§
§special port setup§Compuserveport§
§
Here is a short listing of the options available with the
internal transfer module.
Popup #1 - Protocol:
--------------------
∙ Z-Modem: This is the best choice if your host supports
this protocol. It is very fast, and has excellent
error recovery.
∙ Y-Modem: This is slower than Z-Modem, but still quite
fast, but not as error-proof as Z-Modem.
∙ X-Modem: This should only be used if your host does not
support any other protocol. It is very slow!
∙ X-Modem7: A protocol, used at least by CompuServe.
∙ CompuServe B:
∙ CompuServe B+: Two protocols used only by CompuServe.
You need a special port setup for CompuServe.
Popup #2 - Buffer Size:
-----------------------
You may choose between 128, 256, 512 and 1024 byte blocks. The
resulting buffer size will be your chosen one or below this
depending on the parameters of your host. For X-Modem only
128 or 1024 bytes are useful. Y-Modem will always use 1024
Bytes regardless of your settings. For Z-Modem you may select
8192 byte blocks but be aware that this option does not run
with Omen Z-Modem products but with GEMSZRZ and some unix im-
plementations.
Popup #3 - Data Protection:
---------------------------
∙ Overwrite will always overwrite existing files.
∙ Protect will cause an error condition when receiving a
filename which already exists on your system.
∙ Resume will try to perform an error recovery. In fact it
will append missing parts to already existing files.
∙ Ask User will ask the user if a file should be overwritten,
skipped, or resumed if the file already exists.
∙ Rename will cause CoNnect to create a unique name for an
incoming file if a file with that name already exists.
Popup #4 - Escapes:
-------------------
∙ No Escapes is normally used on lines which will not filter
any of the possible 256 8-Bit characters.
∙ Escapes On has to be used if you are working on certain
Unix systems which have TTYs which will filter control
characters. Transmission is much slower when using escapes.
Popup #5 - Data Type:
---------------------
You may decide here if you are transferring Binary data (no
conversion performed) or ASCII data (linefeeds have to be
changed).
Automatic data type detections will try to guess the data
type by the file extension. This is not always safe.
CoNnect assumes the following extensions to be extensions of
ASCII Files:
TXT, ASC, RTF, C, CPP, C++, H, PAS, F,
FOR, F77, CAR, PS, EPS, XBM, TEX, STY
Popup #6 - Checksums:
---------------------
You may select either CHECKSUM (X/Y-Modem), CRC-16 (X/Y/Z-
Modem) or the standard CRC-32 (Z-Modem) which gives the most
security.
Full Paths: (not available with CompuServe)
-----------
Only a few hosts allow this option to be switched on. It will
send full pathnames and try to create directories on your
system if full pathnames are received.
Choose Filenames: (CompuServe only)
-----------------
When Uploading a fileselector will let the user chose the fie
to send. This option does not allow the flag 'No Multi-
tasking' (see below) to be set.
Force Acknowledge:
------------------
Normally, CoNnect's Z-Modem runs in Stream Mode. If this
switch is on, CoNnect wants an acknowledge from the host
after each transmitted block. This will decrease transmission
speed.
No Multi-tasking:
-----------------
If you need really high speed transfers this option will
disable all multi-tasking within CoNnect and the system. To
stop a running transfer you will have to press Control-C.
File attributes:
----------------
If set, CoNnect sets the read-only flag of received files
like the one of the original file.
Concerning Transmission Speed:
You will obtain high transmission rates when you set a large
IO-Buffer in the "Port" dialogue. A value of 8192 bytes is a
good choice.
§§_Transfer§
§binary files§Binärdateien§
§GSZRZACC§Ziegler§
§here§Zmodemparameter§
§Michael Zieglers§Ziegler§
§paths§pathsel§
§path§pathsel§
§
The File Transfer Dialogue
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Here you make all the necessary settings for the transfer
of binary files. You may either use CoNnect's internal Z-
Modem or external programs like the famous GSZRZACC.
The internal Z-Modem can be chosen when you set the
transfer program popup to "XYZ-Modem (Int.)".
Click here for the information about 'Internal Z-Modem
Parameters'.
If you are using the registered version of Michael
Ziegler's Z-Modem, which will be faster than the internal
protocol, you may put this ACC on your boot drive and
CoNnect will start communicating with it. Please read the
Z-Modem instructions carefully and do not forget to put a
"$" as the last sending parameter in all external
protocols. Choose "GEMRZSZ.ACC" in the transfer program
popup and press the "Search Accessory" button.
To use an external XYZ-Modem transfer program, you may
choose XYZ-Modem (Ext.) from the transfer program popup
and select the program paths of this protocol.
Standard parameters for several external programs are:
GEMSZRZ.GTP:
Receive: -rz
Send : -sz $
XYZ.TTP
Receive:
Send : -u $
SRZ:
Receive:
Send : -a $
The "$" sign is expanded to a file selector box which
opens when the transfer is started. The file (or several
files if Selectric is installed) which you then select
will replace the "$" in the command line.
If you activate the Z-Modem "auto start", Z-Modem
reception will start automatically.
With SLOT you may define up to eight different protocol
settings which may be selected when needed for a special
kind of operation.
§§Binärdateien§
§
Binary Files
¯¯¯¯¯¯¯¯¯¯¯¯
For the transfer of binary files, transfer protocols are
used to allow error free and/or fast transfers. Z-Modem is
error free and fast. Kermit is error free, but not as fast
as Z-Modem. X-Modem is very slow, but nearly error free.
Without error checking, Y-Modem is very fast.
Normally Z-Modem is the best choice if it is available.
§§Ziegler§
§
You can get a highly recommended Z-Modem
program for DM 30, from:
XENIA Software XENIA Software
Michael Ziegler Michael Ziegler
Jagdfeldring 16 Kreissparkasse Muenchen
D-8013 Haar BLZ 702 501 50
Kto: 420354680
You may contact the author on the Maus-Net:
Michael_Ziegler@M
You may contact the author on the Internet:
Michael_Ziegler@m.maus.de
§§_Tabulator§
§
Tabulator
¯¯¯¯¯¯¯¯¯
You may specify your own tabulator setup here.
However, it is a good idea to set the tab
distance to eight.
The other possible settings are:
Left and right border in the ANSI Emulation.
A VT100 margin bell.
The scroll region - only touch this if you
understand VT100 and know what you are
doing.
§§_Statuszeile§
§
The Status Line
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Below the terminal menu you may install the
VT100 status line. You can do this by activating
the check box on top of this dialogue.
The information you will see in this line is
determined by the other settings in this
dialogue.
§§_Size§
§hold screen§holdscreen-aktiv§
§
Terminal Size
¯¯¯¯¯¯¯¯¯¯¯¯¯
You may set the terminal size here (but remember most
hosts want you to use an 80x24 display).
The buffer lines are lines for your history scroll-back-
buffer. If you want to scroll back, it is highly
recommended that you activate hold screen before doing
so, because otherwise CoNnect will always scroll to the
bottom of the window when it receives new characters.
When you are using the fast scroll option, you should
install at least fifty buffer lines and enable (at
least) the vertical scroll bar.
Cursor coupling will keep track of the cursor; if it is
outside the visible part of your window, the window will
be scrolled to make the cursor visible again. For speed
reasons this coupling is only done vertically.
§§holdscreen-aktiv§
§
Hold Screen
¯¯¯¯¯¯¯¯¯¯¯
Normally, the F1 function key is set to "holdscreen".
Thus, if you press F1, hold screen gets activated until
F1 is pressed again. When the screen is being held, the
right-hand LED in the terminal window will be on. This
will allow you to scroll back in your history buffer
without being disturbed by CoNnect jumping to the
bottom when receiving new characters.
To make F1 the "holdscreen" key, you must:
Open the function key dialogue. Set the text of F1 to
"holdscreen" (without the quotes) and enable the left
check box behind this entry.
F1 will then toggle the hold screen status.
§§_Registrierung§
§distributors§Wo Registrieren§
§manual§Handbuch§
§programmer§Programmierer§
§
The Registration Dialogue
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
This dialogue should be used to enter your user data.
Name, address, favourite football player. :-)
You must, at least, enter your name here to allow
CoNnect to create a unique user ID for you. Entering
your address will enable CoNnect to create a
registration letter, which is highly recommended as
it will eliminate lots of possible registration
problems.
If the programmer (me) has received your registration
fee AND the registration, you wil get the key for an
unlimited version and a printed manual.
The registration key has to be entered in this
dialogue in one of the six possible slots.
Six - because you will need a special key for each
version of TOS you are using, since the user ID is
dependent on this.
For some countries, local distributors will handle
your registration.
§§Programmierer§
§distributors§Wo Registrieren§
§
You can contact the programmer of CoNnect at:
Mail
----
Wolfgang Wander
Rudolf-Breitscheid-Str. 63a
D-22880 Wedel
Germany
Electronic Mail
---------------
Wolfgang Wander @ HH2 (Mausnet)
wwc@dxhra1.desy.de (Internet)
Bank
----
Wolfgang Wander
Konto-Nummer: 1373482932
Hamburger Sparkasse
Bankleitzahl: 20050550
If you are not living in Germany you
might find it more convenient to
contact the local distributors.
§§_Port§
§baud§Baudrate§
§data bits§Datenbit§
§handshake§Handshake§
§IO-buffer§Schnittstellenpuffer§
§parity§Parität§
§port§Port§
§stop bits§Datenbit§
§
Port
¯¯¯¯
This is where you can specify the port parameters.
Port parameters consist of port, baud rate, handshake
mode, data bits, stop bits, parity and IO-Buffer size.
§§Handshake§
§IO-Buffer§Schnittstellenpuffer§
§
Handshake
¯¯¯¯¯¯¯¯¯
Possible settings for the handshake mode are:
- No Handshake
- RTS/CTS
- XON/XOFF
Handshaking is used between two computers (or a
computer and a modem) to signal each other,
whether or not, they are able to receive data.
Without handshaking, lots of data would be lost
if the receiving computer is slower in taking the
data than the computer sending out the data.
Without handshaking (because your modem or host
does not support it) you should try to install a
large IO-Buffer.
The different forms of handshaking are:
∙ Software Handshake: XON/XOFF
As soon as one of the partners is ready to
receive data, it sends an XON (^Q). When it
wants to stop transmission it will send an
XOFF (^S).
∙ Hardware Handshake: RTS/CTS
This is quite similar to software handshaking
In contrast, no characters are sent; only
voltages on hard wired lines are set. Hardware
handshake will give you better transmission
speed.
It is important, that both sides use the same
form of handshaking Otherwise, the connection
would be equivalent to no handshaking at all or
and in the worst case, transmission would be
blocked.
§§Schnittstellenpuffer§
§handshake§Handshake§
§
IO-Buffer
¯¯¯¯¯¯¯¯¯
The size of the IO-Buffer can
be set to values between 256
bytes and 32767 bytes.
If your host or your modem
supports handshaking, a value
of 4096 or 8192 will be
reasonable (for fast Z-Modem
transfers).
Otherwise the largest value
might still not be large
enough. Set it to 32767 bytes.
§§Echo§
§
Echo
¯¯¯¯
Possible settings for echo are echo on, echo off, and local.
Echo On: Every character typed by you on the keyboard will
be send to the host and will also be displayed in
the terminal window. If your host will have a
built-in echo, your display will look like "oohh
wwhhaatt nniiccee ddoouubbllee cchhaarraacctteerrss".
In that case, a better choice would be echo off.
Echo Off: Working in mailboxes or on Unix computers, this is
the right choice. Typed characters are sent to the
host only and the host is expected to echo them (if
you should see them).
Local: Here no characters are sent to the host. Everything
you type will only be displayed on screen.
§§Parität§
§
Parity
¯¯¯¯¯¯
Possible settings for parity are
none, even, and odd.
No parity will neither send nor
receive an additional parity bit.
If the sent character has an even
number of set bits, the parity
bit will be set/unset if even/odd
parity is enabled and vice versa.
§§Datenbit§
§parity§Parität§
§
Data Bits
¯¯¯¯¯¯¯¯¯
Possible settings for data bits
are five, six, seven, or eight.
Each character sent consists of
one start bit, a configureable
number of data bits, an optional
parity bit and a configureable
number of stop bits.
To send with eight data bits, no
parity and 1 stop bit (which is
default on most hosts) 10 bits
per character are sent.
§§Baudrate§
§port§Port§
§
Baud Rate
¯¯¯¯¯¯¯¯¯
The baud rate is the number of bits which can be
transmitted per second on the serial line of your Atari.
On a simple ST you can specify the following rates:
19200, 9600, 4800, 3600, 2400, 2000, 1800,
1200, 600, 300, 200, 150, 134, 110, 75, 50
You may speed up you ST by a hardware enhancement (RS-
Speed by Stephan Skrodzki or RSVE by Harun Scheutzow) to
get 38400, 57600 and 115200 BPS. Those enhancers can
install a cookie so that CoNnect knows of their
existence and displays the correct rates.
On a TT, a MegaSTE and on the Falcon030 you have some
additional and higher baud rates.
Show information about the port?
§§Port§
§baud rates§Baudrate§
§
Atari Ports
¯¯¯¯¯¯¯¯¯¯¯
On all Atari computers, you can use the MIDI Port in
addition to the normal serial ports. Transmission
parameters on MIDI are fixed to 8N1 (8 data bits, no
parity, 1 stop bit), no handshake, and 31250 baud.
On a Falcon you are able to select some higher rates:
153600, 125000, 115200, 83333, 76800,
62500, 57600, 50000, 38400, 31250.
The MegaSTE has three serial ports:
MODEM1 - This is identical to the ST-Port.
MODEM2 - This is identical to the Falcon port.
SERIAL2 - This has the following additional baud rates:
125000, 115200, 83333, 62500,
57600, 38400, 31250, and 14400.
The MegaSTE's ports have some hardware defects. Only
MODEM2 and MODEM1 can give satisfying results.
The TT has four serial ports:
MODEM1 - This is identical to the ST-Port
MODEM2 - This is similar to the Falcon port (but not
able to do 57600 and 115200 baud).
SERIAL1 - This is similar to the ST-Port (but has less
lines and is therefore almost unusable).
SERIAL2 - This is identical to SERIAL2 on the MegaSTE,
but bug free. It has no Ring indicator.
The higher baud rates will only be of interest for you
if you are using a high speed. The Telebit WorldBlazer
is able to receive and send at 115200 baud but this is
quite hypothetical.
§§Scantabelle§
§character set§_Zeichensatz§
§scantable§COSHYHLP\SCANTABLE§
§
The Scan Table
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
This is a file with certain commands for connect that
tell it how to handle any key pressed.
It can either be loaded in the dialogue character set or
by the CoSHy command "scantable".
For example, you can use the table to map some
country specific keys. The German umlaute serves as an
excellent example:
'ä' 'ae' 'Ö' 'Oe'
'ö' 'oe' 'Ü' 'Ue'
'ü' 'ue' 'β' 'ss'
'Ä' 'Ae'
The first column contains the key pressed and the second
column contains its replacement. ('' have to be used
here.)
You can also give an ASCII value for the key pressed. If
you want to replace ^A, you type:
1 'this' 32 'was' $20 'key' 0x20 '^A'
NOTE: The <Space> character may not be included in
quotes (''). It must be specified as 32.
Negative numbers in the first row refer to the
(positive) Scancode number. You will find a complete
overview of the scan code table in the manual. (app. C)
To get the string "Escape" when you press the Escape
key, type:
-1 'Escape'
To send the cursor down VT100 Sequence when you press
cursor up, type:
-72 0x1b '[B'
This is fun! ;-)
An important application of scan tables is the doorway-
mode, where you can force your Atari to send DOS scan
codes to allow remote control of a PC running the
DOORWAY program.
Following the scancode entry, you may specify a special
SHIFT-State of your keyboard.
To react to a SHIFT-Escape keypress, while making sure
that CONTROL and ALTERNATE are not pressed, type:
-1 Sca 'escape shift'
s = SHIFT not pressed.
S = SHIFT pressed.
c = CONTROL not pressed.
C = CONTROL pressed.
a = ALTERNATE not pressed.
A = ALTERNATE pressed.
If this information is missing, the status of the shift
keys will not affect the selection of replacements.
§§_Zeichensatz§
§manual§Handbuch§
§scan table§Scantabelle§
§
Character Set
¯¯¯¯¯¯¯¯¯¯¯¯¯
Character sets can be defined here. These may
be either the Atari character set or the ISO
character set. The latter allows you to choose
between several different national replacement
character sets.
National special keys (the Umlaute) and the way
CoNnect sends them can be defined here as well.
This could also be done in the scan tables, but
it is easier this way.
The scan table is a file where you can specify
which characters shall be sent if a certain key
is pressed by the user.
A better description of this feature will be
found in the manual.
§§_Kompatibilität§
§
Compatibility
¯¯¯¯¯¯¯¯¯¯¯¯¯
As some hosts have problems with
correct VT100 emulation (like
CoNnect's), you may use this
dialogue to reduce the VT100
correctness of CoNnect.
If there are problems with your
host, play around with this setup
and search for improvements.
§§_Funktionstasten§
§
Function Keys
¯¯¯¯¯¯¯¯¯¯¯¯¯
In this dialogue you can set up to eighty
function keys (using combinations of SHIFT, ALT
and CONTROL).
Normally any text placed on a function key will
be sent to the host when the key is pressed. By
activating one of the two CoSHy buttons (to the
right of the function key string), you may
install CoSHy commands which will be executed
when the function key is pressed. If the left
button is on, the command will be executed in
the terminal window, if the right button is on,
the command will be executed without windows.
§§_Darstellung§
§
Display
¯¯¯¯¯¯¯
In the "font" box you can specify the fonts used
for wide and small terminals.
CoNnect uses GDOS fonts, but even without GDOS
you may use these fonts by putting them into a
directory named GEMSYS in your CoNnect directory.
CoNnect will load these fonts at start-up time if
no GDOS is installed.
You may also set the cursor type, the kind of
scrolling; smooth scrolling is nice to read
scrolling text, but is very boring after a while
since it is so slow! Fast scrolling is very fast,
but makes it hard to read incoming data.
§§_Protokoll§
§
Capture
¯¯¯¯¯¯¯
Here you may specify the file for capturing your on-line session.
The filename may contain the following characters:
%a short: day of week %p AM/PM
%b short: name of month %S second (00-59)
%d day in month (1-31) %w day in week (0-6)
%H hour (0-23) %W week in year (0-52)
%I hour (0-12) %y short: year (0-99)
%j day in year (1-366) %Y year (0-9999;-)
%m month (1-12) %Z Timezone (eg. MEZ)
%M minute (00-59) %% the %-sign
You may also specify the way of capturing, (complete or ASCII
only) and may set a switch such that CoNnect will ask you at
logoff time, what you want to do with a captured file (save after
logoff).
§§_Emulation§
§
Emulation
¯¯¯¯¯¯¯¯¯
Here you may select the desired emulation.
CoNnect offers you VT52, VT100, VT102, and VT220.
For working in mailboxes, VT102 is recommended.
The other parameters are used to define the
meaning of backspace and delete, and the meaning
of incoming and outgoing linefeeds. Normally
these values need not be changed.
§§_Asciiupload§
§manual§
§
ASCII-Upload
¯¯¯¯¯¯¯¯¯¯¯¯
With ASCII Upload you can send an ASCII
file without any special protocol.
This is useful to enter short pre-typed
messages into a mailbox editor.
Please do not get confused by the large
number of options. Normally, they do
not need to be changed. You will find
further explanations in the manual.
§§_Statistik§
§
Charge Statistics
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
To keep track of your telephone charges,
CoNnect keeps a logfile containing
information about each telephone number
dialled, the duration of the connection
and the money you spent during the
connection. This dialogue offers you a
comfortable way to create statistics out
of this logfile.
Play around with it.
§§_Lernen§
§
Learn a Script
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
CoNnect is able to keep track of the
user activity in a host and create a
CoSHy script which will repeat all
the actions the user performed.
This is especially useful when you
want to create automatic login
scripts or automatic poll scripts.
Here you can activate this learning
mode and select the actions CoNnect
shall keep track of.
§§_Teksetup§
§manual§Handbuch§
§
TEK-Setup
¯¯¯¯¯¯¯¯¯
In the TEK-Setup dialogue, you can configure
your TEK 4014 emulation. As most mailboxes do
not offer this emulation, just leave
everything as it is. Help concerning the TEK-
Mode can be found in the manual. Also, your
system administrator (machines that offer Tek
normally have one!) will be able to help you.
§§_Sound§
§
Sounds
¯¯¯¯¯¯
CoNnect has a built-in facility to co-operate
with the shareware product PAULA, which is
able to play .MOD files. In addition to Paula
in later versions of CoNnect you can specify
.HSN Files for the Sound Player CrazySounds.
You may also specify other sound files -
CoNnect will try to play them itself.
Here you can setup the sound reaction of
CoNnect to certain system events. Just select
the appropriate files by double clicking on
the path entries for the events.
§§_Hotkeys§
§
Hotkeys
¯¯¯¯¯¯¯
Hotkeys are normally used to allow
access to menu items without
selecting them using the mouse.
Here you can select a certain menu
item and press your desired hotkey
for this item.
CoNnect's default hotkey table can
be activated by pressing the
"Default" button.
§§_Farben§
§
Colours
¯¯¯¯¯¯¯
CoNnect uses the first 16 VDI-colours
and assumes they are installed in the
default manner. If this is not true
you may use this dialogue to create a
CoNnect internal colour table.
§§_Anrufbeantworter§
§parameters§_Anrufparameter§
§manual§Handbuch§
§
The Answering Machine
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
This is the CoNnect automatic answering machine,
which enables you to use a Voice Modem as a
private answering machine. Using the CoSHy
Script language you are able to configure this
machine to a more powerful one than the best
commercial hard wired ones available!
By pressing the parameters button you can
configure the answering machine.
Detailed information on the answering machine
can be obtained in the manual.
§§_Anrufparameter§
§manual§Handbuch§
§
Answering Machine Parameters
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Here you can configure the name of the
greeting message a caller gets. Also,
the path for new messages which
callers leave should be set here.
CoSHy commands that are activated when
certain types of calls come in can be
installed here.
Detailed information can be found in
the manual.
§§Fenster§
§help windows§Onlinehilfe§
§misc§_Allgemeines§
§Tektronix windows§Tektronixfenster§
§terminal windows§Terminalfenster§
§window dialogues§Fensterdialoge§
§window menus§Fenstermenü§
§
Windows
¯¯¯¯¯¯¯
CoNnect currently offers four different kinds
of windows to the user. These are:
∙ terminal windows
∙ Tektronix windows
∙ help windows
∙ window dialogues
The first two types have another menu bar in
their top region. These are window menus,
which allow user actions that affect only the
window the option was selected from.
The user interface for window menus and
window dialogues can be configured in the
"Misc." dialogue.
§§Fensterdialoge§
§misc§_Allgemeines§
§sending§Paste§
§selected§Markieren§
§
Window Dialogues
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
CoNnect's window dialogues are an enhancement
of the normal dialogues offered by GEM, since
Atari first released their ST-Computers. The
main difference is the fact, that dialogues
are placed in windows.
There are some other advantages, too. They
allow real multi-tasking under MultiTos or
Mag!x even when dialogues are open. The
windows can be placed anywhere. The menu bar
of CoNnect stays accessible even when a
dialogue is open. You may edit several
dialogues at one time. The dialogues have
some special object types like popups, check
and radio-buttons and hotkeys: you may press
ALT + one of the underlined characters to
select a button as if it was clicked-on by
the mouse.
You may close the dialogue by clicking on the
window closer or pressing the UNDO key. This
is equivalent to clicking on the CANCEL
button - your changes will be lost.
Help can be obtained in any window dialogue
by simply pressing the HELP key. A new window
will open to provide the needed information.
Using the sending mechanism of CoNnect you
may paste selected text parts (or the
contents of the GEM-clipboard - see "misc")
of the terminal window to edit fields of the
dialogue. This is useful if you want to
enter new telephone numbers to the phone
editor.
ASCII characters that cannot be accessed from
the keyboard may be entered using the ALT key
and the numeric keypad. Press the 2 4 9 while
pushing the ALT key down will give you a '∙'.
§§Emulation-Einf§
§emulation§_Emulation§
§
Emulation Introduction
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
CoNnect emulates all incoming characters. It
scans the incoming data stream for special
characters which will not be printable but
give information about the display of the
following printable characters. The data
stream involves information on the position
of characters, their size, what colour they
are displayed in, and more.
You may set the emulation mode to suit the
command set (the emulation) of your host.
§§TastenVersenden§
§CoSHy§CoSHy§
§function keys§_Funktionstasten§
§hotkey§_Hotkeys§
§manual§Handbuch§
§scan table§Scantabelle§
§type ahead buffer§_Vorschreibzeile§
§
Sending Keys
¯¯¯¯¯¯¯¯¯¯¯¯
To send characters to the host,
CoNnect offers many (too many)
possibilities.
∙ Normal Keys
Letters, numbers, spaces, and
special characters will be sent
without translation to the host
(if no scan table is installed).
∙ CONTROL + Keys:
If there is no hotkey for this
combination, then the following
combinations are sent:
^ <space> sends 0
^A sends 1
^B sends 2
...
^Z sends 26
^[ sends 27
^\ sends 28
^] sends 29
^^ sends 30
^_ sends 31
∙ ALTERNATE + Keys:
If there is no hotkey for this
combination, then the following
combinations are sent:
CoNnect will send the
corresponding character with the
highest bit set.
ALT+A sends 193 ($C1)
The numeric keypad has another
meaning in conjunction with
ALTERNATE:
The pressed numbers are combined
to at most 3 digits and their
decimal ASCII value is sent.
ALT+131 Sends: â
∙ Function Keys:
If you have entered a text for
this key in the function keys
dialogue and none of the
corresponding CoSHy buttons is
set, the corresponding text will
be sent.
∙ Backspace, Delete, UNDO, Cursor
Keys, Insert, Home:
The corresponding VT52, VT100,
VT220 meaning will be sent (see
manual).
∙ Pressing CONTROL+INSERT:
The type ahead buffer will
appear to let you enter a line
which will be sent to the host.
With several CoSHy functions you
may also send text and characters
to the modem.
§§Onlinemaus§
§
Working on-line in a full screen editor
like emacs, edt or some other product, you
can use the mouse to place the cursor. Try
double clicking to the desired position
while pressing down the CONTROL key -
CoNnect will TRY to place the cursor on
the right position...
§§Terminalfenster§
§emulation§Emulation-Einf§
§holdscreen§holdscreen-aktiv§
§Keys pressed§TastenVersenden§
§main menu§Hauptmenü§
§select§Markieren§
§terminal menu§Menue-Term§
§use the mouse§Onlinemaus§
§
Terminal Window
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The terminal window is the user
interface for communications with the
host. Keys pressed will be sent to the
host and received characters from the
host will be displayed according to the
emulation used.
If you have enabled scroll bars, and
the history buffer, you may use the
scroll bars to re-read text that has
scrolled out of the current terminal
window.
SEE ALSO: holdscreen
With the terminal menu, you can
configure all terminal specific
parameters of the window that the
terminal menu is in.
The main menu is used to configure the
global settings of CoNnect.
The text in the terminal window can be
manipulated in several ways. You should
select the desired text region first.
You may try to use the mouse in some
on-line editors.
§§Menue-Tek§
§manual§Handbuch§
§
Tektronix Window Menu
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The Tektronix window menu is used for
manipulating the displayed graphics. You may
save these graphics, print them, or choose
another zoom factor. See the manual for more
details.
If you are interested in the Tektronix mode,
please be aware of the fact that nearly all
software able to create Tektronix graphics
is installed on workstations or mainframes.
If you have access to Tektronix software,
please ask your system administrator for
advice. She/He will be able to configure
CoNnect for your hosts specific requests.
§§Tektronixfenster§
§Tektronix menu§Menue-Tek§
§
Tektronix Window
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Here you may open a Tektronix 4014 window where
your host can send you vector graphics. You may
also create drawings with the mouse if your host
has the necessary software installed.
In the upper region of the Tektronix window
there is another menu, the Tektronix menu.
Using the mouse you may zoom into the displayed
graphics by selecting the desired part of the
window. To get back to normal resolution, select
the 'normal resolution' menu item.
§§Fenstermenü§
§main menu§Hauptmenü§
§Tektronix window§Menue-Tek§
§terminal window§Menue-Term§
§
Window Menus
¯¯¯¯¯¯¯¯¯¯¯¯
Window menus are menus where you can
configure local parameters belonging
to a specific window.
SEE ALSO: main menu
terminal window
Tektronix window
Global parameters can be set in the
main menu.
§§gl_Beenden§
§
Quit
¯¯¯¯
This function may cause the immediate
exit from CoNnect. No warranty is
given. Be careful.
§§gl_Öffnen§
§terminal window§Terminalfenster§
§
Open
¯¯¯¯
Using this main menu item, a new window
is opened. If CONN0.SET is available,
the information in this file is used
for the terminals' setup. Otherwise
default parameters are used.
SEE ALSO: terminal window
§§gl_Rotieren§
§
Rotate
¯¯¯¯¯¯
Using the menu item "Rotate", the
current window will become
inactive and the next one in the
window queue will be topped.
§§gl_Schlieβen§
§window dialogue§Fensterdialoge§
§
Close
¯¯¯¯¯
The current window will be
closed. If the current window is
a window dialogue, changes made
to its parameters will be lost.
This function is equivalent to
clicking on the closer of the
current window.
§§gl_Volle_Gröβe§
§
Full Size
¯¯¯¯¯¯¯¯¯
The current window will be set to full
size or, if it is already at full
size, it will be reset to its old
size. This function is equivalent to
the FULLER button of the windows.
§§gl_Fensternamen§
§
Window Names
¯¯¯¯¯¯¯¯¯¯¯¯
The names of the ten last opened
windows are displayed here.
Selecting an item will top the
corresponding window.
§§gl_Optionen§
§
Load and Save Options
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
All settings of the main menu, as well as
the positions and setup files of the opened
terminal windows, will be saved/loaded from
the options (*.OPT) file.
Starting CoNnect will normally cause it to
read the CONNECT.OPT file.
§§Hauptmenü§
§About CoNnect§_Info§
§Charge Statistics§_Statistik§
§Close§gl_Schlieβen§
§Colours§_Farben§
§Full Size§gl_Volle_Gröβe§
§Help§General§
§Hotkeys§_Hotkeys§
§Load Options§gl_Optionen§
§Misc.§_Allgemeines§
§Open§gl_Öffnen§
§Quit§gl_Beenden§
§Registration§_Registrierung§
§Rotate§gl_Rotieren§
§Save Options§gl_Optionen§
§Sound§_Sound§
§Start A Program§Programmstart§
§Start A Script§gl_Scriptstart§
§Start A Shell§gl_Shellstart§
§Start CoSHy§gl_CoSHystart§
§window menus§Fenstermenü§
§Window Names§gl_Fensternamen§
§
The Main Menu
¯¯¯¯¯¯¯¯¯¯¯¯¯
The main menu in CoNnect is the standard
GEM menu bar. Global settings and global
information can be accessed there.
Local parameters of windows can be
accessed in the corresponding window
menus.
In the main menu you will find the
following items.
∙ CoNnect
° About CoNnect
∙ File
° Start A Shell
° Start A Program
° Start CoSHy
° Start A Script
--------------
° Quit
∙ Windows
° Open
° Close
° Rotate
° Full Size
--------------
° 'Window Names'
...
∙ Options
° Registration
° Misc.
° Hotkeys
° Colours
° Charge Statistics
° Sound
--------------
° Load Options
° Save Options
∙ HELP
° Help
§§gl_CoSHystart§
§CoSHy's§CoSHy§
§
CoSHy Start
¯¯¯¯¯¯¯¯¯¯¯
CoNnect's internal Shell can only be started on the
TOS-Screen (without windows) when running a single
tasking TOS. If you are running Mag!X or MultiTOS,
this feature is disabled.
The user will be able to enter commands to CoSHy's
command line and CoNnect will try to execute them.
To exit type exit (and then press return) on the
command line.
§§gl_Scriptstart§
§CoSHy§CoSHy§
§
Start a Script
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
CoNnect's internal Shell can only be started on
the TOS-Screen (without windows) when running a
single tasking TOS. If you are running Mag!X or
MultiTOS this item will be disabled.
Before starting a script, CoNnect will open a
file selector to let you chose the script file.
§§Programmstart§
§
To start an external program this menu item
will open a file selector where the user is
able to select the program to be started.
After the started program has exited you can
continue working in CoNnect.
§§gl_Shellstart§
§manual§Handbuch§
§
TOS-Shell
¯¯¯¯¯¯¯¯¯
Starting a TOS-Shell out of the main menu.
CoNnect tries to start a program that has
been installed as a shell. (Either by using
the _shell_p pointer or the environment
variable $SHELL).
If no shell is installed nothing will happen.
Normally the shell will be started with all
CoNnect windows closed on the TOS-Screen.
Under MultiTOS CoNnect will ask TOSRUN to
start the shell.
(If this help was no help to you due to the
hundreds of misspelled computer words, you
will probably find the manual more helpful,
since it has less spelling mistakes.)
§§Handbuch§
§
Manual
¯¯¯¯¯¯
Every registered CoNnect user will receive a
printed manual automatically. Normally this
won't take more than four days (in Germany)
after the money has arrived. Due to problems
with the printing and new versions of CoNnect
this may take longer than even eight weeks.
Please be patient. We won't forget you. Mail
us to make sure that we have not forgotten you
after about four weeks.
If you are using an older manual, because you
are a long term CoNnect user, you can obtain a
newer version from:
Mail:
-----
Philipp Oelwein
Ringelsgasse 22a
69226 Nuβloch
Electronic Mail:
----------------
Philipp Oelwein @ HD (MausNet)
op@uphys1.uphysn.uni-heidelberg.de (Internet)
The current price is DM 25, plus postage and
packing.
§§Onlinehilfe§
§example§Online-Fett§
§window§Fenster§
§selecting§Markieren§
§
On-line Help
¯¯¯¯¯¯¯¯¯¯¯¯
In this window you can find help for the handling of help windows. The
on-line help can be activated by simply pressing the HELP button whenever
(nearly always) you think a little help could be useful. CoNnect's help
is context sensitive. It will always provide the information you need at
the moment (when working in a certain dialogue, in the terminal window or
on the command line of CoSHy). There is a difference between pressing the
HELP key and activating help in the main menu. The former one is the
context sensitive help whereas the latter will always give you the help
home page.
In the help text you get in the help windows, there may be some
underlined phrases or words written in bold. These are phrases where you
can follow the 'links' by double-clicking on them. Try this now with this
example.
Another useful feature is selecting of help texts. Get information on
this item by double-clicking the highlighted word above.
You may either use the mouse to follow the links in the help window or
use the keyboard to get around.
The following keys have a special meaning in CoNnect's help window:
TAB: - Moves the cursor to the next help item.
SHIFT + TAB: - Moves the cursor to the previous help item.
RETURN / HELP: - Will open a help item if the cursor is
currently positioned on one.
UNDO: - Will go back to the previous help window, or
- if there was none - close the current help
window.
CURSOR KEYS: - Will move the cursor in the standard manner.
SHIFT + CURSOR LEFT:
SHIFT + CURSOR RIGHT: - Will move to the beginning or end of the
current line.
CONTROL + CURSOR LEFT:
CONTROL + CURSOR RIGHT: - Will move to the previous or next word of
the help text.
SHIFT + CURSOR UP:
SHIFT + CURSOR DOWN: - Will move the cursor one page up or down.
HOME: - Will move the cursor to the first line.
SHIFT + HOME: - Will move the cursor to the last line.
§§Markieren§
§send§Paste§
§misc§_Allgemeines§
§quote§quoten§
§;-)§Smiley§
§
Mark
¯¯¯¯
In a text window of CoNnect, (terminal window/help
window), you can select parts of the text using
mouse. You may also want to send the selections to
the host, quote it, or ask the printer to print it.
All this is possible in CoNnect, but you might need
to teach your fingers how to do it.
∙ Selecting Character By Character:
Move the mouse pointer to the beginning of the
text part you want to select. Then press down
the left button and do not lift it again. Now
move the mouse pointer, while keeping the left
button pressed to the end of the text you want
to select. To finish selection, you may now
lift the mouse button again.
∙ Selecting Word By Word
Move the mouse pointer to the word where you
want to start selecting. Now do a double click
- or a single click while pressing the CONTROL
key - and keep the mouse button pressed. Now
moving the mouse pointer while keeping the
mouse button pressed will select text word by
word.
∙ Selecting Line By Line
This is similar to the word-by-word selection.
Just do a triple click (very fast) or keep the
ALTERNATE key pressed while performing the
first click and continue as described above.
To extend a marked portion of text, you may press
the SHIFT key while clicking in the terminal window.
The marked part of the text will be extended up to
the clicked-on position.
Now having selected a portion of text, you may send
this text in a certain window (either a window
dialogue or a terminal window) by 'just' clicking in
this window with the left button, while pressing the
right button down.
If you are using the GEM-Clipboard for selecting
(see the misc dialogue) you may also use your
selections in other applications or may send the
clipboards contents filled by other applications to
the host.
Extended functions, like sending, quoting, file
saving, printing, and others are available if you
(ATTENTION) press the right mouse button down before
lifting the left button to end the selection. Then
lift the left button and afterwards the right. A
little exercise for your fingers! ;-)
§§Paste§
§
Sending Selected Text
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Having selected a portion of text, you may
send this text in a certain window (either
a window dialogue or a terminal window) by
'just' clicking in this window with the
left button, while pressing the right
button down.
§§quoten§
§selected§Markieren§
§
Quoting
¯¯¯¯¯¯¯
Quoting means sending a selected text to the
host with the slight change, that every new
line starts with a ">" character.
Quoting is normally used when answering mail
messages.
For example:
> Do you know the current version
> number of CoNnect?
Sure. But when you receive this letter,
this information will be invalid.
§§Mike§
§
If you are in North America, it might be more
convenient if you send shareware payments to:
Michael Baffoni
2493 Beechwood Dr.
Paso Robles, CA
93446
He will then send along the payments to me
(checks or cashiers' cheque preferred; make them
out to Michael Baffoni).
Email:
mbaffoni@farad.calpoly.edu
§§Solutions§
§
If you live in Great Britain you should contact:
System Solutions
Windsor Business Centre
Vansittart Estate
Windsor Berks SL4 1SE
Tel. 0753 832212
Fax. 0753 830344
for your registration.
§§Wo Registrieren§
§Michael Baffoni§Mike§
§System Solutions§Solutions§
§author§Programmierer§
§
The number of local CoNnect distributors all
over the world is increasing rapidly. As
there have been none last year, now there are
two (an increase of more than 1000%!) ;-).
For North America, contact: Michael Baffoni
For Great Britain, contact System Solutions
Otherwise, you should contact the author of
CoNnect.
A distributor for New Zealand and Australia
is on his way there. :-)
§§_Info§
§country§Wo Registrieren§
§Great Britain§Solutions§
§registrations§_Registrierung§
§shareware§Shareware§
§US§Mike§
§
The info window of CoNnect provides information
about the program CoNnect and its software status
(CoNnect is shareware!), it will also show the
nonregistered user a wonderful looking bar to show
him the elapsed testing time.
If you want to register CoNnect, you should open
the registrations dialogue.
To get information about where to register, check
for your country here. Local distributors are
available in the US and Great Britain.
§§Lächeln§
§;-)§Smiley§
§
CoNnect does not smile at the moment. You
will see this by looking at byte 0x11341
relative to the basepage. This byte should
contain 0x00 when connect is smiling! ;-)
§§Witz§
§author§Programmierer§
§nasty joke on men§männerfeindlich§
§:-)§Smiley§
§
Adam in paradise. He walks around and seems to be a little
unhappy. The lord recognizes this and asks him:
Hi Adam, what's up? Seems to be not your best day...
Adam, quite annoyed, answers:
You! You can talk nonsense like this. You do not have
to bother about the daily boring work like cleaning the
clothes, cooking, dishes, cleaning the paradise,
brushing your teeth, feeding the cat and the crocodile.
All this is done by your angels. But me? I'm not that
happy with this status...
The lord, always having been a kind of bargainer:
Let's see. I think I could help you and give you
someone to help you with all these jobs and who will
give you love and warmth. But this will certainly not
be for free.
Adam, who is suddenly very interested in a good
relationship to his lord:
How much!?
The Lord:
Not that much. Two legs and two arms only.
Adam, shocked:
No, no, no! That's too much. But - what could I get for
///one rib, only?
----------------------------------------------------------
OK. CoNnect excuses itself since it only has five female
users. They are hereby asked to send a nasty joke on men
to the author and he will then add this one to the next
release of CoNnect. :-)
§§Nein§
§
I
think
I
said
so
some
time
ago.
-
Nothing
will
follow
this
text.
§§Rache§
§end§Nein§
§
No text will be found here.
Even if you think there should
be a text on this topic.
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
OK - stop scrolling down.
This really is the end!
§§männerfeindlich§
§...§Rache§
§
Man are like onions,
you remove skin by skin,
and when you come to the point,
you can't help crying.
-----------------------------
You think this joke is funny?
Yes? Tell me a better one
... ;-)
§§Erinnerungshilfe§
§gentle smile§Lächeln§
§joke§Witz§
§
Remember.
This text is intended to remind the user about something.
I just do not know. Let me think.
Just a second...
Right! Always remember that telecommunications is a non-
humorous thing. No one would ever think of making jokes.
Some telecommunications programs even react in a very
harmful manner to jokes made about or with them.
Once a user of a concurrent program tried to fool his
system by telling a joke in French. He didn't know the
system was able to understand French. They still haven't
found him - well, all of him that is.
CoNnect nevertheless will try to react with a gentle smile
on jokes made by you, if and only if it doesn't know the
joke so far and if its humour index is above 0.0001%. But
be aware of the fact, that computers have another kind of
humour than humans have.
§§Shareware§
§author§Programmierer§
§manual§Handbuch§
§police§Polizei§
§to remember§Erinnerungshilfe§
§user§Anwender§
§where to register§Wo Registrieren§
§
Shareware
¯¯¯¯¯¯¯¯¯
CoNnect is shareware, which means you may test and
distribute the program but have to register after
a certain amount of testing time. CoNnect and the
author agree on the fact that 30 hours of using
CoNnect is enough to make the user dependent on
CoNnect and so you should think about registering
quickly. After the 30 hours, work with CoNnect
will not be that easy any more if you did not
register.
For the user's benefit, CoNnect disables some of
its functions. Otherwise, there might be the
danger that the user will work for two years with
an illegal copy of CoNnect and will then notice
it. He then would go the police and would want to
go to jail - this is avoidable. CoNnect helps you
to remember the shareware status, which most users
think to be one of the best features of the
program. ;-)
The registration fee is DM 60 for non-commercial
use and DM 150 for commercial use. On multi-user
systems (like Universities) a multi-user license
for DM 399,- is due. For this fee you will receive
a printed manual and a registration key to make
your CoNnect a registered and unlimited version.
How do you know if you need a commercial version
or not? That's quite easy. If you are using
CoNnect with the aim to make any kind of profit
for yourself or your company, you will need a
commercial registration (the profit made by the
telephone company from CoNnect's use is of course
excluded). The author of CoNnect himself has a
commercial registration, too.
If you are using a non-commercial registration,
you should check if the above lines now apply to
you. In this case you have to upgrade to a
commercial version.
If you live in North America, or in Great Britain,
you will find information on where to register
here.
§§Anwender§
§;-)§Smiley§
§
The user is the one sitting in front of this help
text at the moment. This will be in most instances
you. Some users do not even know they are users
and this text is intended to help them to get
several problems solved with their lives and with
their user-status. Only those users who really are
aware of their user status will be able to pay for
CoNnect - so remember - YOU ARE A USER! ;-)
§§Smiley§
§
Wow. You just found a smiley in the help
text. Congratulations, this was the
first time a user has found this item.
To look at smileys (and frownies) you
have to turn your head 90 degrees left:
:-) a smiling smiley
:-( a frowning frowny
:'-( a frowny with tears in his eyes
;-) a sarcastic smiley
...
§§Polizei§
§green dot§Grünen§
§
Police:
¯¯¯¯¯¯¯
Men and women with more or less nice uniforms,
sometimes without uniforms but never (!) without
clothes (as this is illegal in most parts of the
world, even where its not illegal a police
officer will never be seen without clothes).
Usually they drive around in nice and fast cars
and have much fun in making criminals angry. In
Germany policemen wear green uniforms (but
without a green dot on them).
§§Grünen§
§
The Green Dot
¯¯¯¯¯¯¯¯¯¯¯¯¯
CoNnect's cover is totally recyclable.
It consists of 80% recycled bits and
90% pizza. So, you may put a green dot
on CoNnect.
As the green dot is a German-only joke,
you are not supposed to understand this
help page. ;-)
§§_Allgemeines§
§CoSHy§CoSHy-Allg§
§terminal windows§Term-Allg§
§window dialogues§Fens-Allg§
§GEM-clipboard§Klemm-Allg§
§
The Miscellaneous Dialogue
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
In this dialogue you can set global parameters
concerning the terminal windows, window dialogues,
the GEM-clipboard, and CoSHy.
§§CoSHy-Allg§
§selected§pathsel§
§manual§Handbuch§
§
Misc.
¯¯¯¯¯
Parameters concerning CoSHy in the "Misc."
dialogue.
∙ The CoSHy start-up file (normally
COSHY.RC) can be selected here
∙ The start-up directory can also be
selected. See the manual for further
information.
§§Term-Allg§
§
Terminal Windows
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Parameters concerning the terminal windows in the
"Misc." dialogue.
Here you can determine if text windows are always
placed on a horizontal position that can be
divided by eight. This will speed up the display
if you do not own NVDI. You may also configure
the window menus to be either Atari-like drop-
down menus or Mac-like pull-down menus.
§§Fens-Allg§
§
Windows in General
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Parameters concerning window dialogues in the
"Misc." dialogue.
You can decide if dialogues open in the centre
of the screen, at the last position or centred
according to the current mouse position.
Frames around certain elements of the dialogues
have titles. You may specify here how you want
them to look.
In a common GEM-Dialogue, RETURN and ENTER are
used to leave the dialogue as if the user had
clicked on the default button. CoNnect may also
use this key like in an editor to jump to the
next dialogue text input field.
Finally you can select the background pattern
and colour. Be aware of the fact that an
arbitrary colour will look like white when no
pattern is selected. ;-)
§§Klemm-Allg§
§select§Markieren§
§paste§Paste§
§
Clipboard Introduction
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Parameters concerning the GEM-clipboard in the "Misc." dialogue.
You can specify here if all selected texts will automatically be
placed in the GEM-clipboard and if the clipboard will be read if
you try to paste a text to the host.
§§pathsel§
§
Path & File Input
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
In all dialogues where CoNnect wants to have a filename
in an editable input field, you may double-click on the
editable line to use the file selector for locating and
selecting the lines content.
§§Online-Fett§
§
Highlighted Text
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Now you are reading the text page for highlighted
text. This page does not provide any useful
information (only spelling mistakes), so leave it
by pressing the UNDO key.
§§CoSHy§
§About This Help§COSHYHLP\ABOUTME§
§Actions On A Command Line§COSHYHLP\INPWORK§
§Command Delimiters§COSHYHLP\KMDTR§
§Debugging§COSHYHLP\DEBUG§
§Explanation of CoSHy Commands§COSHYHLP\COMMANDS§
§General Usage§COSHYHLP\A§
§Input/Output Redirection§COSHYHLP\IOREDIR§
§Listing of CoSHy Commands§COSHYHLP\LIST§
§Meta-Characters§COSHYHLP\METAS§
§Misc.§COSHYHLP\OVERALL§
§Quotes§COSHYHLP\QUOTES§
§Overview Of The Commands§COSHYHLP\OVERALL§
§Words§COSHYHLP\WORTE§
§
CoSHy
¯¯¯¯¯
You get into CoSHy either by activating the
interactive mode (the "CoSHy" menu item) or by
activating the script mode where CoSHy will start
to run a script file.
This help will be useful for you in creating
scripts. The largest part of this help consists of
the description of a number of available internal
commands. To get an overview of CoSHy it would be
a good idea to read the manual, but if you have
some UNIX shell programming experience, this will
also help. CoSHy is a UNIX like shell
environment.
0.0 About This Help
1.1 General Usage
1.1.1 Meta-Characters
1.1.2 Words
1.1.3 Command Delimiters
1.1.4 Input/Output Redirection
1.1.5 Quotes
1.1.6 Debugging
1.2 Actions On A Command Line
1.3 Overview Of The Commands
1.3.1 Listing of CoSHy Commands
§§COSHYHLP\ABOUTME§
§General Usage§COSHYHLP\A§
§
0.0 About This Help
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The help text to CoSHy was created by Stephan
Skrodzki and myself, (the author of CoNnect and
bad translator of the help texts). I wish to
express my thanks to Stephan for his work.
If you did not understand his German (see the
German on-line help texts), you may at least want
to thank him for his work. His internet mail
address is:
stephan_skrodzki@ka.maus.de
Next Chapter:
1.1 General Usage
§§COSHYHLP\A§
§Meta-Characters§COSHYHLP\METAS§
§quote§COSHYHLP\QUOTES§
§
1.1 General Usage
¯¯¯¯¯¯¯¯¯¯¯¯¯
After starting CoSHy in interactive mode you will
get a command line where you can enter commands in
the command language of CoSHy. In addition to
CoSHy internal commands, you may want to use
external tools. Starting external programs is
quite easy; just type their names (paths) and
append parameters delimited by spaces. If you are
using the environment variable PATH CoSHy will
evaluate its content to search for external
programs.
If you want a UNIX-like environment, it is
recommended that you install the tools like ls,
echo, cat, mkdir, cp (and others) in your /bin
directory and set a PATH pointer to this
directory.
ATTENTION:
In contrast to TOS pathname delimiters (\),
CoNnect uses UNIX pathname delimiters (/).
If your external programs need "\" in their
arguments, you will have to quote the "\".
CoShy is able to perform TAB expansions!
An attempt is made to expand the first word on the
command line as a command. The directory pointed
to by the $PATH variable is searched for matching
executables. For example, type "lha<TAB>" and if
you have an LHARC.TTP installed on your system and
$PATH points to the directory where it resides,
you will get "lharc" on the command line. If there
are several possible expansions, CoSHy will expand
up to the first difference in the names. Say you
have printenv and printall on your system and type
in "pri<TAB>", you will get print<BEEP>. A second
<TAB> will then show you all possible expansions
in the next line:
printall printenv
If you try to expand a parameter to a command,
CoSHy will do this in the same way, but not search
in $PATH and not for executables only but all
files.
Next Chapter:
1.1.1 Meta-Characters
§§COSHYHLP\METAS§
§Words§COSHYHLP\WORTE§
§
1.1.1 Meta-Characters
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Meta-characters are characters that separate words
on a command line when non-quoted. They are
<space>, <tab>, <newline>, &, |, ;, < and >.
Next Chapter:
1.1.2 Words
§§COSHYHLP\WORTE§
§Command Delimiters§COSHYHLP\KMDTR§
§
1.1.2 Words
¯¯¯¯¯
A word is a string between two non-quoted spaces.
Meta-characters may also be contents of a word but
only if quoted.
The examples below all have one word per line:
hello
hello\ Pete
hello\ two lines, but one word!
you
'Hello You'
Hello' 'You
hello" You"
"Hello\"\ \"You"
Next Chapter:
1.1.3 Command Delimiters
§§COSHYHLP\KMDTR§
§Input/Output Redirection§COSHYHLP\IOREDIR§
§
1.1.3 Command Delimiters
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The following characters do separate commands if
they are not quoted.
Character: Meaning:
; Normal
<newline> Normal
& Like ";" (No background tasks, sorry!)
| Pipe. Example:
cmd1 | cmd2.
The output of cmd1 will become the
input of cmd2. Return value is the one
of cmd2.
&& AND. Example:
cmd1 && cmd2
The command cmd2 is executed if, and
only if, cmd1 has a return value of
true (0). Returns false (1) or the
return code of cmd2.
|| OR. Example:
cmd1 || cmd2.
The command cmd2 is executed if and
only if cmd1 has a return a value of
false (1). Returns true or the return
code of cmd2.
Next Chapter:
1.1.4 Input/Output Redirection
§§COSHYHLP\IOREDIR§
§Quotes§COSHYHLP\QUOTES§
§
1.1.4 Input/Output Redirection
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
cmd < file The command cmd will get its input
from the file 'file' and not from
the keyboard.
cmd > file The command cmd writes its output
to file. The previous contents of a
possibly existing file will be lost.
cmd >> file The command cmd appends it's output
to file.
Next Chapter:
1.1.5. Quotes
§§COSHYHLP\QUOTES§
§Debugging§COSHYHLP\DEBUG§
§
1.1.5 Quotes
¯¯¯¯¯¯
To remove the special meaning of characters, you
may quote them:
\ (Backslash): "\" is the escape character of
the shell and removes a special meaning from any
directly following character. To obtain a "\"
you will have to enter "\\".
' (Single Quote): All characters, even all
other quote characters loose their special
meaning when found between single quotes.
Between '...' no expansion is performed. The
single quote cannot be found in between '...' as
it always ends a single quotation.
" (Double-Quote): All characters but `
(backquote), ' (single quote), $ (dollar sign)
and \ (back slash) loose their special meaning.
Whereas, and $ always keep their special meaning
this is true for \ only if the following char is
a $, ', " or <newline>. You may enter a " in
between "..." by placing a \ in front of it:
"here it is \"."
Next Chapter:
1.1.6 Debugging
§§COSHYHLP\DEBUG§
§Actions On A Command Line§COSHYHLP\INPWORK§
§
1.1.6 Debugging
¯¯¯¯¯¯¯¯¯
To activate CoSHy's debug mode, use
the command:
set -x
All commands passed to CoSHy will
then be displayed in completely
expanded form before execution.
To switch debugging off, just enter:
unset -x
Example:
c:\> set -x
c:\> echo *.acc
+ echo gszrz.acc xcontrol.acc
gszrz.acc xcontrol.acc
c:\> unset -x
+ unset -x
c:\>
Next Chapter:
1.2 Actions On A Command Line
§§COSHYHLP\SPECPAR§
§
Special Parameter Substitution
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
${parameter}
The value of parameter is substituted.
The braces are required when parameter
is a positional parameter with more
than one digit, or when parameter is
followed by a character which is not
to be interpreted as part of its name.
In each of the cases below, word is subject
to parameter expansion, command substitu-
tion, and arithmetic expansion.
CoSHy tests for a parameter that is unset
or null; omitting the colon results in a
test only for a parameter that is unset.
${parameter:-word}
Use Default Values. If parameter is
unset or null, the expansion of word
is substituted. Otherwise, the value
of parameter is substituted.
${parameter:=word}
Assign Default Values. If parameter is
unset or null, the expansion of word
is assigned to parameter. The value of
parameter is then substituted.
${parameter:?word}
Display Error if Null or Unset. If
parameter is null or unset, the expan-
sion of word (or a message to that ef-
fect if word is not present) is writ-
ten to the standard error and the
shell, if it is not interactive,
exits. Otherwise, the value of para-
meter is substituted.
${parameter:+word}
Use Alternate Value. If parameter is
null or unset, nothing is substituted,
otherwise the expansion of word is
substituted.
${#parameter}
The length in characters of the value
of parameter is substituted.
${parameter#word}
${parameter##word}
The word is expanded to produce a pat-
tern just as in pathname expansion. If
the pattern matches the beginning of
the value of parameter, then the ex-
pansion is the value of parameter with
the shortest matching pattern deleted
(the ``#'' case) or the longest mat-
ching pattern deleted (the ``##''
case).
${parameter%word}
${parameter%%word}
The word is expanded to produce a pat-
tern just as in pathname expansion. If
the pattern matches a trailing portion
of the value of parameter, then the
expansion is the value of parameter
with the shortest matching pattern de-
leted (the ``%'' case) or the longest
matching pattern deleted (the ``%%''
case).
§§COSHYHLP\INPWORK§
§expr§COSHYHLP\EXPR§
§extensions§COSHYHLP\SPECPAR§
§Overview of the Commands§COSHYHLP\OVERALL§
§
1.2 Actions On A Command Line
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Each command line evaluated by CoSHy undergoes
a special sequence of steps.
* Separation In Words
* Bracket Expansion
* Parameter & Variable Substitution
* Command Substitution
* Arithmetic Substitution
* Separation In Words (Again!)
* Path Expansion
* Quote Removal
A more detailed description follows below:
Separation of Words:
Words are consecutive characters which are
separated by non quoted meta-characters. As
long as a command is not completely read in,
CoSHy will read the next line or prompt the
user to input another line.
Example:
ls -l /usr Consists of 3 words; 'ls', '-l'
and '/usr'.
Bracket Expansion
Each word of a complete command will be
searched for pairs of brackets. Single non-
quoted brackets will not be tolerated on a
command line.
Those words then will consist of prefix,
bracket, and postfix.
Example:
abc{defgh,ij}klmno
abc = Prefix
{defgh,ij} = Bracket
klmno = Postfix
The words in brackets are separated by commas
and for all of the words z1 to zn, all words.
prefix'z1'postfix
prefix'z2'postfix
:
prefix'zn'postfix
Will be generated and inserted in the command
line instead of the bracket expression.
Example:
bla{bli,blo}bla This will produce the words
blablibla and blablobla.
{Britta,Sonya}' and '{Pet{er,ra}}
This will be: Britta and Peter
Britta and Petra
Sonya and Peter
Sonya and Petra
Parameter & Variable Substitutions
Each word will be searched for $name or
${name}. If name is a shell variable, its
content will be replaced for $name or ${name}.
Otherwise, this expression will be deleted.
The second form is used to separate name from
possibly following characters: $names won't
bring the wanted results, whereas ${name}s
does. ${n} will also allow larger numbers than
9 for n.
The second form also denoted some extensions.
Special CoSHy Variables
$n Where n is a value between 0 and 9.
<or>
${n} Where n is a value between 0 and
32767, and is the n-th parameter
given to a function or a script.
$0 is the name of the function or
the script.
$# Number of parameters given to a
function or a script.
$? Status/Return value of the last
called process/command.
$@ The parameters of the called script
or funktion. If $@ is expanded in
between "" the expansion will be
performed like
"$1" "$2" "$3"
$* The parameters of the called script
or funktion. If $@ is expanded in
between "" the expansion will be
performed like
"$1 $2 $3"
The character between the arguments
(here space) can be modified using
$IFS.
Command Substitution
Each word is searched for $(cmd) or `cmd`. The
command cmd is executed and its output will
replace the above expressions. $() expressions
may be nested, `` expressions may not.
Example:
editor $(grep -l double *.c)
This calls an editor with the parameters being
all *.C-Files containing the word double.
Grep is an external file utility.
a=$(expr $a + 1)
This increments the value of "a" by one.
Arithmetic Substitution.
Each word is searched for $[ expression ]. The
'expression' is passed to the expr command and
its output will replace the $[ expression ].
Example:
a=$[ $a + 1 ] is equivalent to
a=$(expr $a + 1) and increments a by one.
Separation Of Words (Again!)
All new inserted text parts are subject to an
additional separation into words.
Example:
a='ls -l /usr' This contains only one word.
$a The variable "a" will consist
of three words after this
step.
Path Expansion
Valid filenames containing wildcard
characters will be expanded:
*.c Expands to all *.C filenames in
the current directory.
*o* Expands to all filenames
containing the letter o in the
current directory.
*[ch] Expands to all filenames that end
with c or h in the current
directory.
[a-d]* Expands to all files that start
with a, b, c or d in the
current directory.
[^a-d]* Expands to all files that do not
start with a, b, c, and d in the
current directory.
/*/*.c Expands to all *.C filenames one
directory level away from the
root directory of the current
drive.
*a*/*b*/*c* This is just a joke, but works:
Expands to all filenames that are
Two levels above the current
working directory, where the
first directory name has the
letter a in it, the second has
the letter b in it and the
filename contains a 'c'.
Next Chapter:
1.3 Overview of the Commands
§§COSHYHLP\OVERALL§
§Listing of CoSHy Commands§COSHYHLP\LIST§
§
1.3 Overview of the Commands
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Please take note: All internal commands
concerning a particular terminal window
or the serial port are not available
while running CoSHy on the TOS screen.
Assigning Variables
A special internal command has the
structure name=value. The value will be
assigned to the shell variable name.
Internal & External Commands
If internal and external commands of the
same name are available CoShy will use
the internal command. Please use the
form /path/cmd to access the external
one.
If a command is not available as an
internal command, CoSHy scans the
environment (not the shell) variable
$PATH where it should find directories
to access external commands. To change
the value of $PATH, you will also have
to export this value to the environment.
PATH='c:/,c:/bin/'
export PATH
Next Chapter:
1.3.1 Listing of CoSHy Commands
§§COSHYHLP\LIST§
§[ expression ]§COSHYHLP\AUSDRUCK§
§# ...§COSHYHLP\TRUE§
§! ...§COSHYHLP\NOT§
§. ...§COSHYHLP\SCRIPT§
§alert§COSHYHLP\ALERT§
§alias§COSHYHLP\ALIAS§
§baud§COSHYHLP\BAUD§
§bell§COSHYHLP\BELL§
§blitmode§COSHYHLP\BLITMODE§
§break§COSHYHLP\BREAK§
§cd§COSHYHLP\CD§
§carrier§COSHYHLP\CARRIER§
§case§COSHYHLP\CASE§
§ctty§COSHYHLP\CTTY§
§dial§COSHYHLP\DIAL§
§download§COSHYHLP\DOWNLOAD§
§echo§COSHYHLP\ECHO§
§env§COSHYHLP\ENV§
§eval§COSHYHLP\EVAL§
§exit§COSHYHLP\EXIT§
§expr§COSHYHLP\EXPR§
§false§COSHYHLP\FALSE§
§fileselect§COSHYHLP\FILESEL§
§fky§COSHYHLP\FKY§
§flush§COSHYHLP\FLUSH§
§for§COSHYHLP\FOR§
§function§COSHYHLP\FUNCTION§
§get§COSHYHLP\GET§
§getkey§COSHYHLP\GETKEY§
§gettone§COSHYHLP\GETTONE§
§hangup§COSHYHLP\HANGUP§
§holdscreen§COSHYHLP\HOLDSCRN§
§if§COSHYHLP\IF§
§log§COSHYHLP\LOG§
§noise§COSHYHLP\NOISE§
§Overview Of The Commands§COSHYHLP\OVERALL§
§play§COSHYHLP\PLAY§
§prot§COSHYHLP\PROT§
§quit§COSHYHLP\QUIT§
§read§COSHYHLP\READ§
§readkey§COSHYHLP\READKEY§
§record§COSHYHLP\RECORD§
§redraw§COSHYHLP\REDRAW§
§savebuf§COSHYHLP\SAVEBUF§
§scantable§COSHYHLP\SCANTABLE§
§send§COSHYHLP\SEND§
§sendbreak§COSHYHLP\SENDBREAK§
§set§COSHYHLP\SET§
§setenv§COSHYHLP\SETENV§
§shift§COSHYHLP\SHIFT§
§sleep§COSHYHLP\SLEEP§
§slot§COSHYHLP\SLOT§
§test§COSHYHLP\TEST§
§true§COSHYHLP\TRUE1§
§unalias§COSHYHLP\UNALIAS§
§unset§COSHYHLP\UNSET§
§upload§COSHYHLP\UPLOAD§
§version§COSHYHLP\VERSION§
§waitfor§COSHYHLP\WAITFOR§
§while§COSHYHLP\WHILE§
§
1.3.1 Listing of CoSHy Commands
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
[ expression ] # ... ! ... . ...
alert alias baud bell
blitmode break cd case
carrier ctty dial download
echo eval exit expr
false fileselect fky flush
for function get getkey
gettone hangup holdscreen if
log noise play prot
quit read readkey record
redraw savebuf scantable send
sendbreak set setenv shift
sleep slot test true
unalias unset upload version
waitfor while
§§Environment§
§cd§COSHYHLP\CD§
§
CoSHy Environment Variables
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Here you find a list of environment variables used by
CoNnect:
∙ PATH
The access path for CoSHy program calls. The paths
are separated by , or ;
Example:
PATH=c:/usr/bin,c:/bin,c:/etc
∙ PROMPT
The default prompt for CoSHy. %p%g will give you a
dos like command prompt.
Possible Elements:
∙ %p the current directory
∙ %g the sign >
∙ %t the current time
∙ else the given character
∙ COLUMNS
The number of columns for a default terminal.
CoNnect also sets this variable when calling
external programs running in a CoNnect window.
∙ LINES
The number of rows for a default terminal. CoNnect
also sets this variable when calling external
programs running in a CoNnect window. If lines is
not available, CoNnect will try to evaluate ROWS.
∙ SHELL
A pathname for an external TOS-Shell.
∙ HOME
The home path will be branched to, when calling cd
without arguments.
c:/connect> HOME='c:/home'
c:/connect> export HOME
c:/connect> cd
c:/home>
∙ CDPATH
The syntax is equivalent to PATHs one. cd will
search the given path names for possibilities to
branch to if a given directory name can not be
found in the current directory:
c:/connect> CDPATH='c:/usr;c:/'
c:/connect> cd bin
c:/usr/bin> cd usr
c:/usr>
∙ SUFFIX
A comma separated list of extensions CoSHy searches
for, if you name an external program without
extension that has to be started.
Default: 'prg,tos,app,ttp,gtp'
∙ GEMSUFFIX
A comma separated list of extensions where CoSHy
switches the mouse pointer on before starting the
application.
Default: 'prg,app,gtp'
∙ CLIPBRD
CoNnect tries in several ways to determine the
GEM-clipboards name. First it will try scrp_read(),
if this fails CLIPBRD is evaluated. If this still
fails CoNnect try to open C:\CLIPBRD. In the next
step it will ask the user.
§§COSHYHLP\ALERT§
§
Command alert
¯¯¯¯¯¯¯¯¯¯¯¯¯
alert <defaultbutton> <alertstring>
This displays a GEM alert box. The
parameters are the parameters of
the gem function form_alert().
§§COSHYHLP\ALIAS§
§
Command alias
¯¯¯¯¯¯¯¯¯¯¯¯¯
alias cmd replace
This will replace <cmd> in all commands
beginning with <cmd> by <replace>.
To delete an alias, you can use:
alias cmd <or> unalias cmd
Example: alias l 'ls -l'
This will execute an "ls -l" if "l" is
entered on the command line.
§§COSHYHLP\BAUD§
§port dialogue§_Port§
§
Command baud
¯¯¯¯¯¯¯¯¯¯¯¯
baud [rate] [options]
This will display the current baud rate.
If rate is given, the current port will
be set to this rate.
Options:
echo : Echo on
noecho : Echo off
local : Echo local
rts : rts/cts Hardware-Handshake
xon : xon/xoff Software-Handshake
none : no Handshake
8N1 : 8 data bits, no
parity, 1 stop bit
7E1 : 7 data bits, even
parity, 1 stop bit
6O2 : 6 data bits, odd
parity, 2 stop bits
5N3 : 5 data bits, no
parity, 1.5 stop bits
etc...
Example:
baud 38400 This will set the rate
to 38400 baud.
SEE ALSO: port dialogue
§§COSHYHLP\BELL§
§noise§COSHYHLP\NOISE§
§sound dialogue§_Sound§
§
Command bell
¯¯¯¯¯¯¯¯¯¯¯¯
bell n
This will create very beautiful sounds! ;-)
The following values for n are available.
1: Bing 2: Bang
3: Crash 4: Ring
5: Call 6: Accord
Why? To tease your cat, or to let you know if
a transmission has finished, or a script is
now waiting for user input, or ...
Example:
bell 3 This will make a "crash" sound.
SEE ALSO: noise, sound dialogue
§§COSHYHLP\BLITMODE§
§
Command blitmode
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
blitmode [option]
This command displays the current
blitter status.
y - Blitter is on
n - Blitter is off
u - Blitter is unavailable
Options:
y switches the blitter on
n switches the blitter off.
§§COSHYHLP\BREAK§
§
Command break
¯¯¯¯¯¯¯¯¯¯¯¯¯
break n
This will break out of n nested if,
case, for, or while structures. If
n is omitted, it will be set to one.
Example:
if [expr1]; then
if [expr2]; then
cmd1
else
cmd2
break 2
fi
cmd3
fi
A break level of 2 is needed because
both if structures are to be left.
§§COSHYHLP\CARRIER§
§
Command carrier
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
carrier
This returns 0 (true)
if the modems sends
the carrier signal, or
1 (false) otherwise.
Example:
if carrier; then
hangup
fi
Hangup, if there is a
carrier.
§§COSHYHLP\CASE§
§
case word in
[ pattern [ | pattern ] ... )
list ;; ] ...
esac
A case command first expands word, and
tries to match it against each pattern
in turn. When a match is found, the
corresponding list is executed. After
the first match, no subsequent matches
are attempted. The exit status is zero
if no patterns are matches. Otherwise,
it is the exit status of the last com-
mand executed in list.
Example:
case $box in
*Maus*) echo wir sind in einer Maus ;;
*) echo wir sind in keiner Maus ;;
esac
§§COSHYHLP\CD§
§$CDPATH§Environment§
§$HOME§Environment§
§
Command cd
¯¯¯¯¯¯¯¯¯¯
cd path
Change the current directory to path. The
variable $HOME is the default directory. The
variable $CDPATH defines the search path for the
directory containing path. Alternative directory
names are separated by a comma or a semicolon.
If path begins with a slash (/), then $CDPATH is
not used. The variable $OLDPWD is set to the
name of the current working directory before the
change.
Example:
cd connect Changes to the directory
CoNnect.
§§COSHYHLP\CTTY§
§character set dialogue§_Zeichensatz§
§compatibility dialogue§_Kompatibilität§
§emulation dialogue§_Emulation§
§
Command ccty
¯¯¯¯¯¯¯¯¯¯¯¯
ctty [options]
This changes several terminal parameters.
Options:
VT52
VT100
VT102
VT220-7 switches to the corresponding
VT220-8 terminal emulation.
VT52id
VT100id
VT101id
VT102id
VT220id the same for the terminal id.
cursnum normal cursor keys
cursappl application cursor keys
keypadnum numeric keypad
keypadappl application keypad
crlflf incoming <lf>s are expanded to <cr><lf>
lflf no expansion of <lf>
crcrlf outgoing <cr>s are expanded to <cr><lf>
crcr no expansion of <cr>
bsdel del (delete) will be sent
as bs (backspace) and bs
will be sent as del.
bsbs bs and del have their original
meaning.
Atari Atari character set and 'umlaute'
ISO ISO character set and 'umlaute'
autowrap auto wrap is active
-autowrap auto wrap is disabled
smooth use smooth scrolling
-smooth use fast scrolling
colour display ANSI colours
-colour do not use ANSI colours
strip8 strip the highest bit
-strip8 use all 8 bits.
destructive destructive backspace
-destructive normal backspace
SEE ALSO: emulation dialogue,
character set dialogue
compatibility dialogue
§§COSHYHLP\DIAL§
§dialling dialogue§_Wahl§
§time format§COSHYHLP\TIMEFORM§
§
Command dial
¯¯¯¯¯¯¯¯¯¯¯¯
dial [opt] number
Dials a given phone number. Normally this will be a
text (the text of a phonebook entry in the dialling
dialogue). If there is no matching text, the number
is dialled as it is (containing all symbols in it).
NOTE: If the text in the phonebook entry
contains spaces, you should put the
<number> argument in quotes ' '. You
may also just give the first few
letters of the telephone book entry.
CoSHy searches for matching entries.
Options:
-z seq <seq> becomes the reset string. <n> is
-r n the number of tries CoSHy will do to
get a carrier. n=0 is used for infinite
tries.
-s tim <tim> is the time between consecutive
tries (time format).
-i ini <ini> becomes the init string.
-d dia <dia> becomes the dial string.
-v Verbose.
-n will display the real number for a given
phonebook entry. But will not dial.
number either phonebook entry or real number.
Returns:
0 Connect 3 Busy 4 reserved
5 No Carrier 6 No Answer 7 No Dialtone
8 Error 9 Ring 10 Userdef
11 Timeout
Example:
dial -s 10s -r 5 0623760897
SEE ALSO: dialling dialogue
§§COSHYHLP\DOWNLOAD§
§file transfer dialogue§_Transfer§
§
Command download
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
download [-p path] [filename]
A file will be received with the options set in the
file transfer dialogue. A filename may be given if
you want to override the files filename or if you
are using a protocol where the filename itself is
not transmitted (like X-modem). The option -p path
is used to specify a certain path where the
incoming file should be placed.
Example:
download -p 'f:\dfue\'
§§COSHYHLP\ECHO§
§
Command echo
¯¯¯¯¯¯¯¯¯¯¯¯
echo [-n] arg1 ...
This will write all its
arguments separated by
spaces to standard out.
If -n is omitted a
linefeed is appended.
Example:
echo "hallo"
§§COSHYHLP\ENV§
§environment§Environment§
§setenv§COSHYHLP\SETENV§
§
Command env
¯¯¯¯¯¯¯¯¯¯¯
env [arg1 ...]
Without arguments, the environment variables
will be displayed. If arguments are given,
env is equivalent to setenv.
§§COSHYHLP\EVAL§
§
Command eval
¯¯¯¯¯¯¯¯¯¯¯¯
eval command
This will execute the given command in
CoSHy and will NOT stop the execution of a
running script, if an error in execution of
the command should occur.
Using eval you may write a 'remote' script
to run on your computer and you may dial in
from outside to work on CoSHy's command
line.
Example:
while true; do
while true; do
send 'Remote Script'
send -n 'please enter password :'
get -n pass
if [ $pass = 'joshua' ]; then
break 2
fi
done
while true; do
send -n 'Your Input >'
get a;
if ! carrier; then
break 2
fi
echo "$a";
eval "$a" > AUX:
done
done
§§COSHYHLP\EXIT§
§
Command exit
¯¯¯¯¯¯¯¯¯¯¯¯
exit n
The current shell level is left. Shell
level might also be a script file, in
which case execution will be stopped if
an exit is executed. The return value of
the source or . command that executed the
script will be n or 0 if n is omitted.
§§COSHYHLP\SCANTABLE§
§scan table§Scantabelle§
§
Command scantable
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
scantable [filename]
This will read in and execute
a scan table file if filename
if given. Otherwise, a loaded
scan table will be deleted.
§§COSHYHLP\EXPR§
§
Command expr
¯¯¯¯¯¯¯¯¯¯¯¯
expr expression
This will evaluate an expression and put the
result to standard out. If you put the command
in $( ) or in ` ` (backquotes) you may use the
result to fill other variables (see example
below). The return value of expr is true (0) if
the result is not 0 and false (1) if the result
is 0 or the expression contains errors.
Each part of expression has to be a single
argument.
There are the following operations (in order of
hierarchy).
| OR: The result is the result of its
first argument if this is not zero.
Otherwise, and only otherwise, the
second argument is evaluated and the
result of the expression is set to
the one of the second argument.
& AND: The result is the result of its
first argument if this is zero.
Otherwise, and only otherwise, the
second argument is evaluated and the
result of the expression is set to
the one of the second argument.
< <= != => >: Compare its arguments and
return 1 if the relation is
true, 0 otherwise (do not mix
this up with the shell value
for true(0) and false(1)). If
the arguments are non-numeric
the comparison is done for
alphabetical order.
+ -: Plus and minus; both arguments have
to be numeric. The result is the
result of the corresponding numeric
operation.
* / %: Multiply, divide, and mod; both
arguments have to be numeric and the
result is again the result of the
corresponding numeric operation.
In all operations brackets may be used to change
operators hierarchy. Take care to quote them
correctly as ( ) are shell symbols also.
Example:
expr \( 3 + 2 \) \* 2
Writes 10 to STDOUT.
`expr 3 + 2`
This will replace the result of
the expression ` ... ` with 5
and tries to execute the command
5. This normally will fail! :-)
a=`expr 3 + 2`
a=$(expr 3 + 2)
Here, "a" will be set to the
value of 5.
a=$(expr $a + 1)
Here, "a" will be increased by 1.
b=`expr \($a +1 \) \* $a`
Here, "b" will be set to the
value of (a+1)*a.
§§COSHYHLP\AUSDRUCK§
§test§COSHYHLP\TEST§
§
Command expression
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
[ expression ]
The expression is evaluated like in the
test command. In fact CoSHy will
replace this construction by:
test expression.
Example:
[ $v -gt $w ] Test if the value of $v
is higher than the value
of $w. The return code
will be 0 for true or
not 0 for false.
§§COSHYHLP\FALSE§
§true§COSHYHLP\TRUE§
§
Command false
¯¯¯¯¯¯¯¯¯¯¯¯¯
false
Will return false (1) as return value.
It is equivalent to "!true".
Example:
false
echo $?
§§COSHYHLP\FILESEL§
§
Command fileselect
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
fileselect <pfad> <default name>
<extension> <message>
This calls the gem file selector. The
return value is true (0) if the user
has pressed OK to leave the selector.
The chosen filename will be found in
the variable $FILESELECT.
§§COSHYHLP\FKY§
§function key dialogue§_Funktionstasten§
§
Command fky
¯¯¯¯¯¯¯¯¯¯¯
fky [opt] num [value]
This command displays or sets function keys.
Options:
-c CoSHy script key (the left coshy button).
-n CoSHy script key (the right coshy button).
-o Will display the old content to stdout.
If value is given, the specified key will be
set to the value. num is the same as in the
function key dialogue.
Example:
send `fky -o 1`
Sends the contents of function key F1.
§§COSHYHLP\FLUSH§
§
Command flush
¯¯¯¯¯¯¯¯¯¯¯¯¯
flush
This command will remove all pending characters
in the IO-Buffer of the SERIAL/MIDI device.
§§COSHYHLP\FOR§
§
Command for
¯¯¯¯¯¯¯¯¯¯¯
for name in list;
do cmd1; cmd2; ...
done
For every word in list, the value of $name
is set to this word and the commands cmd1,
cmd2, ... between do and done are executed.
Example:
for a in 1 2 3 4 5 6 7 8 9
do
echo $a
done
This will display the numbers 1 to 9.
§§COSHYHLP\FUNCTION§
§
Command function
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
function name { commands }
This command defines a function named name.
The commands will be executed always when
name is executed. Arguments to name may be
given and will be found in $1, $2 ...
Examples:
function doubleecho {
echo $1 ;
echo $1
}
doubleecho HELLO
This will result in:
HELLO
HELLO
function name
This will delete the function named name.
function
This will display all defined functions.
§§COSHYHLP\GET§
§eval§COSHYHLP\EVAL§
§read§COSHYHLP\READ§
§time format§COSHYHLP\TIMEFORM§
§waitfor§COSHYHLP\WAITFOR§
§
Command get
¯¯¯¯¯¯¯¯¯¯¯
get <opt> <timoutval> <var1> <var2> ..
This is equivalent to the read command. The
input is not typed in on the keyboard but is
taken from the serial port. There you will have
the possibility to get input from the host (or
remote) side. (See example of the eval command).
The first parameter may be -n which will force
get not to send an echo of the typed in text
(useful for password inputs).
With -v (verbose) the typed in text will be
displayed in CoNnect's terminal window. -c will
cause get to return 2 on carrier loss.
A numerical value <timeoutval> may follow to
limit the user's response time. If a timeout
occurs, get will result in false (1).
SEE ALSO: time format, waitfor
The variables var1, var2, ... will be filled
like in read.
§§COSHYHLP\GETKEY§
§time format§COSHYHLP\TIMEFORM§
§
Command getkey
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
getkey [-n] [-c] [-v] [timeout] var1 [ var2 ... ]
This will read as many characters from the serial
port as variables are given. If -v is set, this
characters will be displayed on CoNnect's screen.
If -n is set this characters are not echoed to the
remote side.
A given timeout value will cause getkey to return
false if the remote user did not enter the desired
number of keys in the time timeout value.
SEE ALSO: time format
-c will cause getkey to return 2 on carrier loss.
§§COSHYHLP\GETTONE§
§answering machine§_Anrufbeantworter§
§
Command gettone
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
gettone <timeoutval> <var>
Reads in a touchtone sequence while in the
answering machine mode. The sequence has
to be ended by # by the user.
SEE ALSO: answering machine.
§§COSHYHLP\HANGUP§
§dialling dialogue§_Wahl§
§'hangup'§T\HANGUP§
§
Command hangup
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
hangup
Will force the modem to hangup. How this
is done has to be specified by the user in
the dialling dialogue.
Example:
if carrier; then
hangup
fi
Hangup is equivalent to the terminal menu
item 'hangup'.
§§COSHYHLP\HOLDSCRN§
§function key§holdscreen-aktiv§
§
Command holdscreen
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
holdscreen [parameters]
This command toggles - if no parameters are given
- between hold screen on and off. Watch the hold
screen LED in the terminal menu.
Set on the function key F1, F1 will satisfy the
VT100/220 standard.
Possible parameters are 1 or activate hold screen
or 0 to deactivate it.
§§COSHYHLP\IF§
§
Command if
¯¯¯¯¯¯¯¯¯¯
if cmd1; cmd2; ...; then
cmd3; ...;
[else
cmd4; ...;]
fi
The commands between if and then are
executed, where the return value of the
last command is important for the further
proceeding. If this is true (0) the
commands between then and else (or fi if
else is omitted) will be executed. If it
is false (1) the commands between else and
fi are executed. The else branch may be
omitted.
Example:
if cmd1; then If the return value of
echo "Yeah! ;-)" cmd1 is 0, a message of
else success is printed.
echo "damn ;-(" If not, the script won't
fi be happy.
§§COSHYHLP\LOG§
§capture dialogue§_Protokoll§
§echo§COSHYHLP\ECHO§
§prot§COSHYHLP\PROT§
§
Command log
¯¯¯¯¯¯¯¯¯¯¯
log [-n] text
Write a text to the capture files (if
such a file is opened by the terminals
capture dialogue or the prot command).
The syntax is equivalent to echo.
SEE ALSO: prot, capture dialogue
§§COSHYHLP\NOISE§
§bell§COSHYHLP\BELL§
§
Command noise
¯¯¯¯¯¯¯¯¯¯¯¯¯
noise filename ...
This command plays a filename by
activating the .MOD player Paula
or using DMA-Sound.
If neither Paula is installed nor
DMA available you may use bell as
a last chance to produce noise.
§§COSHYHLP\NOT§
§
Command !
¯¯¯¯¯¯¯¯¯
! cmd ...
Executes cmd and negates the return code.
True becomes false and vice versa.
In contrast to Unix shells the argument
to | may not be a pipe.
Example:
if ! cmd1 | cmd2; then UNIX
if cmd1 | ! cmd2; then CoSHy
§§COSHYHLP\PLAY§
§answering machine§_Anrufbeantworter§
§
Command play
¯¯¯¯¯¯¯¯¯¯¯¯
play name
Plays a voice modem file. Output device
and voice mode have to be set first.
Returns:
0 Successful
1 Successful (Truncated Message)
2 Modem Not Voice Modem.
3 Timeout
4 Fax Call
5 DTMF-Code Received
6 Data Call
10 Modem Is Old ZyXEL
11 CoNnect Not Registered (RECORD ONLY)
12 Voice-Mode Not Active
-1 File Write Protected
-2 File Not Found
-5 Output Error
-12 Out Of Heap
-13 No File Access
-28 Disk Full
The value of $DTMF will be set to the
received digit in case a DTMF code was
received.
SEE ALSO: answering machine
§§COSHYHLP\PROT§
§capture dialogue§_Protokoll§
§
Command prot
¯¯¯¯¯¯¯¯¯¯¯¯
prot [options] [filename]
Options:
-on : Capture on, Ascii-Mode
-asc : Capture on, Ascii-Mode
-bin : Capture op, Binary-Mode
-off : Capture off.
(Default -on)
-dist : Select the capture file after
carrier loss.
-nodist: Write always to the specified
file.
filename: name of the capture file
(only -on, -asc, -bin)
SEE ALSO: capture dialogue
§§COSHYHLP\QUIT§
§
Command quit
¯¯¯¯¯¯¯¯¯¯¯¯
quit <val>
Quits CoNnect. CoSHy is terminated and
all windows are closed. <val> is the
return code CoNnect will return to the
calling process. Default val is 0.
§§COSHYHLP\READ§
§
Command read
¯¯¯¯¯¯¯¯¯¯¯¯
read name [name2 ...]
Uses STDIN (normally the keyboard) to read in a
string and divides it (regardless of quoting!)
into parts containing no spaces or tabs. The
parts are then assigned to the variables name,
name2, ... If there are less parts then
variables the last variable will be assigned
all missing parts.
Example:
read bbs; dial $"bbs"
This reads is a bbsname and starts dialling in.
§§COSHYHLP\READKEY§
§timeout value§COSHYHLP\TIMEFORM§
§
Command readkey
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
readkey [-v] [timeout] var1 [var2...]
Reads as many characters as there are
variable names (var1, var2,...) from the
keyboard and assigns the keystrokes to the
given variable. If a timeout value is
given, readkey will return false (1) if
the user needs too long to enter the keys.
If the option -v is set, readkey will
echo its input on the terminal screen.
§§COSHYHLP\RECORD§
§answering machine§_Anrufbeantworter§
§
Command record
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
record filename
Gets a voice file from a Voice Modem and writes
it to filename.
Returns:
0 Successful
1 Successful (Message Too Long -- Truncated)
2 Modem Not Voice Modem
3 Timeout
4 Fax Call
6 Data Call
10 Modem Is Old ZyXEL
11 CoNnect Not Registered
-1 Read Only File
-2 File Not Found
-5 Write Error
-13 File Access Refused
-28 Disk Full
SEE ALSO: answering machine
§§COSHYHLP\REDRAW§
§
Command redraw
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
redraw
This command redraws the whole screen
before the next interactive entered
command or if the script exits.
§§COSHYHLP\SAVEBUF§
§'save buffer'§T\SAVPUF§
§
Command savebuf
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
savebuf [-a] filename
Saves the history buffer to a file filename.
If option -a is set, the buffer is appended to
a possibly existing file.
This command is useful before starting an
external editor:
Example:
Set a function key to:
savebuf d:/s.txt; cd c:/edit; edit d:\\s.txt
Click on the left coshy button.
Savebuf is similar to the terminal menu
function 'save buffer'.
§§COSHYHLP\SCRIPT§
§
Command . (Script)
¯¯¯¯¯¯¯¯¯
. file arg1 arg2 ...
Runs a file as a CoSHy Script. The
command is the dot, so between .
and file there has to be a space.
Following arguments are assigned to
the values $1 to $n. $0 is always
set to the name of file.
Example:
. maus Runs a script maus or if
the maus is available the
script MAUS.SCR.
§§COSHYHLP\SEND§
§echo§COSHYHLP\ECHO§
§
Command send
¯¯¯¯¯¯¯¯¯¯¯¯
send [-n] arg1 arg2 ....
Is similar to echo, but writes its arguments
to the serial device.
Example:
send "at z1" Send Hayes command for modem
reset to profile 1.
§§COSHYHLP\SENDBREAK§
§'sendbreak'§T\BREAK§
§
Command sendbreak
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
sendbreak
On the current port a 'break' will be sent
(0.7s $00 without start or stop bits).
This command is equivalent to the action
'sendbreak' in the terminal menu.
§§COSHYHLP\SET§
§
Command set
¯¯¯¯¯¯¯¯¯¯¯
set arg1 val1 arg2 val2 ...
Without arguments the shell variables are
shown. Otherwise, identical to arg1=val1;
arg2=val2; ... (this is not a good Unix set!).
Example:
set HLP 'C:\' Sets the shell variable HLP
to 'C:\'.
§§COSHYHLP\SETENV§
§environment variables§Environment§
§
Command setenv
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
setenv arg1 val1 arg2 val2 ...
The environment variables arg1, arg2 ...
are assigned to the values val1, val2 ...
Shell variables are not changed in any way
by this operation, only $?.
Example:
setenv ROWS 24
SEE ALSO: Environment Variables
§§COSHYHLP\SHIFT§
§
Command shift
¯¯¯¯¯¯¯¯¯¯¯¯¯
shift m
Moves the values of the shell variables $1,
... $n to the left; m determines the number
of moves. It defaults to 1 if m is omitted.
The return code is false (1) if m > n.
Example:
shift 3
§§COSHYHLP\SLEEP§
§time format§COSHYHLP\TIMEFORM§
§
Command sleep
¯¯¯¯¯¯¯¯¯¯¯¯¯
sleep [-t] n
Waits a given time n ( n is in the
CoSHy time format).
If option -t is used, n is the time of
day to wait for.
Example:
sleep 120 Waits 120 sec.
sleep 2H Waits 2 h
sleep -t 730 Waits until 7:30am
§§COSHYHLP\SLOT§
§Transfer Dialogue§_Transfer§
§
Command slot
¯¯¯¯¯¯¯¯¯¯¯¯
Without arguments, this command
prints the current transfer slot.
Using slot n (n between 1 and 8)
can be used to set the current
transfer slot.
SEE ALSO: Transfer Dialogue
§§COSHYHLP\TEST§
§[ expr ]§COSHYHLP\AUSDRUCK§
§if§COSHYHLP\IF§
§while§COSHYHLP\WHILE§
§
Command test
¯¯¯¯¯¯¯¯¯¯¯¯
test expression
Returns either true (0) or false (1)
depending of the evaluation of the relations
in expression.
Possible relations are:
Expression: returns true if:
-d file file exists and is a directory.
-f file file exists and is a normal file.
-r file file exists and is readable.
-s file file length is not zero.
-t fd fd is opened on a tty. If fd is
omitted it defaults to 1 (stdout).
-w file file exists and is writeable.
-z string length of string is 0.
-n string length of string is > 0.
str1=str2 str1 and str2 are identical.
str1!=str2 str1 and str2 not identical.
!expr1 expr1 is false.
expr1 -a expr2
expr1 and expr are true
expr1 -o expr2
expr1 or expr2 are true
arg1 OP arg2
an arithmetical comparison
between arg1 and arg2.
Values for OP:
-eq equal
-ne not equal
-lt less than
-le less or equal
-gt greater than
-ge greater or equal
arg1 and arg2 should be integers.
The command test can use brackets to set
operator hierarchy.
If the command [ expr ] is found, test is
called.
The result of test, normally is used in if or
while statements. It can also be found in $?.
Example:
test 1 -gt 4 returns false
[-f connect.prg] should return true in
CoNnect's directory.
test -z "" returns 0 (true).
§§COSHYHLP\TIMEFORM§
§
CoSHy Time Format
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
You can specify the following units
in time format.
s = Second
m = Millisecond
M = Minute
H = Hour
h = Centisecond
Example:
sleep 42H Waits 42 hours.
§§COSHYHLP\TRUE§
§
Command # text
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
This command always returns true. It can
be used as a comment.
Example:
# quit (Quit will not be executed
as it is a comment.)
§§COSHYHLP\TRUE1§
§false§COSHYHLP\FALSE§
§
Command true
¯¯¯¯¯¯¯¯¯¯¯¯
Always returns true. Identical
to !false.
Example:
true (Returns '0')
echo $?
§§COSHYHLP\UNALIAS§
§alias§COSHYHLP\ALIAS§
§
Command unalias
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Removes an alias definition.
unalias alias name
§§COSHYHLP\UNSET§
§
Command unset
¯¯¯¯¯¯¯¯¯¯¯¯¯
unset arg1 arg2 ...
All variables in the command line will be
unset (deleted).
Example:
unset a PATH
The variables "a" and "PATH" will be
deleted. The environment variables "a"
and "PATH" will stay untouched.
§§COSHYHLP\UPLOAD§
§Transfer Dialogue§_Transfer§
§
Command upload
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
A file will be uploaded using the parameters in
the Transfer Dialogue. If filename is missing a
file selector will be opened to let you chose
your selection. If you are using an external
protocol, a given filename will replace the $
sign in the command line to this programs.
The option -p will allow you to setup a default
upload path.
Example:
upload 'c:\test\infile.txt'
SEE ALSO: Transfer Dialogue.
§§COSHYHLP\VERSION§
§
Command version
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The command version will display the
current number of CoNnect. Normally,
this function will not get in trouble,
if the version number changes while
the command is executed.
§§COSHYHLP\WAITFOR§
§time§COSHYHLP\TIMEFORM§
§
Command waitfor
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
waitfor [-s -c -i -o file -t time] string1
string2 ... string20
Waits until one of the strings appended as
parameters to waitfor occurs in the incoming
data stream or the timeout is reached.
If no timeout occurs waitfor returns true (0).
In addition the variable WAITID is set to the
string number received (1 - ...) and WAITSTR
is set to the string received. While waiting
all characters received will be displayed on
the terminal screen unless the parameter -s
(silent) is set.
The following options are known to waitfor:
-s silent - just waiting - not output -
-c returns 2 on carrier loss.
-i Incoming data is scanned regardless
of upper and lower case.
-t time timeout value.
-o file appends all incoming data to file.
Example:
if waitfor -t 60 'CONNECT' 'BUSY'
'NO CARRIER'; then
if [ $WAITID = 1 ] ; then
echo 'we got CoNnected'
else if [ $WAITSTR = 'BUSY' ]; then
echo 'Busy'
else
echo 'something very funny'
fi
fi
fi
§§COSHYHLP\WHILE§
§
Command while
¯¯¯¯¯¯¯¯¯¯¯¯¯
while cmd1; cmd2; ...; do
cmd3; ...;
done
All commands between while and do are
executed and if the return code of
the last command is true (0) the
commands between do and done are
executed. Then proceeding starts
again until the last command between
while and do returns false.
Example:
while [$a -ne 0]
do
a='expr $a - 1'
b='expr $b + 2'
done
§§Edithelp§
§
CoNnect On-line Help Editing
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
On-line help in CoNnect needs two files: CONNECT.HLP
and CONNECT.IDX. If you want to edit help texts (to
remove the lots of spelling and grammar mistakes),
you will have to change CONNECT.HLP only. CoNnect
will fix the index file itself.
If you have corrected parts of the help file, I
really ask you to send them to me. I will then
apply them to the next release.
Help entries start with the line (a help marker).
§§Help Entry§
Note: When reading this help, the L dot will appear
as a § character.
Where Help Entry is an arbitrary marker and can be
used for referencing this help text. Below this line
are the references.
§Test§Help-Test§
§Test2§Help-Test2§
§
The end of the references is marked by a single § on
the next line.
Below the help text can be found where all phrases
which are equal to the first string in a reference
will be bold and underlined to show the user that
this word or phrase is linked to another help text
which can be reached by double-clicking on it.
Selecting such an item will cause CoNnect to show
the suitable help text that has a help marker equal
to the second string in the reference.
§§Neues2.0n§
§
The information regarding changes
in releases 2.00, 2.01 and 2.02,
has not yet been supplied. Please
contact the author for this.
§§Neues2.10§
§Character Set§_Zeichensatz§
§history buffer§_Puffer§
§scan table§COSHYHLP\SCANTABLE§
§
New in 2.10
¯¯¯¯¯¯¯¯¯¯¯
∙ CoNnect now has a HyperText-like context sensitive
on-line help. This will be helpful for all the
beginners in using this program as most complaints
are concerned with the large number of possible
settings.
∙ CoNnect got an internal X-, Y-, Z-Modem protocol.
Get more information, by opening the transfer
dialogue and pressing HELP there. CompuServe B and
B+ are also supported internally.
∙ Finally, you are now able to see the history buffer
in an extra window. All selecting and clipping stuff
works fine there too.
∙ CoNnect got some so called scan tables. They may be
used to define any key of the Atari keyboard.
Using this feature you can easily implement the
doorway mode to have remote control over a PC
running the doorway program.
A doorway scan table can be found in this archive.
∙ The Type Ahead Buffer (CONTROL+INSERT) will now stay
open till its window is closed.
∙ Redrawing TEK-windows is a lot faster, due to the
fact that I needed it myself. ;-)
∙ Status reports of the TEK-mode are now suppressible.
This will be a useful feature for VMS-users.
∙ 115200 Baud on TT's Serial2, on the Falcon and
MegaSTE's MODEM2 and SERIAL2 ports.
∙ Preparations for Mag!X (1.11 and 2.0).
∙ The dialling dialogue now has colour icons.
∙ Pressing SHIFT and double-clicking an phonebook
entry will activate a continuous dial for one
specific number.
∙ Placing "^" in the dialling sequence will pull down
DTR for 700MS.
∙ CONNECT.NUM + Entries
+t 15.0 Time the modem needs to get a carrier after
the other side has taken up the phone.
+T 5.0 Time a carrier must be present to make
CoNnect think it was a real carrier.
+u DM Unit of your money - probably $ or £.
NUM.DOC provides lots of useful information about
the programming of CONNECT.NUM!
∙ Using the compatibility dialogue you can now set
<LF> to clear screen.
∙ MultiTOS:
Drag and Drop: CoNnect will start uploading when
you drop files on its windows.
∙ Money (Philipp's request) can be found in the
terminal menu.
∙ A new special character for dialling strings:
@ escapes the next character.
@~ does not delay but sends ~
@@ sends @
∙ Real-time slider in the dialling dialogue.
§§Neues2.20§
§from keyboard§Wahltastatur§
§
New in 2.20
¯¯¯¯¯¯¯¯¯¯¯
∙ PC Colours are supported finally. See the
compatibility dialogue for details.
∙ Output speed has increase up to a factor
of 30%.
∙ Bug fixes in the Tek 4014 emulation.
∙ Problems with voice recording and HS-Modem
/mint fixed.
∙ New help text: Operating the dial dialogue
from keyboard.
∙ On some MultiTOS Versions CoNnect didn't
work on the Falcon. Use one of the
following lines in your MINT.CNF:
setenv MODEMDEV U:\DEV\AUX
setenv MODEMDEV U:\DEV\MODEM1
setenv MODEMDEV U:\DEV\MODEM2
One of them is supposed to give good results,
even on your Falcon.
∙ Like Mupfel, CoSHy now supports the
environment variables SUFFIX and
GEMSUFFIX. In case you call a GEM program,
the mouse will be visible. Otherwise, not.
setenv SUFFIX 'prg,tos,app,ttp,gtp'
setenv GEMSUFFIX 'prg,app,gtp'
∙ CoNnect now supports the XSDD block device
drivers for serial I/O.
∙ Error 131, which showed up when 'No
Multi-tasking' was active is removed now.
§§Neues2.40§
§get§COSHYHLP\GET§
§getkey§COSHYHLP\GETKEY§
§mouse in on-line editors§Onlinemaus§
§waitfor§COSHYHLP\WAITFOR§
§case§COSHYHLP\CASE§
§$* and $@§COSHYHLP\INPWORK§
§extensions to parameter substitution§COSHYHLP\SPECPAR§
§
New in 2.40
¯¯¯¯¯¯¯¯¯¯¯
∙ The upgrade to CoNnect 2.40 is not free DM 10,--)
for the first time.
∙ Help System updated.
∙ On-line time display does not flicker.
∙ CompuServe B and B+ finally work. Thanks to
CompuServe Munich for the friendly support.
∙ Scripts run a lot faster now.
∙ Z-Modem Autostart works fine now when you are
using the internal Z-Modem - even if the terminal
window is in the background (lots of Mag!X users
asked for that).
∙ After a file transfer the correlated terminal
window will top automatically.
∙ Z-Modem Upload got lots of faster. TT->TT runs at
15000cps (under Mag!X 2.0).
∙ Mouse interrupts are now disabled when enabling
the box: 'No Multi-tasking' during file transfers.
∙ Multiple file up/download will now have a better
display in the transfer window.
∙ Crazy Sound will now co-operate with CoNnect and
vice versa.
∙ You can use the mouse in on-line editors.
∙ The ALT key becomes more emacs19 friendly. M->,
M-< and M-C-x finally work.
∙ The new HS-Modem is supported. Users not able to
install the new HS-Modem due to a lack of English
docs, should at least remove the old HS-Modem from
their autofolders as this one will bomb CoNnect.
∙ Transfer priorities became flexible. Windows are
more easy to use when a transfer is in progress.
∙ 'Z-Modem rename' changed! Now the old file will
become renamed. The received file will keep
it's name.
∙ get, getkey and waitfor got a new parameter (-c)
to enable carrier checking in these commands.
∙ Adaptions for WinX 2.3 (still beta).
∙ Remarkable output speed improvements.
∙ These Background windows allow blinking text and
blinking cursors.
∙ CoNnect will no longer open all ports but only the
ones selected by the user.
∙ Severe bugs handling the new HS-Modem were solved.
∙ Bug in Scan tables removed. Bug made entries with
less than 3 fields useless.
∙ Some bugs in the Falcon Tos don't cause trouble
any more.
1) Io-Redirection
2) Touching of read-only files.
∙ Scripts are running as an own CoNnect process now.
This means multitasking while CoNnect is working
on a script.
∙ Even in scriptmode the internal dialog box for the
file transfer is shown.
∙ Enhancements to vt220.
∙ CR is now mapable on CRLF in the input stream,
too.
∙ echo $( ls *.c | wc -l ) Files
did not work as there was a bug in piping in
command substitutions.
∙ Voice modems of type TIA TR29.2 are supported
∙ CoSHy got a new command: case
∙ A new 'LED' in the terminal's menu bar indicates
an active CoSHy.
∙ Two new special parameters for the CoSHy:
$* and $@
∙ new extensions to parameter substitution
were introduced: ${parameter:+word} ...
° CompuServe B and B+ work again. Versions
2.40 - 2.45 had another bug implemented.
∙ ZModem 8K blocks. This option is non
conformant with the OMEN protocol and
therefore not with DSZ but works fine
with GEMSZRZ and some unix implementations.
∙ The internal file transfer protocols now
write statistics information into CONNECT.LOG
which can again be evaluated in the
charge statistics dialog.
§§History§
§Changes up to 2.10§Neues2.10§
§Changes in 2.20§Neues2.20§
§Changes in 2.4x§Neues2.40§
§
History
¯¯¯¯¯¯¯
We hope you are using CoNnect 2.0 or
higher because otherwise reading this
history will not be much fun for you.
Regarding version 1.96, CoNnect 2.20
has got a lot of improvements.
Changes up to 2.10
Changes in 2.20
Changes in 2.4x
§§Preisliste§
§where to register§Wo Registrieren§
§
The current shareware fees for CoNnect (valid
until 1.3.1993) can be found in this table:
| commercial | non commercial |
------------------------------------------------
Key & | DM 150,- | DM 60,- |
Manual | $ 110,- | $ 50,- |
| £ 65,- | £ 29,95 |
------------------------------------------------
Key & | DM 170,- | DM 65,- |
Manual &| $ 125,- | $ 55,- |
Disk | £ 70,- | £ 33,- |
------------------------------------------------
From foreign| (s.oben) | (s. oben) |
countries | + DM 10,- | + DM 10,- |
to germany | | |
------------------------------------------------
How do you know if you need a commercial version
or not? That's quite easy. If you are using
CoNnect with the aim to make any kind of profit
for yourself or your company, you will need a
commercial registration (the profit made by the
telephone company from CoNnect's use is of
course excluded). The author of CoNnect himself
has a commercial registration, too ;-)
If you are using a non-commercial registration,
you should check if the above lines now apply to
you. In this case you have to upgrade to a
commercial version.
It is always important where to register. Check
here for local distributors.
§§Updates§
§author§Programmierer§
§
Updates for CoNnect will be published from
time to time. They usually involve bug
fixes as well as new features.
As the key system provides a good facility
for registered users to download a new
version and run a unlimited copy of
CoNnect, I would like to continue with
this system.
If you do not find a new version of
CoNnect in your local bbs, you may want
to contact the author for an update.
In this case you have to send him:
1) An empty formatted disk (3.5" DD).
2) An envelope with your address on it.
3) DM 5,- (or equivalent).
4) + enough money for postage.
If one of these four points is missing you
can be sure not to get any response...
§§Fehler§
§
Bugs
¯¯¯¯
I have tried to release CoNnect with as few
errors as possible but CoNnect is software so
there will certainly be some bugs which were not
found until the date of release... Please inform
the author if you think you have found a bug.
This is a kind of cookbook on how to proceed in
such a case.
a) Try to reproduce the bug without AUTO folder
and ACCs.
b) If the bug is not present in case a), try to
find the guilty AUTO-PRG or ACC.
c) Write a bug report. This should contain:
∙ the version of CoNnect.
∙ a description of your system, (TOS-Version,
Memory, etc).
∙ a statement saying either the bug is still
present using a) or specifying the guilty
component of b) above.
∙ and a DETAILED description how to reproduce
the bug.
Following these instructions you can be sure
to receive an answer soon.
§§General§
§here§Onlinehilfe§
§CoSHy§CoSHy§
§Main Menu§Hauptmenü§
§Terminal Menu§Menue-Term§
§Tektronix Menu§Menue-Tek§
§Creating Help Files§Edithelp§
§shareware§Shareware§
§Bug Reports§Fehler§
§Changes In Previous Releases§History§
§price§Preisliste§
§
This is the on-line help for CoNnect.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Do not forget that CoNnect is a shareware
product. It is not freeware or public
domain - you have to pay to use it.
If you want to learn something about the
help system, please double-click here.
Other help may be obtained for:
CoSHy
Main Menu
Terminal Menu
Tektronix Menu
Changes In Previous Releases
Bug Reports
Creating Help Files
Check for all CoNnect features first and then
compare them to CoNnect's incredible low price.