ÝÝMenue-TermÝ
ÝCharacter SetÝ_ZeichensatzÝ
ÝCompatibilityÝ_Kompatibilit„tÝ
ÝFunktion KeysÝ_FunktionstastenÝ
ÝDisplayÝ_DarstellungÝ
ÝCaptureÝ_ProtokollÝ
ÝEmulationÝ_EmulationÝ
ÝASCII-UploadÝ_AsciiuploadÝ
ÝAnswering MachineÝ_AnrufbeantworterÝ
ÝLearn a ScriptÝ_LernenÝ
ÝTEK ParametersÝ_TeksetupÝ
ÝFile TransferÝ_TransferÝ
ÝTabulatorÝ_TabulatorÝ
ÝStatus LineÝ_StatuszeileÝ
ÝTerminal SizeÝ_SizeÝ
ÝPortÝ_PortÝ
ÝDialÝ_WahlÝ
ÝSend BreakÝT\BREAKÝ
ÝTerminal ResetÝT\RESETÝ
ÝCommun. ResetÝT\KRESETÝ
ÝHangupÝT\HANGUPÝ
ÝFix SetupÝT\FIXSETÝ
ÝLoad SetupÝT\LOASETÝ
ÝSave SetupÝT\SAVSETÝ
ÝClear ScreenÝT\CLRSCRÝ
ÝClear BufferÝT\CLRPUFÝ
ÝSave BufferÝT\SAVPUFÝ
ÝTOS-ShellÝT\TOSSHELLÝ
ÝTEK 4014 WindowÝTektronixfensterÝ
ÝCoSHyÝCoSHyÝ
ÝScriptÝCoSHyÝ
ÝUploadÝT\UPLOADÝ
ÝDownloadÝT\DOWNLOADÝ
ÝReplayÝT\REPLAYÝ
ÝCopy BufferÝ_PufferÝ
Ý
Terminal Menu

The terminal menu includes the following 
items:
---------------------------------------...
   Terminal           Setup
---------------------------------------...
   File Transfer      Emulation
   Terminal Size      Character Set
   Terminal Reset     Display
   Commun. Reset      Capture
   Hangup             Tabulator
   Clear Screen       Port
   Clear Buffer       Function Keys
   Save Buffer        Compatibility
   Copy Buffer        Status Line
   Send Break         TEK Parameters
                      Fix Setup
                      Load Setup
                      Save Setup

...------------
   Misc
...------------
   CoSHy
   Script
   Learn a Script
   TOS-Shell
   TEK 4014 Window
   Answering Machine
   Dial
   ASCII-Upload
   Upload
   Download
   Replay

ÝÝT\UPLOADÝ
Ýfile transfer dialogÝ_TransferÝ
Ý
Upload

Using the menu item Upload... you can send
a file with the parameters specified in the
file transfer dialog.

ÝÝT\DOWNLOADÝ
Ýfile transfer dialogÝ_TransferÝ
Ý
Download

Using the menu item Upload... you can receive
a file with the parameters specified in the
file transfer dialog.

ÝÝT\REPLAYÝ
ÝemulationÝ_EmulationÝ
ÝUploadÝT\UPLOADÝ
ÝASCII-UploadÝ_AsciiuploadÝ
Ý
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 installed. Use the environment variable 
$SHELL or the _shell_p pointer to install one.

ÝÝ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\SENDBREAÝ
Ý
Send a Break.

CoNnect sends the so called Break Signal
to the modem.

See also sendbreak (CoSHy command).

ÝÝT\RESETÝ
ÝFix SetupÝT\FIXSETÝ
ÝSave SetupÝT\SAVSETÝ
ÝLoad SetupÝT\LOASETÝ
Ý
Terminal Reset.

The terminal will be reset to the values
of last Fix Setup, Save Setup or Load Setup.

ÝÝT\CLRSCRÝ
Ý
Clear Screen

The current window will be cleared.

ÝÝT\KRESETÝ
ÝholdscreenÝholdscreen-aktivÝ
Ý
Communication Reset.

All characters pending in the IO-queue
will be discarded. A possible state of
holdscreen will be cleared.

ÝÝT\HANGUPÝ
ÝDialÝ_WahlÝ
ÝhangupÝCOSHYHLP\HANGUPÝ
Ý
Hangup.

The modem will be forced to hang up the phone.
The way this  is done can be set up in the
Dial dialog. 

See also: hangup (CoSHy command)

ÝÝT\FIXSETÝ
Ýterminal resetÝT\RESETÝ
Ý
Fix Setup

All current setup settings will be fixed for
a later terminal reset.

ÝÝT\LOASETÝ
ÝSave SetupÝT\SAVSETÝ
Ý
Load Setup

will load a terminal setup, saved by
Save Setup, from disk.


ÝÝT\SAVSETÝ
Ýterminal menuÝMenue-TermÝ
ÝLoad SetupÝT\LOASETÝ
ÝFix SetupÝT\FIXSETÝ
ÝDialÝ_WahlÝ
Ý
Save Setup

The current terminal settings will be
saved to disk. Terminal settings
are all possible settings that can be
done within the terminal menu. There
is one exception to this rule: Telephone
numbers in the Dial dialog are stored 
in the telephone-book. Only the name of
this telephone file will be stored in
setup.

Using Load Setup, you can reload a
saved setup.

Before a Save Setup is executed, 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 an extra window while
your dataflow in the terminal window is
running.

Using the buffer window you can have all
the possibilities in selecting, sending,
... like in the terminal window. Sending
text will send them to the buffers port.

ÝÝ_WahlÝ
ÝclipboardÝKlemmbrettÝ
Ýtrash canÝPapierkorbÝ
Ýmodem parameterÝModemparameterÝ
Ýphone editorÝT-EditorÝ
Ýload numbersÝT-LadenÝ
Ýsave numbersÝT-LadenÝ
Ý
In the dialing dialog you find the 
'telephone book' on the right hand side and 
the 'repeated dial memory' on the left hand 
side. Dragging numbers from the telephone 
book to the dial memory will repeatedly 
dial all the numbers in this memory after the 
telephone icon has been clicked on.

Inbetween there are many icons to manipulate the
telephone book or modem settings. On top there is the
phone editor, followed by load numbers, save numbers
and the sorter icon. In the bottom line there are the
trash can, the clipboard and two modem parameter icons.
Finally above the 'repeated dial memory' there is  
the telephone icon.

Using the mouse.
----------------

By clicking on items in the telephone book, you may
select these items. Doing this while pressing the
SHIFT key will append the new item to a selection.
On the left hand side of the telephone book you also
may create a rubber box to select several items at once.
Clicking on the left hand side will deselect all
entries. The handling of the 'memory' box is 
identical.

Adding items to the memory is done by dragging these
from the telephone book to the memory (dragging:
moving the mouse with the left button pressed).

Deleting items in the telephone book or in the memory
is done by dragging them to the trash can. In the 
memory a double click on an item will cause the number 
to be dialed and then delete it from the list after a
connection is made.

By dragging items within the telephone book or the 
memory you may change the order.

The most important icon: The telephone.

Clicking on the telephone will cause CoNnect to start
dialing the numbers within the memory. This dialing
will be continued until a connection can be established
or a user definable event (see modem parameter) occurs.

Dragging an item onto the the telephone icon will
cause CoNnect to start a single dial-in attempt.

Double-Clicking an item in the telephone book while 
pressing SHIFT will start dial attempts to this number
until a connection is established.

ÝÝT-LadenÝ
Ý
The two disk-like icons are used to save and load
telephone books.

Loading a telephone book will replace the old one
if the SHIFT key is not pressed. If you hold the SHIFT 
key then the new book will be appended to the old one.

The same applies for saving. Saving the book will 
delete a file. If the SHIFT key is pressed then the 
book will be appended to this file.

ÝÝT-EditorÝ
Ý
The Phone Editor

In this editor you may change the data in your 
telephone book.

Clicking on the editor icon without any telephone
book item selected will allow you to create 
a new entry to your telephone book.

Dragging one or more already available entries to 
this icon will allow you to modify these items.

The telephone number is the number you have to dial
to get a line to a given bbs. The reset and the init
string are of similar meaning. They contain strings
to setup your modem before dialing starts. The dial
string itself (normally ATD#|) starts the dialing
sequence.

All three strings my contain 3 special characters:

| to produce a carriage return
~ to wait for 0.5 second
^ to pull DTR to low for 0.5 seconds

You may also enter a login script to run an automatic
login script to your bbs if the connection is
established.

The info button enables you to add some 
information to an entry in the phone editor.

ÝÝModemparameterÝ
Ý
Setup of the modem's reactions

By clicking on the first modem icon you can setup
the way connect reacts on modem return code while
dialing. In the first row you enter the modem
messages. Right of them you can specify CoNnect's
reaction. If you don't 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 only to react on
identical responses append a CONTROL-M (a CR sign)
to this string.
There are also waiting parameters. You can specify
how long CoNnect waits until it dials the next 
number in the dialing list (1st parameter) and how
long it waits until redialing 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 dialing. Some low-quality modems need
long delays like 100ms. You can also enter the 
default dialing 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:

CoNnect's clipboard is compatible with the GEM-Clipboard.
CoNnect will ask you to install a Clipboard, if this
hasn't been done on your system so far (there are 
many PD programs to do this) or if CoNnect cannot
find the folder c:\clipbrd. A full clipboard has
a written peace of paper on it. Its content (if it's
containing phone book information) can be dragged
to the phonebook. You can drag numbers from the 
phone book or the dialing memory to the clipboard.
(Pressing SHIFT during this action means: Appending)

ÝÝPapierkorbÝ
Ý
The wastebasket.

Everything you drag onto the wastebasket will be
lost. An UNDO is only possible if you leave the
dialing dialog by CANCEL in which case all 
changes to this dialog will be discarded. 
When dragging the clipboard onto the wastebasket
the contents of this clipboard will definitely be
lost. No UNDO is possible.

ÝÝ_VorschreibzeileÝ
Ý
The Type Ahead Buffer

You can activate the type ahead buffer by pression
CONTROL+INSERT in 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. An UNDO will cancel your input.

Pressing Cursor UP/DOWN will let you use a 20
lines history for the type ahead buffer.

ÝÝ_DerTransferÝ
Ý
The transfer is in progress.

To abort press the CANCEL button or the
UNDO key.

You can see:
  The name and the path of the file.
  And a bar displaying the progress of
  the transfer. 

Below:
  Transmitted data size.
  Whole data size.
  
  Current cps rates.
  Average cps rates.

  Elapsed time.
  Estimated complete transmission time.

Below:
  There you can read messages about
  possible errors or other messages from
  the protocol.

ÝÝZmodemparameterÝ
Ý
Here you get a short listing of the options
configurable for the internal Z-Modem.

Popup1: Protocol:
-----------------
 ù Z-Modem: This is the best choice if your
      host supports this protocol.

 ù Y-Modem: and

 ù X-Modem: should only be used if your host
      does not support Z-modem. Y-Modem is 
      not safe and X-Modem is very slow.

 ù X-Modem7: A protocol, used at least at
      Compuserve. This implementation here
      is not tested at all.

 ù Compuserve B and
 ù Compuserve B+: a two protocols used in 
      compuserve only. They may be a little
      buggy in this verion of CoNnect.

Popup2: Buffersize:
-------------------
 You may choose between 128, 256, 512 and 1024
 bytes. The resulting buffersize will be your
 chosen one or below this depending on the 
 host's parameters. For X-Modem only 128 or 1024
 bytes are useful. Y-Modem will always use
 1024 Bytes regardless of your settings here.

Popup3: Data Protection:
------------------------
 ù Overwrite will always overwrite existing 
      files.
 ù Protect will cause an error condition when
      receiving a filename which exists already
      on your file system.
 ù Resume: Will try to do an error recovery.
      In fact it will append missing parts to
      already existing files.
 ù Ask User: If a file already exists, the
      user is asked if he/she wants to over-
      write, to resume or to skip this file.
 ù Rename: If a file already exists, CoNnect
      will create a unique filename (by
      changing the extension to 001, 002 ...)
     
Popup4: 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 ttys will
      filter control characters. Transmission is
      much slower when using escapes.

Popup5: Data Type:
------------------
  You may select here if you are transferring
  Binary data (no conversion performed) or 
  Ascii data (Linefeed have to be changed).

  Automatic data type detections will try to 
  guess the data type by the filename's ex-
  tension. 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

Popup6: Checksums:
------------------
  You may select either CHECKSUM (XY-Modem),
  CRC-16 (XYZ-MODEM) or the standard CRC-32
  (Z-Modem) which gives most security.

Full paths:
-----------
  Only a few hosts allow this option to be
  switched on. It will send full pathnames
  and try to create directories on your file-
  systems if full pathnames are received.

Force acknowlegde:
------------------
  Normally CoNnect's Zmodem 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 multitasking:
----------------
  If you need really high speed transfers
  this option will disable all multitasking
  within CoNnect and the system. To stop a
  running transfer you'll have to press ^C.

Concerning transmission speed:
  You will obtain good and high transmission
  rates when you set a large io-buffer in 
  the port dialog. A value of 8192 bytes
  is a good choice.

ÝÝ_TransferÝ
Ýbinary filesÝBin„rdateienÝ
ÝMichael ZieglersÝZieglerÝ
ÝGSZRZACCÝZieglerÝ
ÝpathsÝpathselÝ
ÝpathÝpathselÝ
ÝhereÝZmodemparameterÝ
Ý
The File Transfer Dialog.

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 Zmodem can be chosen when you 
set the transfer program popup to XYZ-Modem(int.)
Click here for the 'Internal Zmodem Parameters'.

If you are using the registrated version of
Michael Ziegler's ZModem, which will be faster
than the internal protocol you may put this
ACC to your boot drive and CoNnect will start
corresponding with it. Please read the 
Zmodem instructions carefully and don't forget
to put a $ as the last sending parameter in
all external protocols. Chose GEMRZSZ.ACC in
the transfer program popup and press the button
Search Accessory.

Using an external XYZ-Modem you may choose
XYZ-Modem (ext) 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 fileselector box
which opens when the Transfer is started. The
file (with Selectric even several files) 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 setup up to 8 different proto-
col settings which may be predefined and just
selected when used for a special kind of transfer.

ÝÝBin„rdateienÝ
Ý
For the transfer of binary files so called
transfer protocols are used to allow error
free and/or fast transfers. Z-Modem is error 
free and fast. Error free but not so fast
is Kermit. Nearly error free but not fast at
all is X-Modem. Without error checking
and very fast is Y-Modem.

Normaly Z-Modem is the best choice if it's
available.

ÝÝZieglerÝ
Ý
You'll 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 in the Maus-Net:
   Michael_Ziegler@M
(The internet supports a gateway using
the domain @m.maus.de)

ÝÝ_TabulatorÝ
Ý
Tabulator

You may specify your own tabulator setup here.
However it's a good idea to set the tab 
distance to 8.

The other possible settings are:
  left and right border in the ANSI-Emulation

  a margin bell (vt100)

  the scroll region. touch this only if you
    know vt100 and if you know what you are
    doing.

ÝÝ_StatuszeileÝ
Ý
The Status Line.

Below the terminal menu you may install the vt100
status line. Do this by activating the check box
on top of this dialog.

What you will see in this line is up to the other
settings in this dialogue.

ÝÝ_SizeÝ
ÝholdscreenÝ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 
scrollback buffer. If you want to scrollback
it's highly recommended to activate holdscreen
before, because otherwise CoNnect will always
scroll to the bottom of the window if it receives
new characters.

When you are using the fastscroll option you
should install at least 50 buffer lines here
and enable at least the vertical scrollbar.

Cursor coupling will keep track of the cursor
and if it's 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Ý
Ý
Normally the function key F1 is set to holdscreen.
Then - if you press F1 holdscreen gets active as
long as F1 is not pressed again. (Active holdscreen
will light the rightmost LED in the terminal window)
This will allow you to scroll back in your history
buffer without being disturbed by CoNnect's scrolling
to the bottom when receiving new characters.

With the following trick you may install F1 as the
holdscreen key in CoNnect.

Open the function key dialog. Set the text of
F1 to 'holdscreen' (without the quotes!) and enable
the left check box behind this entry.
F1 will then toggle holdscreen status.

ÝÝ_RegistrierungÝ
ÝSharewareÝSharewareÝ
ÝmanualÝHandbuchÝ
ÝprogrammerÝProgrammiererÝ
ÝdistributorsÝWo RegistrierenÝ
Ý
The Registration Dialog.

In this dialog you should enter your user data.
(Name, Address, favorite Baseball player ;-)

At least your name should be placed 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 (that's me) has received 
your registration fee AND the registration
letter you'll get the key for an unlimited
version and a printed manual.

The registration key has to be entered 
in this dialog in one of the 6 possible slots.
Six - because you'll need a special key for
each TOS-Version you are using as the user id
is dependent on this.

For some countries local distributors will
handle your registration.

ÝÝProgrammiererÝ
ÝdistributorsÝWo RegistrierenÝ
Ý
You can access the programmer of CoNnect at

    Wolfgang Wander
    Rudolf-Breitscheid-Str. 63a
    D-22880 Wedel
    Germany

or by email:

    Wolfgang Wander @ HH2  (Mausnet)
    wwc@dxhra1.desy.de     (Internet)

the bank to send lots of money to:

    Wolfgang Wander
    Konto-Nummer: 1373482932
    Hamburger Sparkasse
    Bankleitzahl: 20050550
    
If you are not living in Germany you might 
find it convenient to contact the local 
distributors.

ÝÝ_PortÝ
ÝbaudÝBaudrateÝ
ÝportÝPortÝ
Ýdata and stopbitsÝDatenbitÝ
ÝechoÝEchoÝ
ÝhandshakeÝHandshakeÝ
ÝparityÝParit„tÝ
Ýio-bufferÝSchnittstellenpufferÝ
Ý
Port parameters

here you can specify the port parameters.

Port parameters are: port, baud rate, 
handshake, data and stopbits, parity
and size of the io-buffer.

ÝÝHandshakeÝ
Ýio-bufferÝSchnittstellenpufferÝ
Ý
Possible settings for handshake are:
No handshake, rts/cts, xon/xoff.

Handshake is used between two computers (or
a computer and a modem) to tell each other 
that they are able to receive data or not.
Without handshake lots of data would be lost,
if the receiving computer is slower in taking
the data then the other one sends it.

Without handshake (because your modem or
host does not support it) you should
try to install a large io-buffer.

The different forms of handshake 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
   is quite similar to the software
   handshake. 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 handshake. Otherwise the connection
would be equivalent to no handshake at all
or in the worst case, transmission will block.

ÝÝSchnittstellenpufferÝ
ÝhandshakeÝHandshakeÝ
Ý
The size of the io-buffer can be set to
values between 256 and 32767 bytes.

If your host or your modem supports handshake
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Ý
Ý
Possible settings for echo are:
  echo on, echo off, 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. A better choice would
  be echo off then.

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 supposed to echo them. (if you
  should see them).

Echo Local: Here no characters are sent to
  the host. Everything you type will be
  displayed on screen only.

ÝÝParit„tÝ
Ý
Possible settings for parity are:
 no, even , odd.

No parity will neither send nor receive an
additional parity bit.

If the sent character has a 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Ý
Ý
Possible settings for databits are 5, 6, 7,
or 8.

Each character sent consist of 1 start bit,
a configurable number of data bits, an
optional parity bit and a configurable 
number
of stop bits.

To send with 8 data bits, no parity and 1
stop bit (which is default on most hosts) 10
bits per character are sent.

ÝÝBaudrateÝ
ÝportÝPortÝ
Ý
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 of Stephan Skrodzki or
RSVE of 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 right baudrates.

On a TT, a MegaSTE and on the Falcon030 you
have some additional and high baudrates.
-> port.

ÝÝPortÝ
ÝbaudrateÝBaudrateÝ
Ý
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 Databits, No parity, 1 Stopbit), 
No(!) handshake and 31250 baud.

On a Falcon you are able to select some
higher rates also:

  153600, 125000, 115200, 83333, 76800, 62500,
  57600, 50000, 38400, 31250

The Mega STE has 3 serial ports.

MODEM1 - is identical to the ST-Port
MODEM2 - is identical to the Falcon port
SERIEL2- has the following additional
         baudrates: 125000, 115200, 83333,
         62500, 57600, 38400, 31250 and
         14400.

The MegaSTE's Ports have some  hardware defects
by definition and only MODEM2 and MODEM1 can
give satisfying results.

On a TT there are 4 serial ports.

MODEM1 - is identical to the ST-Port
MODEM2 - Is similar to the Falcon port but not
         able to do 57600 and 115200 baud.
SERIEL1- is similar to the ST-Port but has less
         lines and is therefore almost unusable.
SERIEL2- Is identical to SERIAL2 on the MEGASTE,
         but bug free. Has no Ring-Indicator.

Only if you are using a high speed modem the
high baud rates will be of interest for you.
The telebit worldblazer is able to receive
and send at 115200 baud but this is quite
hypothetical.

ÝÝScantabelleÝ
ÝscantableÝCOSHYHLP\SCANTABLEÝ
Ýcharacter setÝ_ZeichensatzÝ
Ý
The Scantable

is a file with certain commands for connect
how to handle any pressed key.

It can either be loaded in the dialog
character set or by the coshy command scantable.

For example you can use the table to map some
country specific keys ( the German umlaute )
to its equivalent ae, ue, oe ...
A Scantable example:

'„'  'ae'
'”'  'oe'
''  'ue'
'Ž'  'Ae'
'™'  'Oe'
'š'  'Ue'
'ž'  'ss'

The first row contains the pressed key, the
second its replacement. ('' have to be used
here).

You can also give an ASCII-Value for the
pressed key. If you want to replace ^A you
type: 

1 'this' 32 'was' $20 'key' 0x20 '^A'

Note that the Space character may not be
included in quotes ('') and has to be
specified as 32.

Negative numbers in the first row refer to
the (positive) Scancode number.
You'll find a complete overview of the
scancode in the Profibuch. (app. C)


By

-1 'Escape'

you'll get the String Escape when pressing 
Escape.

-72 0x1b '[B'

will send the vt100-Sequence Cursor Down when
you press cursor up. This is fun ;-)

An important application of this scantables
is the doorway-mode, where you can define
your ATARI sending DOS-Scancodes 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

Example

 -1 Sca 'escape shift'

will react on a pressed Escape key if the
Shift key is pressed but Control and
Alternate are unpressed.

s means Shift not pressed
S means Shift pressed
c means Control not pressed
C means Control pressed
a means Alternate not pressed
A means Alternate pressed

If this information is missing, the status of
the shift keys will not contribute to the
selection of replacements.

ÝÝ_ZeichensatzÝ
ÝmanualÝHandbuchÝ
Ýscan tableÝScantabelleÝ
Ý
Character Set.

Character sets can be defined here. This may
either be the ATARI character set or the ISO
character set. The latter allows to choose 
between several different national replacement
character sets.

National special keys (the Umlaute) and the
way CoNnect sends them can be defined here.
This could also be done in the scan tables
but its 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 will be found in the manual. 
ÝÝ_Kompatibilit„tÝ
Ý
Compatibility.

As some hosts have problems with correct
vt100 emulations like CoNnect's one you may
use this dialog 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 dialog you can setup up to 80
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 of a key you may place their CoSHy
Commands which will be executed when a 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 used
fonts for wide and small terminals.

CoNnect uses GDOS fonts but even without GDOS
you may use these fonts by just putting them
into the directory GEMSYS (in your CoNnect
directory). CoNnect will load this fonts at
startup time if no GDOS is installed.

Other options are: the cursor type, the kind
of scrolling (smooth scrolling is nice to
read scrolling texts but is very boring after
a while - it's so slow ;-), fast scrolling
is very fast and you can't read incoming
texts)

ÝÝ_ProtokollÝ
Ý
Capture.

Here you may specify the file for capturing
your online session. The filename may 
contain the following characters:

    %a short: day of week
    %b short: name of month
    %d day in month (1-31)
    %H hour (0-23)
    %I hour (0-12)
    %j day in year (1-366)
    %m month (1-12)
    %M minute (00-59)
    %p AM/PM
    %S second (00-59)
    %w day in week (0-6)
    %W week in year (0-52)
    %y short: year (0-99)
    %Y year (0-9999;-)
    %Z Timezone (eg. MEZ)
    %% the %-sign

You may also specify the way of capturing
(complete or ASCII-only) and may set a switch
that CoNnect will ask you at logoff what you
want to do with a captured file (distribute
after logoff).

ÝÝ_EmulationÝ
Ý
Emulations.

Here you may select the desired emulation.
CoNnect offers you vt52, vt100, vt102 and 
vt220.

For working in mailboxes vt102 can be
recommended. The other parameters are used to
define the meaning of backspace and delete
and the meaning of incoming and outgoing
linefeed. Normally these values need not
be changed.

ÝÝ_AsciiuploadÝ
ÝmanualÝ
Ý
With Ascii Upload you send an ascii-file
without any special protocol.

This is useful to enter short pretyped texts
into a mailbox editor.

Please don't get confused by the large number 
of options. Normally they don't need to be
changed. You'll find further explanation in
the manual.

ÝÝ_StatistikÝ
Ý
Charge Statistics

To keep track of your telephone charges
CoNnect keeps a logfile containing
information of the dialed-in box, the
duration of the connection and the money you
spent there. This dialog 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 tack 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Ý
Ý

In the TEK-Setup dialog you can configure
your TEK 4014 emulation. As most mailboxes
don't 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 cooperate
with the shareware product PAULA, which is
able to play so called MOD Files. You may
also specify other sound files - CoNnect will
try its best to play it 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 normally are used to allow access to
menu items without selecting it by mouse but
just by pressing a key combination.

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Ý
Ý
Colors.
 
CoNnect uses the first 16 VDI-Colors and
assumes they are installed in the default
manner. If this is not true you may use this
dialog to create a connect internal color
table. 

ÝÝ_AnrufbeantworterÝ
ÝparametersÝ_AnrufparameterÝ
ÝmanualÝHandbuchÝ
Ý
The Answering Machine

This is the automatic answering machine of
CoNnect which enables you to use a ZyXEL
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. 

Pressing the parameters button you can
configure the answering machines setup.

Detailed information on the answering machine
can be obtained in the manual.

ÝÝ_AnrufparameterÝ
ÝmanualÝHandbuchÝ
Ý
Parameters for the answering machine.

Here you can configure the name of the
greeting message a caller gets. Also the path
for new messages which callers leave should
be setup 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Ý
Ýwindow dialogsÝFensterdialogeÝ
Ýterminal windowsÝTerminalfensterÝ
Ýtektronix windowsÝTektronixfensterÝ
Ýhelp windowsÝOnlinehilfeÝ
Ýwindow menusÝFenstermenÝ
ÝmiscÝ_AllgemeinesÝ
Ý
CoNnect offers currently four different 
kinds of windows to the user. There are

 ù terminal windows
 ù tektronix windows
 ù help windows
 ù window dialogs

The first two types have another menu bar in 
their top region. These are so called window 
menus which allow user actions belonging to 
this certain window locally.

The user interface for window menus and 
window dialogs can be configured in the misc 
dialog.

ÝÝFensterdialogeÝ
ÝmiscÝ_AllgemeinesÝ
ÝsendingÝPasteÝ
ÝselectedÝMarkierenÝ
Ý
Window Dialogs

CoNnect's window dialogs are an enhancement 
of the normal dialogs offered by the GEM 
since Atari has released their first ST-
Computers. The main difference is the fact, 
that window dialogs are placed in windows.

But there are some other advantages. They 
allow real multitasking under MultiTos or 
Mag!x even when dialogs are edited. The 
windows can be placed anywhere. The menu bar 
of CoNnect stays accessible even when a 
dialog is open. You may edit several dialogs 
at one time. This dialogs have some special 
object type, like popups, check- and radio-
buttons and hotkeys: you may press ALT+plus 
one of the underlined characters to select a 
button as if it was clicked-on by the mouse.

You may close the dialog by clicking on the 
window closer or pressing the UNDO key. This 
is equivalent to pressing the CANCEL Button 
- your changes will be lost.

Help can be obtained in any window dialog 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 
dialog. 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Ý
Ý
CoNnect emulates all incoming characters. 
i.e it scans the incoming datastream 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

  - in what size
  - in what color
  - where
  - ...

new characters will be displayed.

You may set the emulation mode to suit 
the command set (the emulation) of your 
host.

ÝÝTastenVersendenÝ
ÝmanualÝHandbuchÝ
ÝCoSHyÝCoSHyÝ
Ýtype ahead bufferÝ_VorschreibzeileÝ
Ýscan tableÝScantabelleÝ
Ýfunction keysÝ_FunktionstastenÝ
ÝhotkeyÝ_HotkeysÝ
Ý
To send characters to the host, CoNnect 
offers many (too many) possibilities.

ù Pressing a normal key
   Letters, numbers, space- and special 
   characters will be sent without 
   translation to the host (if no scan table 
   is installed)

ù Pressing a key together with CONTROL:
   (if there is not hotkey for this 
   combination)

   ^ <space> sends   0
   ^A        sends   1
   ^B        sends   2
   ...
   ^Z        sends  26
   ^[        sends  27
   ^\        sends  28
   ^]        sends  29
   ^^        sends  30
   ^_        sends  31

ù Pressing a key together with ALTERNATE:
   (if there is not hotkey for this 
   combination)

   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 (ALT stays press) sends
            ƒ

ù Pressing of a function key:
   If you have entered a text for this key 
   in the function keys dialog and none of 
   the corresponding CoSHy-Buttons is set, 
   the corresponding text will be sent.

ù Pressing Backspace, Delete, UNDO, 
   Cursorkeys, Insert or Home.
   The corresponding vt100/vt52/vt220
   meaning will be sent (see manual).

ù Pressing CONTROL+INSERT:
   The type ahead buffer will show up 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.

ÝÝTerminalfensterÝ
Ýterminal menuÝMenue-TermÝ
Ýmain menuÝHauptmenÝ
ÝemulationÝEmulation-EinfÝ
Ýpressing keysÝTastenVersendenÝ
ÝholdscreenÝholdscreen-aktivÝ
ÝselectÝMarkierenÝ
Ý
Terminal window.

The terminal window is the user interface 
for the communication with the host. By 
pressing keys, these will be sent to the 
host and received characters from the host 
will be displayed according to the used 
emulation.

If you have enabled scrollbars and the 
history buffer you may use this scrollbars 
to read again 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 that 
specific window.

The main menu will be used to configure 
global settings of CoNnect.

A text in the terminal window can be 
manipulated in several ways. You should 
select the disired text region first.

ÝÝMenue-TekÝ
ÝmanualÝHandbuchÝ
Ý
The tektronix window menu is used for 
manipulating the displayed graphic. You may 
save these graphics, print them or chose 
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 being able to create tektronix 
graphics is installed on workstations or 
main frames. 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Ý
Ý
Here you may open a tektronix 4014 window 
where your host can send you vector 
graphics and 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 use the menu item 
'normal resolution'

ÝÝFenstermenÝ
Ýmain menueÝHauptmenÝ
Ýterminal windowÝMenue-TermÝ
Ýtektronix windowÝMenue-TekÝ
Ý
Window Menus.

Window menus are menus where you can 
configure local parameters belonging to a 
specific window. See terminal window, 
tektronix window.

In contrast to this, global parameters can be 
accessed 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.

ÝÝ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 dialogÝFensterdialogeÝ
Ý
Close.

The current window will be closed. If the 
current window is a window dialog 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's 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 10 last opened windows are
displayed here. Selecting an item will top
the corresponding window.

ÝÝgl_OptionenÝ
Ý
Load Options / 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 file.

Starting CoNnect will normally cause it to
read the CONNECT.OPT file.

ÝÝHauptmenÝ
Ýwindow menusÝFenstermenÝ
Ýabout CoNnectÝ_InfoÝ
ÝStart a ShellÝgl_ShellstartÝ
ÝStart a ProgramÝProgrammstartÝ
ÝStart CoSHyÝgl_CoshystartÝ
ÝStart a ScriptÝgl_ScriptstartÝ
ÝQuitÝgl_BeendenÝ
ÝOpenÝgl_™ffnenÝ
ÝRotateÝgl_RotierenÝ
ÝCloseÝgl_SchlieženÝ
ÝFull SizeÝgl_Volle_Gr”žeÝ
ÝWindow NamesÝgl_FensternamenÝ
ÝRegistrationÝ_RegistrierungÝ
ÝMiscÝ_AllgemeinesÝ
ÝHotkeysÝ_HotkeysÝ
ÝColorsÝ_FarbenÝ
ÝCharge StatisticsÝ_StatistikÝ
ÝSoundÝ_SoundÝ
ÝLoad OptionsÝgl_OptionenÝ
ÝSave OptionsÝgl_OptionenÝ
ÝHelpÝGeneralÝ
Ý
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
      ø Colors
      ø Charge Statistics
      ø Sound
      --------------
      ø Load Options
      ø Save Options

 ù HELP
      ø Help

ÝÝgl_CoshystartÝ
ÝCoSHyÝCoSHyÝ
Ý
CoNnect's internal Shell can only be
started on the so called TOS-Screen (i.e.
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
CoSHys commandline and CoNnect will try to
execute them. To exit type exit+RETURN on 
the command line.

ÝÝgl_ScriptstartÝ
ÝCoSHyÝCoSHyÝ
Ý
CoNnect's internal Shell can only be
started on the so called TOS-Screen (i.e.
without windows) when running a single
tasking TOS. If you are running Mag!X or
MTOS this item will be disabled.

Before starting a script CoNnect will open a
fileselector to let you chose the script
file.

ÝÝProgrammstartÝ
Ý
To start an external program this menu item
will open a fileselector where the user is
able to select the program she/he wants to
start.

After the started program has exited you can
continue working in CoNnect.

ÝÝgl_ShellstartÝ
ÝmanualÝHandbuchÝ
Ý
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 MTOS 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, 
it has less spelling mistakes.) 

ÝÝHandbuchÝ
Ý
Every registrated CoNnect user will receive a
printed manual automatically. Normally this
won't take more than 4 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 8 weeks.
Please be patient. We won't forget you. Mail
us to make sure that we haven't forgot you
after about 4 weeks.

If you are using an older manual, because you
are a long term CoNnect user, you can obtain
an newer version at 

Philipp Oelwein
Ringelsgasse 22a
69226 Nužloch

Email:
Philipp Oelwein @ LU                
(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Ý
Ý
In this window you can find help for the
handling of help windows

The online 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
dialog, 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 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. 
   RETURN or 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 non - close
      the current help window.
   -------------------------------------
   Cursor keys
      Will move the cursor in the standard
      manner. 
   SHIFT Cursor left or right
      Will move to the beginning or end of
      the current line.
   CONTROL Cursor left or right
      Will move the the previous or next word
      of the help text.
   SHIFT Cursor up or 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Ý
Ý
In the text window of CoNnect, i.e. the
terminal window or the help window, you can
select parts of the text using the mouse. You
also may 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 don't 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 now may 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
    Is similiar 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 into 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 dialog 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 dialog) 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, etc. 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 of selected text parts.

Having selected a portion of text, you
may send this text in a certain window
(either a window dialog 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 an > sign.

Quoting is normally used when answering mails. 

For example:

   > Do you know the current version number
   > of CoNnect?

   Sure. But when you will get this letter
   this information will be void.

ÝÝ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

who will then send along the payments to me 
(checks or cashiers' cheque preferred; make 
them out to Michael Baffoni).

ÝÝ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 Northern America contact 
       Michael Baffoni
       
For Great Britain contact
       System Solutions
       
Otherwise you should contact the author
of CoNnect.
       
(A distributor for New Sealand and 
 Australia is on his way to there ,-)
 
ÝÝ_InfoÝ
ÝcountryÝWo RegistrierenÝ
ÝUSÝMikeÝ
ÝGreat BritainÝSolutionsÝ
ÝregistrationsÝ_RegistrierungÝ
ÝsharewareÝSharewareÝ
Ý

The info window of CoNnect provides
information about the program CoNnect and its
software status (CoNnect is shareware!), it
also will show the non-registrated user a
wonderful nice looking bar to show him
elapsed testing time.

If you want to register for CoNnect you
should open the registrations dialog.

To get information 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Ý
Ý;-)ÝSmileyÝ
Ý
Adam in paradise. He walks around and seems
to be a little unhappy. The lord recognizes
this and asks him:

   Hi Ad, what's up? Seems to be not your
   best day...

Adam, quite annoyed answers:

   You! You can talk nonsense like this. You
   don't have to bother about the daily
   boring work like cleaning the clothes,
   cooking, dishes, cleaning the paradise,
   brushing your tooth, 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 this
   jobs and who will give you love and
   warmth. But this will certainly be not 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! Thats too much. But - what could
   I get for one rib, only?

-----------------------------------------------
OK. CoNnect excuses itself since it only has 5 
female users. They are hereby asked to send a 
nasty joke about men to the author and he will 
then add this one to the next release of 
CoNnect. :-)

ÝÝErinnerungshilfeÝ
Ýgentle smileÝL„chelnÝ
ÝjokeÝWitzÝ
Ý
Remember.

This text is intended to remind the user about
something. 

I just don't know. Let me think.

Just a second ...

Right! Always remember that telecommunication
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 under-
stand 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
humor index is above 0.0001%. But be aware of
the fact, that computers have another kind of
humor than humans have.

ÝÝSharewareÝ
ÝpoliceÝPolizeiÝ
ÝauthorÝProgrammiererÝ
Ýto rememberÝErinnerungshilfeÝ
ÝuserÝAnwenderÝ
ÝmanualÝHandbuchÝ
Ýwhere to registerÝWo RegistrierenÝ
Ý
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 the work with CoNnect will
be not that easy any more if you didn't
register.

For the user's benefit CoNnect disables some
of its functions. Otherwise there might be
the danger that the user will work for 2
years with an illegal copy of CoNnect and
will then notice it. He then would go the 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 multiuser systems (like
Universities, etc.) a multiuser license for
DM 399,- is due. For this fee you'll
receive a printed manual and a registration
key to make your CoNnect a registrated and
unlimited version.

How do you know, if you need a commercial
version or not? Thats 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 one.

If you live in Northern 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 don't even know
they are users and this text is intended to
help them to get several problems solved with
their lifes 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ÝGrnenÝ
Ý
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 
licemen wear green uniforms but without a 
green dot on them.

ÝÝGrnenÝ
Ý
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 ;-)

ÝÝ_MiscÝ
ÝCoSHyÝCoSHy-AllgÝ
Ýterminal windowsÝTerm-AllgÝ
Ýwindow dialogsÝFens-AllgÝ
ÝGEM-clipboardÝKlemm-AllgÝ
Ý
The Misc Dialog.

In this dialog you can set global parameters
concerning the terminal windows, window
dialogs the GEM-clipboard and the CoSHy.

ÝÝCoSHy-AllgÝ
ÝselectedÝpathselÝ
ÝmanualÝHandbuchÝ
Ý
Parameters concerning the CoSHy in the misc 
dialog.

  ù 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Ý
Ý
Parameters concerning the terminal windows in
the misc dialog.

Here you can determine, if text windows are
always placed on by 8 divideable horizontal
position of the screen (this will speed up
display if you don't own NVDI). You may also
configure the window menus to be either
atari-like drop-down or mac-like pull-down.

ÝÝFens-AllgÝ
Ý
Parameters concerning window dialogs in the
misc dialog. 

You can configure if dialogs open in the
center of the screen, at the last position or
centered according to the current mouse
position. 

Frames around certain elements of the dialogs
do almost have titles. You may specify here
how you want them to look like.

In a common GEM-Dialog, RETURN and ENTER are
used to leave the dialog like clicking on the
default button. CoNnect may also use this key 
like in an editor to jump to the next dialog
text input field.

Finally you can select the background pattern
and color. But be aware of the fact, that an
arbitrary color will look like white when no
pattern is selected ;-)

ÝÝKlemm-AllgÝ
ÝselectÝMarkierenÝ
ÝpasteÝPasteÝ
Ý
Parameters concerning the GEM-clipboard in
the misc dialog.

You can specify here if all selected texts
will automaticly be placed in the
GEM-clipboard and if the clipboard will be
read if you try to paste a text to the host.

ÝÝpathselÝ
Ý
Input of pathnames and filenames:

In all dialogs where CoNnect wants to have a
filename in an editable input field you may
double-click on this line to use the
fileselector for searching and selecting the
lines content.


ÝÝOnline-FettÝ
Ý

Now you are reading the text page for
highlighted text. This test page does not
provide any useful information (only spelling
mistakes), so leave it by pressing the UNDO
key. 

ÝÝCoSHyÝ
Ýabout this helpÝCOSHYHLP\ABOUTMEÝ
Ýgeneral usageÝCOSHYHLP\AÝ
Ýsearching errorsÝCOSHYHLP\DEBUGÝ
Ýmeta charactersÝCOSHYHLP\METASÝ
ÝwordsÝCOSHYHLP\WORTEÝ
Ýcommand delimitersÝCOSHYHLP\KMDTRÝ
Ýinput/output redirectionÝCOSHYHLP\IOREDIRÝ
ÝquotesÝCOSHYHLP\QUOTESÝ
Ýactions on a commandlineÝCOSHYHLP\INPWORKÝ
ÝmiscÝCOSHYHLP\OVERALLÝ
Ý[ 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Ý
Ý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Ý
Ý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\SENDBREAÝ
Ý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Ý
Ý
CoSHy

you get into CoSHy either by activating the
interactive mode (the menu items CoSHy) or
by activating the script mode where CoSHy
will start to run a script file.

This help mainly shall be helpful for you in
creating scripts. The largest part of this
help consists of the description of the
several available internal commands. To get
an overview on CoSHy it will be either a good
idea to look into the manual but also some
unix shell programming experience will help
you a lot. 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 searching errors

1.2 actions on a commandline

1.3 overview on the commands

  1.3.1 misc
  1.3.2 CoSHy commands

   [ expression ]
   Ý ...
   ! ...
   . ...
   alert
   alias
   baud
   bell
   blitmode
   break
   cd
   carrier
   ctty
   dial
   download
   echo
   env
   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

ÝÝCOSHYHLP\AÝ
ÝquoteÝCOSHYHLP\QUOTESÝ
Ýmeta charactersÝCOSHYHLP\METASÝ
Ý
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 of 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 an unix like environment it's
recommended to install the tools like, ls,
echo, cat, mkdir, cp ... on your binaries
directory and set a PATH pointer to this
directory. 

Attention. In contrast to TOS pathname
delimiter is not the \ but the /. If your
external programs need \ in their arguments,
you'll have to quote the \.

CoShy is able to do the widely used TAB
expansion. The first word on a command line
is tried to be expanded as a command. 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 it you'll get lharc. If there are
several possible expansions CoSHy will expand
up to the first difference in the names.
Lets say you have printenv and printall on
your system and type in pri<TAB> you'll 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\ABOUTMEÝ
Ýgeneral usageÝCOSHYHLP\AÝ
Ý
0.0 About this help

The help text to COSHY have been made by
Stephan Skrodzki and me, the author of CoNnect
and (bad) translator of the help texts, wants
to thank him a lot for his work. 

If you didn't understand his German (see in the
German online help texts) , you may
at least want to thank him for his work. His
internet mail adress is

   stephan_skrodzki@ka.maus.de

next chapter:

   1.1 general usage

ÝÝCOSHYHLP\ALERTÝ
Ý
  alert <defaultbutton> <alertstring>

displays a GEM - alert box. The parameters are
the parameters of the gem function form_alert.

ÝÝCOSHYHLP\ALIASÝ
Ý
  alias cmd replace

will replace <cmd> in all commands beginning
with <cmd> by <replace>.

 alias cmd
  or
 unalias cmd

will delete an defined alias.

example:

 alias l 'ls -l'

  will execute an ls -l if l is entered to
  the command line.

ÝÝCOSHYHLP\AUSDRUCKÝ
ÝtestÝCOSHYHLP\TESTÝ
Ý
  [ 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\BAUDÝ
Ýport dialogÝ_PortÝ
Ý
  baud [rate] [options]

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     will set the rate to 38400
                baud.
 

see also:
    port dialog

ÝÝCOSHYHLP\BELLÝ
Ýsound dialogÝ_SoundÝ
ÝnoiseÝCOSHYHLP\NOISEÝ
Ý
  bell n

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    makes  crash   ;-)

See also: noise, sound dialog

ÝÝCOSHYHLP\BLITMODEÝ
Ý
  blitmode [option]

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Ý
Ý
  break n

Will break out of n nested if, for or while
structures. If n is omitted n will be set to
1.


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 structure shall be left.

ÝÝCOSHYHLP\CARRIERÝ
Ý
  carrier

returns 0 (true) if the modems sends the
carrier signal, 1 (false) otherwise.

example:

 if carrier; then
  hangup            
 fi

hangup, if there is a carrier.    

ÝÝCOSHYHLP\CDÝ
Ý$CDPATHÝEnvironmentÝ
Ý$HOMEÝEnvironmentÝ
Ý
  cd path

Change the current directory to path. The
variable $HOME is the default dir.  The
variable $CDPATH defines the search path for
the directory containing dir. Alternative
directory names are separated by a comma or a
semicolon.

If dir 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Ý
Ýemulation dialogÝ_EmulationÝ
Ýcharacter set dialogÝ_ZeichensatzÝ
Ýcompatibility dialogÝ_Kompatibilit„tÝ
Ý
  ctty [options]

changes several terminal parameters

options:

 vt52
 vt100
 vt102
 vt220-7  switches to the corresponding
 vt200-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 diabled

 smooth     use smooth scrolling
 -smooth    use fast scrolling
 
 colour     display ansi colors
 -colour    don't use ansi colors

 strip8     strip the highest bit
 -strip8    use all 8 bits.

 destructive   destructive backspace
 -destructive  normal backspace

see also: emulation dialog,
          character set dialog,
          compatibility dialog

ÝÝCOSHYHLP\DIALÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
Ýdialing dialogÝ_WahlÝ
Ý
  dial [opt] number

Dials a given phone number. Normally this
will be a text (the text of a phonebook
entry in the dialing dialog). If there is no
matching text, the number is dialed as it is
(containing all symbols in it).
Take care: 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 
ones.

options:

 -z seq    <seq> becomes the reset string
 -r n      <n> is 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 conse-
           cutive 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: dialing dialog

ÝÝCOSHYHLP\DOWNLOADÝ
ÝtransferÝ_TransferÝ
Ý
  download [-p path]  [filename]

A file will be received with the options 
set up in the transfer dialog. A filename 
may be given if you want to override the 
incoming files filename or if you are 
using a protocol where the filename itself 
is not transmitted (like Xmodem). 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Ý
Ý
  echo [-n] arg1 ...

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Ý
Ý
  env  [arg1 ...]

Without arguments the environment 
variables will be displayed. If arguments 
are given, env is equivalent to setenv.

ÝÝCOSHYHLP\EVALÝ
Ý
  eval  command

will execute the given command in coshy 
and will NOT stop the execution of a 
running script, if an error in execution 
of 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 
commandline.

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Ý
Ý
  exit n

The current shell level is left. Shell 
level might also be script files which 
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Ý
Ý
  scantable [filename]

will read in and execute a scan table file 
if filename if given. Else a loaded scan 
table will be deleted.

ÝÝCOSHYHLP\EXPRÝ
Ý
  expr  expression

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 hierachy)

| 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 (don't 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.

*  /  % time, divide by 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 hierachy. Take care to 
quote them correctly as  ( ) are shell 
symbols also.

expr:

 expr \( 3 + 2 \) \* 2
             writes 10 to stdout.

 `expr 3 + 2`
             will replace the result of 
             the expression ` ... ` by 5 
             and trys to execute the 
             command 5. This normally will 
             fail ,-)

 a=`expr 3 + 2`
    or
 a=$(expr 3 + 2)
             a will be set to the value of 5.

 a=$(expr $a + 1)
             A will be increased by 1.

 b=`expr \($a +1 \) \* $a`
             b will be set to the value of 
             (a+1)*a

ÝÝCOSHYHLP\FALSEÝ
ÝtrueÝCOSHYHLP\TRUEÝ
Ý
  false

Will return false (1) as return value. It's 
equivalent to
  ! true

example:

 false
 echo $?

ÝÝCOSHYHLP\FILESELÝ
Ý
  fileselect <pfad> <default name>
           <extension> <message>

Calls the gem file selector.
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 dialogÝ_FunktionstastenÝ
Ý
  fky [opt] num [value]

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 dialog.

example:

 send `fky -o 1`
    Sends the contents of function key F1.

ÝÝCOSHYHLP\FLUSHÝ
Ý
  flush

Will remove all pending characters in the 
io-buffer of the serial/midi device.

ÝÝCOSHYHLP\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

 will display the numbers 1 to 9.

ÝÝCOSHYHLP\FUNCTIONÝ
Ý
  function name { commands }

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 ...

example:

 function doubleecho {
                      echo $1 ;
                      echo $1
 }

 doubleecho HALLO

  will result in

  HALLO
  HALLO

function name

 deletes the function named name.

function

 will display all defined functions.

ÝÝCOSHYHLP\GETÝ
ÝreadÝCOSHYHLP\READÝ
ÝwaitforÝCOSHYHLP\WAITFORÝ
ÝevalÝCOSHYHLP\EVALÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
Ý
  get <opt> <timoutval> <var1> <var2> ..

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 to 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.

A numerical value <timeoutval> may follow 
to limit the user's response time. If a 
timeout occurs get will result in false 
(1). (see time format)

The variables var1, var2,... will be 
filled like in read.

ÝÝCOSHYHLP\GETKEYÝ
Ý(time format)ÝCOSHYHLP\TIMEFORMÝ
Ý
  getkey [-n] [-v] [timeout]  var1
                         [ var2 ...   ]

will read as many characters from the 
serial port as variables (var1 ...) 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 disired number of keys in the 
time timeout val. (time format)

ÝÝCOSHYHLP\GETTONEÝ
Ýanswering machineÝ_AnrufbeantworterÝ
Ý
  gettone <timeoutval> <var>

Reads in a touchtone sequence while being 
in the answering machine mode. The 
sequence has to be ended by # by the user.

see answering machine.

ÝÝCOSHYHLP\HANGUPÝ
Ýdialing dialogÝ_WahlÝ
Ýitem hangupÝT\HANGUPÝ
Ý
  hangup

Will force the modem to hangup. How this 
is done has to be specified by the user in 
the dialing dialog.

example:

 if carrier; then
  hangup
 fi

hangup is equivalent to the terminal menu 
item hangup.

ÝÝCOSHYHLP\HOLDSCRNÝ
Ýfunction keyÝholdscreen-aktivÝ
Ý
  holdscreen [parameters]

toggles - if no parameters are given - 
between holdscreen on and off. Watch the 
holdscreen LED in the terminal menu.

Set on the function key F1, F1 will 
satisfy the vt100/220 standard.

Possible parameters are 1 ot activate 
holdscreen or 0 to deactivate it.

ÝÝCOSHYHLP\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 "shit ;-(" if not the script won't
 fi                be happy.

ÝÝCOSHYHLP\INPWORKÝ
ÝexprÝCOSHYHLP\EXPRÝ
Ýoverview of the commandsÝCOSHYHLP\OVERALLÝ
Ý
1.2  Actions on a commandline

Each commandline evaluated by CoSHy 
undergoes a special sequence of steps.

 * Separation in words
 * Bracket expansion
 * Parameter and variable substitution
 * Command substitution
 * Arithmetic substitution
 * Separation in words (again)
 * Path expansion
 * Quote removal

A more detailed description follows below:

 Separation in words.

words are consequent 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  consist 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 { will not be tolerated on a 
command line.

Those words then will consist of prefix, 
bracket and postfix.

example:

 abc{defgh,ij}klmno

 abc                  is prefix
    {defgh,ij}        is bracket
              klmno   is postfix

The words in brackets are separated by 
commas and for all of this words z1 to zn 
all words

  prefix'z1'postfix
  prefix'z2'postfix
         :
  prefix'zn'postfix

will be generated and inserted in the 
commandline instead of the bracket 
expression.

example:

 bla{bli,blo}bla  will produce the words
                  blablibla  and
                  blablobla.

 {Britta,Sonya}' and '{Pet{er,ra}}

 will be:  Britta and Peter
           Britta and Petra
           Sonya and Peter
           Sonya and Petra

Parameter and 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}. Else 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.

Special CoSHy variables

 $n    where n is a value between 0 and 9
    or
 ${n}  where n is a value between 0 and 
       32767.
       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.

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 
not.

example:

 editor $(grep -l double *.c)

  calls an editor with the parameters 
  being all .C-Files containing the word 
  double. (grep is an external file 
  utility).

 a=$(expr $a + 1)

  increments the value of a by one.

Arithmetic substitution.

Each word is searched for $[ expression ]. 
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 words (again)


All new inserted text parts are subject to 
an additional separation into words.

example:

  a='ls -l /usr'  contains only one word.

  $a              will consist of 3 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 
              don't 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*  ;-) just a joke but working:
              Expands to all filenames 
              that are 2 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\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 file 
               will be lost.
 cmd   >> file the command cmd appends its
               output to file.

Next chapter:

 1.1.5. quotes

ÝÝCOSHYHLP\KMDTRÝ
Ýinput / output redirectionÝCOSHYHLP\IOREDIRÝ
Ý
1.1.3 Command separators

The following characters do separate 
commands if they are not quoted.

Character:  Meaning:

 ;          normal
 <newline>  normal
 &          like  ;  (no backgroundtasks,
            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
            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.
            cmd2 is executed if and only 
            if cmd1 has a return value of 
            false(1). Returns true or the 
            return code of cmd2

Next chapter:

 1.1.4 input / output redirection

ÝÝCOSHYHLP\LOGÝ
ÝprotÝCOSHYHLP\PROTÝ
ÝechoÝCOSHYHLP\ECHOÝ
Ýcapture dialogÝ_ProtokollÝ
Ý
  log [-n] text

 write a text to the capture files (if 
 such a file is opened by the 
 terminals capture dialog or the prot 
 command).

 The syntax is equivalent to echo.

see also: prot, Protokolldialog

ÝÝCOSHYHLP\METASÝ
ÝWordsÝCOSHYHLP\WORTEÝ
Ý
1.1.1 Meta characters

Meta characters are characters, that 
separate words on a commandline when 
unquoted. They are: <space>, <tab>, 
<newline>, &, |, ;, < and >.

next chapter:

 1.1.2 Words

ÝÝCOSHYHLP\NOISEÝ
ÝbellÝCOSHYHLP\BELLÝ
Ý
   noise filename ...

plays a filename by activating the MOD-file-
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Ý
Ý
  !  cmd ...

Executes cmd and negates the return code.
True becomes false and vica 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\OVERALLÝ
ÝListing of the commandsÝCoSHyÝ
Ý
1.3 Overview of the commands.
1.3.1 General

To have it mentioned: All internal 
commands concerning a certain terminal 
window or the serial port are not 
available while running CoSHy on the TOS 
Screen.

Assigning variables

A special internal command hast the 
structure name=value. The value will be 
assigned to the shell variabe name.

Internal and external commands

If internal and external commands of the 
same name are available CoShy will prefer 
the internal command. To access the 
external one please use the form /path/cmd
to access the external one.

If a command is not available as 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'll also have to export this value to 
the environment.

  PATH='c:/,c:/bin/'
  export PATH

next chapter:
           1.3.1 Listing of the commands.

ÝÝCOSHYHLP\PLAYÝ
Ýanswering machineÝ_AnrufbeantworterÝ
Ý
  play name

plays a zyxel voice file. Output device 
and voice mode have to be set first.

 Return value:
  0 Successful
  1 Successful but message was truncated
  2 Modem is not a ZyXEL
  3 Timeout
  4 Fax call
  5 DTMF-Code received
  6 Data call
 10 Modem is an old ZyXEL
 11 Connect is 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 dialogÝ_ProtokollÝ
Ý
  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 dialog

ÝÝCOSHYHLP\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\DEBUGÝ
ÝActions on a commandlineÝCOSHYHLP\INPWORKÝ
Ý
1.1.6 Debugging

To active CoSHys 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 commandline

ÝÝ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'll have to enter \\.

 ' (Single Quote): All characters, even all
other quote characters loose their special
meaning when found between single quotes.
Inbetween '...' 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\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. This 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"

 reads is a bbsname and starts dialing in.

ÝÝCOSHYHLP\READKEYÝ
Ýtimeout valueÝCOSHYHLP\TIMEFORMÝ
Ý
  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Ý
Ý
  record filename

Gets a voice file from a ZyXel Modem and
writes it to filename.

Return values:

 0   Successful.
 1   Successful: but message was to long
     got truncated
 2   Modem is no ZyXEL
 3   Timeout
 4   Fax-Call
 6   Data Call
 10  Modem is an old ZyXEL
 11  Connect is not registered
 -1  File is read only
 -2  File not found
 -5  Write error
 -13 File access refused
 -28 Disk full

see also:
   answering machine

ÝÝCOSHYHLP\REDRAWÝ
Ý
  redraw

redraws the whole screen before the next
interactive entered command or if the script
exits. 


ÝÝCOSHYHLP\SAVEBUFÝ
Ýsave bufferÝT\SAVPUFÝ
Ý
  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

and select the left coshy button. 

Savebuf is similar to the terminal menu
function save buffer.

ÝÝCOSHYHLP\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 is 
          not available the script maus.scr.

ÝÝCOSHYHLP\SENDÝ
ÝechoÝCOSHYHLP\ECHOÝ
Ý
  send [-n]  arg1 arg2 ....

Is similar to echo but write its arguments 
to the serial device.

example:

 send "at z1"   Send Hayes command for 
                modem reset to profile 1.

ÝÝCOSHYHLP\SENDBREAÝ
ÝSend breakÝT\BREAKÝ
Ý
  sendbreak

On the current Port a 'break' will be sent
(0.7s $00 without start- or stopbit).

This command is equivalent to the action 
Send break in the terminal menu.

ÝÝCOSHYHLP\SETÝ
Ý
  set  arg1 val1 arg2 val2 ...

Without arguments the shellvariables are 
shown. Else identical to arg1=val1; 
arg2=val2; ... (this is not a good unix 
set)

example:

 set HLP 'C:\'  Sets the Shellvariable
                 HLP to 'C:\'.

ÝÝEnvironmentÝ
ÝcdÝCOSHYHLP\CDÝ
Ý
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 pathnames 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>

ù CLIPBRD
  CoNnect trys in several ways to 
  determine the GEM-clipboards name. First 
  it'll try scrp_read(), if this fails 
  CLIPBRD is evaluated. If this still
  fails CoNnect trys to open C:\CLIPBRD.
  In the next step it will ask the user.

ÝÝCOSHYHLP\SETENVÝ
ÝEnvironment variablesÝEnvironmentÝ
Ý
  setenv  arg1 val1 arg2 val2 ...

The environment variables arg1, arg2 ... 
are assigned to the values val1, val2 ...
Shellvariables are not changed in any way 
by this operation. Only $?.

example:

 setenv ROWS 24

see also: Environment variables

ÝÝCOSHYHLP\SHIFTÝ
Ý
  shift  m

moves the values of the shell variables
$1, ... $n to the left. m determines the 
number of moves. It defaults to one if 
omitted. The return code is false(1) if
m > n.

example:

 shift 3

ÝÝCOSHYHLP\SLEEPÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
Ý
  sleep [-t] n

waits a give 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 dialogÝ_TransferÝ
Ý
  slot

without arguments:
prints the current transferslot

using slot n (n between 1 and 8) can be 
used to set the current transfer slot.

See also: Transfer dialog

ÝÝCOSHYHLP\TESTÝ
Ý[ expr ]ÝCOSHYHLP\AUSDRUCKÝ
ÝifÝCOSHYHLP\IFÝ
ÝwhileÝCOSHYHLP\WHILEÝ
Ý
  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 writable.

-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.

test can use brackets to set operator 
hierarchy.

test is called, if the command [ expr ] is 
found.

The result of test, normaly 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Ý
Ý
The time format in CoSHy

You can specify the following units in 
timeformat.

 s = second
 m = millisecond
 M = minute
 H = hour
 h = centisecond

example:

   sleep  42H    waits 42 hours.

ÝÝCOSHYHLP\TRUEÝ
Ý
  # text

Returns always true. Can be used as a 
comment.

example:

 # quit   quit will not be executed as
          its a comment.

ÝÝCOSHYHLP\TRUE1Ý
ÝfalseÝCOSHYHLP\FALSEÝ
Ý
  true

Returns always true. Identical to !false.

example:

 true           Returns '0'
 echo $?

ÝÝCOSHYHLP\UNALIASÝ
ÝaliasÝCOSHYHLP\ALIASÝ
Ý

  unalias cmd

removes an alias definition.

ÝÝCOSHYHLP\UNSETÝ
Ý
  unset arg1 arg2 ...

All variables in the commandline will be 
unset (deleted).

example:

 unset a PATH

  a and PATH will be deleted. The 
  environment variables PATH and a will
  stay untouched.

ÝÝCOSHYHLP\UPLOADÝ
ÝTransfer dialogÝ_TransferÝ
Ý
  upload [-p path]  filename

A file will be uploaded with the parameters
of the transfer dialog. If filename is
missing a fileselector 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 commandline to this
programs. 

The Option -p will allow you to setup a
default uploadpath.

example:

 upload 'c:\test\infile.txt'

see also: Transfer dialog.

ÝÝCOSHYHLP\VERSIONÝ
Ý
  version

 will display connects current version
number. Normally this function will not get
in trouble, if the version number changes
while the command is executed.

ÝÝCOSHYHLP\WAITFORÝ
ÝtimeÝCOSHYHLP\TIMEFORMÝ
Ý
  waitfor [-s -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
 -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Ý
Ý
  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            


ÝÝCOSHYHLP\WORTEÝ
ÝCommand separatorsÝCOSHYHLP\KMDTRÝ
Ý
1.1.2 Worte

A word is a string between to non-quoted
spaces. Metacharacters may also be contents
of a word but only if quoted.

the examples below have all one word per line.


 hello        

 hello\ Pete
 
 hello\       two lines, but 1 word 
 you           

 'Hello You'

 Hello' 'You

 hello" You"   

 "Hello\"\ \"You"
 
next chapter:

 1.1.3 Command separators

ÝÝEdithelpÝ
Ý
Editing of CoNnect-Online-Help

Online help in CoNnect need two files:
CONNECT.HLP and CONNECT.IDX. If you want to
edit help texts (e.g. to remove the lots of
spelling and grammar mistakes) you'll 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 entrys start with the line (a help marker)

 ÝÝHelp entryÝ

where Help entry is an arbitrary marker and
can be used for referencing this help text.
Below this line this references can be 
found.

 ÝTestÝHelp-TestÝ
 ÝTest2ÝHelp-Test2Ý
 Ý

The end of the references is marked by a
single Ý at a 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 phase 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.

ÝÝHistoryÝ
ÝscantableÝCOSHYHLP\SCANTABLEÝ
ÝCharacter SetÝ_ZeichensatzÝ
Ýhistory bufferÝ_PufferÝ
Ý
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.0 has got a
lot of improvements.

New stuff:
----------

 ù CoNnect got a hypertext-like context
   sensitive online help. This will be
   helpful for all the beginners in using
   this program as most complains concern the
   huge number of possible settings.
     
 ù CoNnect got an internal X-, Y-, Z-Modem
   protocol. Get more information, by opening
   the transfer dialog and pressing HELP
   there.
   Compuserve B and B+ are also supported
   internally
   
 ù Finally you are now enabled to see the 
   history buffer in an extra window. All
   selecting and clipping stuff works fine
   there too.
   
 ù CoNnect got so called scan tables. They
   may be used to define any key of the
   ataris 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 became lots of
   faster. (due to the fact i needed it
   myself ;-) 

 ù Statusreports of the TEK-mode are now
   suppressible. This will be a useful
   feature for VMS-users.
     
 ù 115200 Baud on TTs Serial2, on the
   Falcon and MSTEs MODEM2 and SERIAL2
        
 ù Preparations for Mag!X (1.11 and 2.0)

 ù The dialing dialog got color icons.

 ù Pressing shift an double-clicking an phonebook
   entry will activate a continuous dial for one
   specific number

 ù ^ in the dialing sequence will pull down DTR for
   700 ms

 ù + Entrys in CONNECT.NUM
       
   +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 - this 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 dialog you can now set
   <lf> to clear screen.

 ù MTOS:
    Drag and Drop: CoNnect will start uploading when
      you drag Files on its windows.

 ù Money (Philipps 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 @

 ù Realtime Slider in the dialing dialog 

ÝÝGeneralÝ
ÝhereÝOnlinehilfeÝ
ÝCoSHyÝCoSHyÝ
Ýmain menuÝHauptmenÝ
Ýterminal menuÝMenue-TermÝ
Ýtektronix menuÝMenue-TekÝ
Ýcreating help filesÝEdithelpÝ
ÝsharewareÝSharewareÝ
Ýnew stuff in 2.10ÝHistoryÝ
Ý
 This is the online help for CoNnect.
 
 Don't forget that CoNnect is a shareware 
product. It is not freeware or public domain - 
you have to pay for its usage.

 If you want to learn something about the
help system - please double-click here.

Other help may be obtained for

    main menu
    terminal menu
    tektronix menu
    CoSHy

    new stuff in 2.10
    
    creating help files

