ÝÝIndexÝ
ÝAnswering MachineÝ_AnrufbeantworterÝ
ÝAnswering ParamsÝ_AnrufparameterÝ
ÝASCII UploadÝ_AsciiuploadÝ
ÝBaud RateÝBaudrateÝ
ÝBinary FilesÝBin„rdateienÝ
ÝBreakÝT\BREAKÝ
ÝBufferÝ_PufferÝ
ÝBugreportsÝFehlerÝ
ÝCaptureÝ_ProtokollÝ
ÝCharacter SetÝ_ZeichensatzÝ
ÝClear BufferÝT\CLRPUFÝ
ÝClear ScreenÝT\CLRSCRÝ
ÝClipboard Intro'ÝKlemm-AllgÝ
ÝClipboardÝKlemmbrettÝ
ÝCloseÝgl_SchlieáenÝ
ÝColoursÝ_FarbenÝ
ÝComms ResetÝT\KRESETÝ
ÝCompatibilityÝ_Kompatibilit„tÝ
ÝCOSHY\ALERTÝCOSHYHLP\ALERTÝ
ÝCOSHY\ALIASÝCOSHYHLP\ALIASÝ
ÝCOSHY\BAUDÝCOSHYHLP\BAUDÝ
ÝCOSHY\BELLÝCOSHYHLP\BELLÝ
ÝCOSHY\BLITMODEÝCOSHYHLP\BLITMODEÝ
ÝCOSHY\BREAKÝCOSHYHLP\BREAKÝ
ÝCOSHY\CASEÝCOSHYHLP\CASEÝ
ÝCOSHY\CARRIERÝCOSHYHLP\CARRIERÝ
ÝCOSHY\CDÝCOSHYHLP\CDÝ
ÝCOSHY\CMDTRÝCOSHYHLP\KMDTRÝ
ÝCOSHYÝCoSHyÝ
ÝCOSHY\CTTYÝCOSHYHLP\CTTYÝ
ÝCOSHY\DEBUGÝCOSHYHLP\DEBUGÝ
ÝCOSHY\DIALÝCOSHYHLP\DIALÝ
ÝCOSHY\DOWNLOADÝCOSHYHLP\DOWNLOADÝ
ÝCOSHY\ECHOÝCOSHYHLP\ECHOÝ
ÝCOSHY\ENVÝCOSHYHLP\ENVÝ
ÝCOSHY\EVALÝCOSHYHLP\EVALÝ
ÝCOSHY\EXITÝCOSHYHLP\EXITÝ
ÝCOSHY\EXPRÝCOSHYHLP\EXPRÝ
ÝCOSHY\EXPRESSIONÝCOSHYHLP\AUSDRUCKÝ
ÝCOSHY\FALSEÝCOSHYHLP\FALSEÝ
ÝCOSHY\FILESELÝCOSHYHLP\FILESELÝ
ÝCOSHY\FKYÝCOSHYHLP\FKYÝ
ÝCOSHY\FLUSHÝCOSHYHLP\FLUSHÝ
ÝCOSHY\FORÝCOSHYHLP\FORÝ
ÝCOSHY\FUNCTIONÝCOSHYHLP\FUNCTIONÝ
ÝCOSHY\GETKEYÝCOSHYHLP\GETKEYÝ
ÝCOSHY\GETÝCOSHYHLP\GETÝ
ÝCOSHY\GETTONEÝCOSHYHLP\GETTONEÝ
ÝCOSHY\HANGUPÝCOSHYHLP\HANGUPÝ
ÝCOSHY\HOLDSCRNÝCOSHYHLP\HOLDSCRNÝ
ÝCOSHY\IFÝCOSHYHLP\IFÝ
ÝCOSHY\IOREDIRÝCOSHYHLP\IOREDIRÝ
ÝCOSHY\LOGÝCOSHYHLP\LOGÝ
ÝCOSHY\METASÝCOSHYHLP\METASÝ
ÝCOSHY\MISCÝCoSHy-AllgÝ
ÝCOSHY\NOISEÝCOSHYHLP\NOISEÝ
ÝCOSHY\NOTÝCOSHYHLP\NOTÝ
ÝCOSHY\OVERALLÝCOSHYHLP\OVERALLÝ
ÝCOSHY\PLAYÝCOSHYHLP\PLAYÝ
ÝCOSHY\PROTÝCOSHYHLP\PROTÝ
ÝCOSHY\QUITÝCOSHYHLP\QUITÝ
ÝCOSHY\QUOTESÝCOSHYHLP\QUOTESÝ
ÝCOSHY\READÝCOSHYHLP\READÝ
ÝCOSHY\READKEYÝCOSHYHLP\READKEYÝ
ÝCOSHY\RECORDÝCOSHYHLP\RECORDÝ
ÝCOSHY\REDRAWÝCOSHYHLP\REDRAWÝ
ÝCOSHY\SAVEBUFÝCOSHYHLP\SAVEBUFÝ
ÝCOSHY\SCANTABLEÝCOSHYHLP\SCANTABLEÝ
ÝCOSHY\SCRIPTÝCOSHYHLP\SCRIPTÝ
ÝCOSHY\SENDÝCOSHYHLP\SENDÝ
ÝCOSHY\SENDBREAKÝCOSHYHLP\SENDBREAKÝ
ÝCOSHY\SETENVÝCOSHYHLP\SETENVÝ
ÝCOSHY\SETÝCOSHYHLP\SETÝ
ÝCOSHY\SHIFTÝCOSHYHLP\SHIFTÝ
ÝCOSHY\SLEEPÝCOSHYHLP\SLEEPÝ
ÝCOSHY\SLOTÝCOSHYHLP\SLOTÝ
ÝCOSHY\STARTÝgl_CoSHystartÝ
ÝCOSHY\TESTÝCOSHYHLP\TESTÝ
ÝCOSHY\TIMEFORMÝCOSHYHLP\TIMEFORMÝ
ÝCOSHY\TRUEÝCOSHYHLP\TRUEÝ
ÝCOSHY\TRUE1ÝCOSHYHLP\TRUE1Ý
ÝCOSHY\UNALIASÝCOSHYHLP\UNALIASÝ
ÝCOSHY\UNSETÝCOSHYHLP\UNSETÝ
ÝCOSHY\UPLOADÝCOSHYHLP\UPLOADÝ
ÝCOSHY\VERSIONÝCOSHYHLP\VERSIONÝ
ÝCOSHY\WAITFORÝCOSHYHLP\WAITFORÝ
ÝCOSHY\WHILEÝCOSHYHLP\WHILEÝ
ÝCOSHY\WORDÝCOSHYHLP\WORTEÝ
ÝData BitÝDatenbitÝ
ÝDiallingÝ_WahlÝ
ÝDialling EditorÝT-EditorÝ
ÝDial with K'boardÝWahltastaturÝ
ÝDial with MouseÝWahlmausÝ
ÝDisplayÝ_DarstellungÝ
ÝDownloadÝT\DOWNLOADÝ
ÝEchoÝEchoÝ
ÝEditing of HelpÝEdithelpÝ
ÝEmulationÝ_EmulationÝ
ÝEmulation Intro'ÝEmulation-EinfÝ
ÝEnvironmentÝEnvironmentÝ
ÝFile TransferÝ_TransferÝ
ÝFix SetupÝT\FIXSETÝ
ÝFull SizeÝgl_Volle_Gr”áeÝ
ÝFunction KeysÝ_FunktionstastenÝ
ÝGreenÝGrnenÝ
ÝHandshakeÝHandshakeÝ
ÝHangupÝT\HANGUPÝ
ÝHistoryÝHistoryÝ
ÝHold ScreenÝholdscreen-aktivÝ
ÝHotkeysÝ_HotkeysÝ
ÝInformationÝ_InfoÝ
ÝIO-BufferÝSchnittstellenpufferÝ
ÝJokeÝWitzÝ
ÝLearnÝ_LernenÝ
ÝLoad SetupÝT\LOASETÝ
ÝLoad NumbersÝT-LadenÝ
ÝGeneralÝ_AllgemeinesÝ
ÝMain MenuÝHauptmenÝ
ÝManualÝHandbuchÝ
ÝMarkÝMarkierenÝ
ÝMenÝm„nnerfeindlichÝ
ÝMichael ZieglerÝZieglerÝ
ÝModem ParametersÝModemparameterÝ
ÝNew in 2.00ÝNeues2.0nÝ
ÝNew in 2.01ÝNeues2.0nÝ
ÝNew in 2.02ÝNeues2.0nÝ
ÝNew in 2.10ÝNeues2.10Ý
ÝNew in 2.20ÝNeues2.20Ý
ÝNew in 2.4xÝNeues2.40Ý
ÝOn-line HelpÝOnlinehilfeÝ
ÝOpenÝgl_™ffnenÝ
ÝOptionsÝgl_OptionenÝ
ÝParityÝParit„tÝ
ÝPasteÝPasteÝ
ÝPaths & FilenamesÝpathselÝ
ÝPoliceÝPolizeiÝ
ÝPortÝPortÝ
ÝPortÝ_PortÝ
ÝPricesÝPreislisteÝ
ÝProgrammerÝProgrammiererÝ
ÝProgram StartÝProgrammstartÝ
ÝQuitÝgl_BeendenÝ
ÝQuoteÝquotenÝ
ÝRegistrationÝ_RegistrierungÝ
ÝReplayÝT\REPLAYÝ
ÝRotate WindowsÝgl_RotierenÝ
ÝSave BufferÝT\SAVPUFÝ
ÝSave SetupÝT\SAVSETÝ
ÝScan TablesÝScantabelleÝ
ÝStart a ScriptÝgl_ScriptstartÝ
ÝSharewareÝSharewareÝ
ÝStart a ShellÝgl_ShellstartÝ
ÝSizeÝ_SizeÝ
ÝSmileyÝSmileyÝ
ÝSoundsÝ_SoundÝ
ÝStatisticsÝ_StatistikÝ
ÝStatus lineÝ_StatuszeileÝ
ÝRememberÝErinnerungshilfeÝ
ÝSending KeysÝTastenVersendenÝ
ÝSmileÝL„chelnÝ
ÝTabulatorÝ_TabulatorÝ
ÝTektronix MenuÝMenue-TekÝ
ÝTektronix SetupÝ_TeksetupÝ
ÝTektronix WindowÝTektronixfensterÝ
ÝTerminalÝTerm-AllgÝ
ÝTerminal MenuÝMenue-TermÝ
ÝTerminal ResetÝT\RESETÝ
ÝTerminal WindowÝTerminalfensterÝ
ÝTOS-ShellÝT\TOSSHELLÝ
ÝTrash CanÝPapierkorbÝ
ÝTransfer Info'Ý_DerTransferÝ
ÝType Ahead BufferÝ_VorschreibzeileÝ
ÝUploadÝT\UPLOADÝ
ÝUpdatesÝUpdatesÝ
ÝUserÝAnwenderÝ
ÝWindowÝFensterÝ
ÝWindow DialoguesÝFensterdialogeÝ
ÝWindows GeneralÝFens-AllgÝ
ÝWindow MenuÝFenstermenÝ
ÝWindow NamesÝgl_FensternamenÝ
ÝZ-Modem ParamsÝZmodemparameterÝ
Ý

CoNnect Index
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
Answering Machine
Answering Params
ASCII Upload
Baud Rate
Binary Files
Break
Buffer
Bugreports
Colours
Comms Reset
Compatibility
Capture
Character Set
Clear Buffer
Clear Screen
Clipboard
Clipboard Intro'
Close
COSHY
COSHY\ALERT
COSHY\ALIAS
COSHY\BAUD
COSHY\BELL
COSHY\BLITMODE
COSHY\BREAK
COSHY\CARRIER
COSHY\CASE
COSHY\CD
COSHY\CMDTR
COSHY\CTTY
COSHY\DEBUG
COSHY\DIAL
COSHY\DOWNLOAD
COSHY\ECHO
COSHY\ENV
COSHY\EVAL
COSHY\EXIT
COSHY\EXPR
COSHY\EXPRESSION
COSHY\FALSE
COSHY\FILESEL
COSHY\FKY
COSHY\FLUSH
COSHY\FOR
COSHY\FUNCTION
COSHY\GET
COSHY\GETKEY
COSHY\GETTONE
COSHY\HANGUP
COSHY\HOLDSCRN
COSHY\IF
COSHY\IOREDIR
COSHY\LOG
COSHY\METAS
COSHY\MISC
COSHY\NOISE
COSHY\NOT
COSHY\OVERALL
COSHY\PLAY
COSHY\PROT
COSHY\QUIT
COSHY\QUOTES
COSHY\READ
COSHY\READKEY
COSHY\RECORD
COSHY\REDRAW
COSHY\SAVEBUF
COSHY\SCANTABLE
COSHY\SCRIPT
COSHY\SEND
COSHY\SENDBREAK
COSHY\SET
COSHY\SETENV
COSHY\SHIFT
COSHY\SLEEP
COSHY\SLOT
COSHY\START
COSHY\TEST
COSHY\TIMEFORM
COSHY\TRUE
COSHY\TRUE1
COSHY\UNALIAS
COSHY\UNSET
COSHY\UPLOAD
COSHY\VERSION
COSHY\WAITFOR
COSHY\WHILE
COSHY\WORD
Data Bit
Dialling
Dialling Editor
Dial with K'board
Dial with Mouse
Display
Download
Echo
Editing of Help
Emulation
Emulation Intro'
Environment
File Transfer
Fix Setup
Full Size
Function Keys
General
Green
Handshake
Hangup
History
Hold Screen
Hotkeys
Information
IO-Buffer
Joke
Learn
Load Numbers
Load Setup
Main Menu
Manual
Mark
Men
Michael Ziegler
Modem Parameters
New in 2.00
New in 2.01
New in 2.02
New in 2.10
New in 2.20
New in 2.4x
On-line Help
Open
Options
Parity
Paste
Paths & Filenames
Police
Port
Prices
Program Start
Programmer
Quit
Quote
Registration
Remember
Replay
Rotate Windows
Save Buffer
Save Setup
Scan Tables
Sending Keys
Shareware
Size
Smile
Smiley
Sounds
Start a Script
Start a Shell
Statistics
Status line
TOS-Shell
Tabulator
Tektronix Menu
Tektronix Setup
Tektronix Window
Terminal
Terminal Menu
Terminal Reset
Terminal Window
Transfer Info'
Trash Can
Type Ahead Buffer
Updates
Upload
User
Window
Window Dialogues
Window Menu
Window Names
Windows General
Z-Modem Params

ÝÝ_Warn1Ý
Ý

A baud rate was demanded which is not available
on this port.  Either  choose  another  port or
another baud rate  in  the  'Port'  dialogue or
select another compression method (celp) if the
answering machine  has  produced  this  warning
message.

ÝÝ_Warn6Ý
Ý

Windows running CoSHy or external shells,  must
be  completely  visible  on  operating  systems
without 'pipes', (only  MiNT  utilises pipes so
far). Move the window to place its working area
inside the screen.

ÝÝ_Warn8Ý
Ý

CoNnect needs  the  GEM-Clipboard  for  various
purposes.   It   searches   for   an  installed
Clipboard in the following ways:

1) scrp_read(): Looks for a clipboard.

     Installed by another  GEM application. For
     instance  CLIPBORD.CPX   does   install  a
     Clipboard and CoNnect  will  no longer ask
     the user to do this.

2) The environment variable CLIPBRD.

     CoNnect will  read  the  contents  of this
     variable as  the  current  clipboard.  You
     can use ENVIRON.PRG in your AUTO-Folder to
     permanently install this  variable and get
     rid   of   CoNnect's   questions   for   a
     clipboard.

3) C:\CLIPBRD: If this path is available.

     CoNnect will use is as the GEM-Clipboard.

4) If 1-3 fail, CoNnect will ask the user.

     You may help yourself  with  points 1-3 to
     get rid of CoNnect's demand for installing
     a clipboard.

ÝÝ_Warn24Ý
Ý

CoNnect says:

You are already CoNnected to  an host with this
window.

This means CoNnect sees  a  carrier signal from
your modem. There may be several reasons:

  1)
     You really are  connected  to  a  host. In
     this case it is  not  a  good idea to dial
     and this is why CoNnect warns you.

  2)
     Your Modem sends  a  carrier  detect, even
     though you are not  connected. Either your
     modem is badly configured  or it's carrier
     detect signal does not work at all.

  3)
     You are using a bad cable to connect modem
     and the Atari. Use a good cable.

In  the  last  two  cases   you  might  find  a
possibility to fix your problem.  Otherwise you
can (losing CoNnect's charge statistics) switch
off the button  'check  carrier'  in  the modem
dialogue 1.  This will help  you to at least be
able to dial.

ÝÝ_Warn44Ý
ÝregisterÝSharewareÝ
Ý

CoNnect is  a  Shareware program.
As you have tested  it for a very
long time, you  must  register if
you want to continue using it.

ÝÝ_Warn57Ý
ÝhereÝ_Warn24Ý
Ý

CoNnect sees  that  the  port  is
currently locked by  another part
of the  program.  Though  this is
nearly always true,  there may be
a reason why  CoNnect believes it
has received  a   Carrier  signal
from you modem even though it has
not.  A possible  solution  for a
similar problem is given here.

ÝÝ_Warn78Ý
Ý

You started a new CoNnect Version
using and old .OPT file.  CoNnect
now tries  to  evaluate  the  old
information as much  as possible.
You  will  have   to  check  this
conversion afterwards.

ÝÝWarn82Ý
ÝhereÝCompuserveportÝ
Ý
Your port setup  doesn't  allow a secure
file transmission to or from Compuserve.
You need the setting:

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

Terminal Menu
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
-------------------------------------------------------------
   Terminal           Setup                 Misc
-------------------------------------------------------------
   File Transfer      Emulation...          CoSHy
   Terminal Size      Character Set...      Script...
   --------------     Display...            Learn A Script...
   Terminal Reset     Capture...            TOS-Shell
   Commun. Reset      Tabulator...          TEK 4014 Window
   Hangup             Port...               Answering Machine
   Clear Screen       Function Keys...      Fax...
   Clear Buffer       Compatibility...      -----------------
   Save Buffer...     Status Line...        Dial...
   Copy Buffer        TEK Parameters...     -----------------
   Send Break         --------------        ASCII-Upload
   --------------     Fix Setup             Upload
   Close Window       --------------        Download
                      Load Setup...         Replay
                      Save Setup...

ÝÝT\UPLOADÝ
Ýfile transfer dialogueÝ_TransferÝ
Ý

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

ÝÝT\DOWNLOADÝ
Ýfile transfer dialogueÝ_TransferÝ
Ý

Download
ÿÿÿÿÿÿÿÿ
Using the menu item "Download..." you can
receive  a  file   with   the  parameters
specified in the file transfer dialogue.

ÝÝT\REPLAYÝ
ÝASCII-UploadÝ_AsciiuploadÝ
ÝemulationÝ_EmulationÝ
ÝUploadÝT\UPLOADÝ
Ý

Replay
ÿÿÿÿÿÿ
A file from disk  will be displayed using
the current emulation.

ATTENTION:

No characters of the file  will be sent to
the modem. If you want to do this, use the
commands "Upload"  or  "ASCII-Upload".

ÝÝT\TOSSHELLÝ
ÝSHELLÝEnvironmentÝ
Ý

TOS-Shell (Terminal Menu)
ÿÿÿÿÿÿÿÿÿ
Start the TOS-Shell  in the current
window if one is available. Use the
environment  variable $SHELL or the
_shell_p pointer to  install a TOS-
Shell.

ÝÝT\SAVPUFÝ
Ý

Save Buffer
ÿÿÿÿÿÿÿÿÿÿÿ
All data  in  the   current  history
buffer will be saved to a disk file.

ÝÝT\CLRPUFÝ
Ý

Clear Buffer
ÿÿÿÿÿÿÿÿÿÿÿÿ
All data  in  the   current history
buffer will be cleared.

ÝÝT\BREAKÝ
ÝsendbreakÝCOSHYHLP\SENDBREAKÝ
Ý

Send a Break
ÿÿÿÿÿÿÿÿÿÿÿÿ
CoNnect sends a break signal to the
modem.

SEE ALSO: sendbreak (CoSHy Command)

ÝÝCLOWINÝ
Ý

Close Window
ÿÿÿÿÿÿÿÿÿÿÿÿ
The top window will be closed.

ÝÝT\RESETÝ
ÝFix SetupÝT\FIXSETÝ
ÝLoad SetupÝT\LOASETÝ
ÝSave SetupÝT\SAVSETÝ
Ý

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

ÝÝT\CLRSCRÝ
Ý

Clear Screen
ÿÿÿÿÿÿÿÿÿÿÿÿ
The current window will be cleared.

ÝÝT\KRESETÝ
Ýhold screenÝholdscreen-aktivÝ
Ý

Communication Reset
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
All characters pending  in  the IO-Queue
will be discarded. A  possible state  of
hold screen will be cleared.

ÝÝT\HANGUPÝ
ÝDialÝ_WahlÝ
Ý'hangup'ÝCOSHYHLP\HANGUPÝ
Ý

Hangup
ÿÿÿÿÿÿ
The modem will be forced to hangup the
phone. The  way  this  is  done can be
set in the "Dial" dialogue.

SEE ALSO: 'hangup' (CoSHy Command)

ÝÝT\FIXSETÝ
Ýterminal resetÝT\RESETÝ
Ý

Fix Setup
ÿÿÿÿÿÿÿÿÿ
All current settings will be remembered
for a later terminal reset.

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

Load Setup
ÿÿÿÿÿÿÿÿÿÿ
This option will load a terminal setup,
saved by "Save Setup", from disk.

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

Save Setup
ÿÿÿÿÿÿÿÿÿÿ
The current  terminal  settings  will  be  saved to
disk. Terminal settings are  all possible  settings
that can  be  changed   within  the  terminal menu.
There is  one  exception  to  this  rule; telephone
numbers in the "Dial"  dialogue  are  stored in the
telephone book. Only  the  name  of  this telephone
file will be stored in the setup.

Using "Load Setup", you can reload a saved setup.

Before a  "Save Setup"  is  performed, CoNnect will
automatically do a "Fix Setup".

ÝÝ_PufferÝ
Ýselecting, sendingÝMarkierenÝ
Ý

The Buffer Window
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
The buffer  window is  opened  by  the  menu  item
"Copy Buffer" in the terminal menu.

The buffer window enables  you to have the history
buffer in a separate  window  while your data-flow
is running in the terminal window.

Using the buffer window you can perform any marked
text operations  (selecting, sending),  exactly as
if they  were being done from the terminal window.

ÝÝ_WahlÝ
ÝclipboardÝKlemmbrettÝ
Ýtrash canÝPapierkorbÝ
Ýmodem parameterÝModemparameterÝ
Ýphone editorÝT-EditorÝ
Ýload numbersÝT-LadenÝ
Ýsave numbersÝT-LadenÝ
Ýthe mouseÝWahlmausÝ
Ýor the keyboardÝWahltastaturÝ
Ý

In the "Dial" dialogue, the  telephone book is displayed
on the right-hand side and  the  repeated dial memory is
displayed on the left-hand  side.  Dragging entries from
the telephone book to the  repeated dial memory and then
clicking on the telephone  icon,  will  cause CoNnect to
dial all of the  numbers  in  the  repeated dial memory.
When the last entry has been dialled, CoNnect will start
again at the first entry.

There are many icons to manipulate the telephone book or
modem settings. The icons  from  top  to bottom are, the
phone editor, load numbers, save numbers, and the sorter
icon. The line of icons  at  the  bottom of the dialogue
box are, the trash can, the clipboard, and the two modem
parameter icons. Finally, above the repeated dial memory
there is the telephone icon.

You can use either the mouse  or the keyboard to operate
the "Dial" dialogue.

ÝÝWahlmausÝ
Ý

Dialling with the Mouse
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
You may select entries in the telephone book by clicking on
them. Doing this while pressing  the  SHIFT key will append
the new item to a  previously  made selection. If you click
to the left of the telephone book and hold the mouse button
down, you can use a rubber-band  to select several items at
once. If you click to the left of the telephone book but do
not hold the  mouse  button  down,  you  will  deselect all
selected entries. You may use  the  repeated dial memory in
an identical fashion.

You may add entries to the repeated dial memory by dragging
them from the telephone  book  to  the repeated dial memory
(moving the mouse while the left button is held down).

Deleting entries from the  telephone  book, or the repeated
dial memory, is done by dragging  them to the trash can. In
the repeated dial memory, a  double-click  on an entry will
cause the number to be  dialled  (and deleted from the list
if a connection is made).

You can change the order of  entries in the telephone book,
or in the repeated dial memory,  by simply dragging them to
their new location.

The Most Important Icon:  The Telephone

Clicking on the  telephone icon will cause CoNnect to start
dialling the entries within  the  repeated dial memory, and
continue dialling until a connection  can be established or
a user definable event (SEE: modem parameter) occurs.

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

Double-clicking on an entry  in   the  telephone book while
pressing SHIFT will start  dialling  attempts to this entry
until a connection is established.

ÝÝWahltastaturÝ
Ý

Dialling with the Keyboard
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
You can operate the "Dial" dialogue with the following keys:

Cursor Keys

  UP, DOWN:     - Moves the cursor  (a rubber-band) up and down one
                  entry at a time.

  LEFT, RIGHT:  - Moves   the   cursor  from   the   repeated  dial
                  memory to the telephone book and back again.

  SHIFT + UP:
  SHIFT + DOWN: - Moves the cursor up and down one page at a time.

Pressing normal keys will cause connect  to  move the cursor to the
entry with a name that matches the pressed keys.

  CLRHOME:              - Move to the first entry.

  SHIFT + ClrHome:      - Move to the last entry.

  INSERT:               - Marks an entry as being selected.

  SHIFT+INSERT:         - Marks  an   entry  as   being   selected,
                          without  deselecting  previously selected
                          entries.

  CONTROL+INSERT:       - Moves  an  entry  to  the  repeated  dial
                          memory or moves it  back to the telephone
                          book.

  SHIFT+CONTROL+INSERT: - Performs a single dialling attempt on the
                          entry.

  DELETE: - Mark an entry as deselected.

  ^E:     -  Enter  the  dialling  editor.  If  there  are selected
             entries, they can all be edited.

  ^M:     - Enter the first modem configuration dialogue box.

  ^N:     - Enter the second modem configuration dialogue box.

  ^S:     - Save the telephone book  (and the repeated dial memory)
            to disk.

  ^O:     - Load the telephone book  (and the repeated dial memory)
            from disk.

  ^I:     - Toggle sorting  of  numbers  (off,  alphabetical, or by
            numbers).

  ^V:     - Copy the clipboard to the telephone book.

  ^C:     - Copies marked numbers to the clipboard.

  ^W:     - Dial the selected entries.

  ^A:     - Select  all  entries  in  the  telephone  book  or  the
            repeated dial memory, depending on where the cursor is.

  ^R:     - Rotate the repeated dial memory.

  ^T:     - Copy all selected entries to the repeated dial memory.

  ^X:     - Mark all selected entries as deselected.

ÝÝT-LadenÝ
Ý

Load Numbers
ÿÿÿÿÿÿÿÿÿÿÿÿ
The two disk icons are used to save and load
telephone books.

Loading a telephone  book  will  replace the
old one, unless the SHIFT  key is held down.
If you hold  the  SHIFT  key  down,  the new
telephone book will be  appended  to the old
one.

The same  applies  for  saving.  Saving  the
telephone  book  will   delete  an  existing
telephone book file.  If  the  SHIFT  key is
held  down,  the  telephone   book  will  be
appended to the existing file.

ÝÝT-EditorÝ
Ý

The Phone Editor
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
This editor may be  used  to change the data
in your telephone book.

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

Dragging existing entries to  this icon will
allow you to modify them.

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

All three strings may  contain three special
characters:

| = Carriage Return
~ = 0.5 Second Delay
^ = Pull DTR Low (0.5 Seconds)

You may also select a  script to be executed
as an automatic login script  to your bbs if
the connection is established.

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

ÝÝModemparameterÝ
Ý

Modem Reactions
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
By clicking on the first modem icon, you can
setup the way CoNnect reacts to modem return
codes while dialling. In  the  first row you
enter the modem  messages.  To  the right of
the modem  messages,  you  can  specify  how
CoNnect reacts.  If you  do not want CoNnect
to act on  a  specific  modem  response just
remove this response from the response list.
Normally,  CoNnect  reacts   on   any  modem
response   BEGINNING   with    the   entered
characters.  If  you  want  CoNnect  to only
react  to  identical   responses,  append  a
CONTROL-M (CR) to the response string.

There are also  waiting  parameters. You can
specify how  long  CoNnect  waits  until  it
dials the next number  in  the dialling list
(first parameter)  and  how  long  it  waits
until dialling the first  number in the list
again.

By clicking on the second modem icon you can
specify the  delay  between  the  characters
sent to the  modem  when  dialling. Some low
quality modems need long  delays like 100MS.
You can  also  enter  the  default  dialling
sequence strings  used  when  you  enter new
numbers in the phone editor, or when reading
in a SCRAP.TXT file from the clipboard.

ÝÝKlemmbrettÝ
Ý

Clipboard
ÿÿÿÿÿÿÿÿÿ
The CoNnect clipboard is compatible with the
GEM-Clipboard.  CoNnect  will   ask  you  to
install a Clipboard  if  this  has  not been
done on  your  system  yet  (there  are many
public domain programs  to  do  this)  or if
CoNnect cannot find  the  folder C:\CLIPBRD.
If there is anything  in  the clipboard, the
clipboard icon will have  a written piece of
paper  on  it.  If  the  clipboard  contains
telephone  book  information,   it   may  be
dragged to the telephone book.  You can drag
numbers  from  the  telephone  book  or  the
repeated dialling memory to the clipboard.

Pressing SHIFT  during  this  action  causes
CoNnect to append the entry to the clipboard
data, rather than write over it.

ÝÝPapierkorbÝ
Ý

The Trash Can
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
Everything you drag onto  the trash can will
be lost. An "UNDO"  is  only possible if you
leave the dialling  dialogue  by  CANCEL; in
which case all changes to this dialogue will
be discarded.  When  dragging  the clipboard
onto the  trash  can,  the  contents  of the
clipboard will always be  lost. No "UNDO" is
possible.

ÝÝ_VorschreibzeileÝ
Ý

The Type Ahead Buffer
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
You can activate  the  type  ahead buffer by
pressing  CONTROL+INSERT   from   within   a
terminal window. Everything  you type inside
this window will be sent to the modem if you
end this  input  with  an  ENTER  or RETURN.
Pressing "UNDO" will cancel your input.

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

ÝÝ_DerTransferÝ
Ýmulti-taskingÝ_TransferÝ
Ý

File transfer is in progress.
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
To cancel just press the cancel button or type
^C in case you disabled the multi-tasking.

 þ In the upper box you see:

      +--------------------------------+
      | 111111111111111111     22222   |
      | 333333333333333333     44444   |
      | 555555555555555555     77777   |
      | 666666666666666666             |
      +--------------------------------+

   1) A bar that  displays  the amount of data
      already transferred.

   2) The protocol options.

   3) In multiple-file  transfers  another bar
      displaying  the  status   of  the  whole
      transfer.

   4) In multiple-file transfers the number of
      files in total.

   5) The filename.

   6) The path.

   7) The current block size.

 þ In the middle box you will find:

      +--------------------------------+
      |  1111/2222 3333/4444 5555/6666 |
      |  7777/8888      9999 aaaa/bbbb |
      +--------------------------------+

  1) The amount of data already transferred in
     bytes.

  2) The total size of the current file.

  3) The current speed of the transfer.

  4) The average speed of the transfer.

  5) The time spent so far.

  6) The estimated time needed.

   For multiple-file transfers only:

  7) The amount of data already transferred in
     bytes.

  8) The total size of all files.

  9) The average speed of the transfer.

     a) The time spent so far.

     b) The estimated time needed in total.

 þ In the lower box:

    ... you will get  status reports about the
        protocol.

ÝÝCompuserveportÝ
ÝportÝ_PortÝ
ÝdatabitsÝDatenbitÝ
ÝparityÝParit„tÝ
ÝstopbitÝDatenbitÝ
Ý8N1ÝCOSHYHLP\BAUDÝ
Ý7E1ÝCOSHYHLP\BAUDÝ
ÝcompatibilityÝ_Kompatibilit„tÝ
Ý
For a file transfer with  CompuServe you
need the following setup for your serial
port:

8 databits | no parity | 1 stopbit (8N1)

With CompuServe  sending in 7E1 mode you
need to get rid of the 8th databit for a
clean display. The  8th  bit  should  be 
stripped in the compatibility dialog.

ÝÝZmodemparameterÝ
Ýspecial port setupÝCompuserveportÝ
Ý

Here is a short  listing  of  the  options  available with the
internal transfer module.

Popup #1 - Protocol:
--------------------
 ù Z-Modem:  This is  the  best  choice  if your host supports
             this protocol. It is very fast, and has excellent
             error recovery.

 ù Y-Modem:  This  is  slower  than  Z-Modem,  but still quite
             fast, but not as error-proof as Z-Modem.

 ù X-Modem:  This should only  be  used  if your host does not
             support any other protocol. It is very slow!

 ù X-Modem7: A protocol, used at least by CompuServe.

 ù CompuServe B:
 ù CompuServe B+: Two protocols used only by CompuServe.
                 You need a special port setup for CompuServe.

Popup #2 - Buffer Size:
-----------------------
You may choose between 128, 256, 512 and 1024 byte blocks. The
resulting buffer size will be  your chosen one or  below  this
depending on the  parameters  of  your  host. For X-Modem only
128 or 1024 bytes  are  useful.  Y-Modem  will always use 1024
Bytes regardless  of your settings. For Z-Modem you may select
8192  byte  blocks but be aware  that this option does not run
with Omen Z-Modem products but with  GEMSZRZ and some unix im-
plementations.

Popup #3 - Data Protection:
---------------------------
 ù Overwrite will always overwrite existing files.

 ù Protect will  cause  an  error  condition  when receiving a
   filename which already exists on your system.

 ù Resume will try to  perform  an  error recovery. In fact it
   will append missing parts to already existing files.

 ù Ask User will ask the user if a file should be overwritten,
   skipped, or resumed if the file already exists.

 ù Rename will cause CoNnect  to  create  a unique name for an
   incoming file if a file with that name already exists.

Popup #4 - Escapes:
-------------------
 ù No Escapes is normally used  on lines which will not filter
   any of the possible 256 8-Bit characters.

 ù Escapes On has to be  used  if  you are working  on certain
   Unix systems which  have  TTYs  which   will filter control
   characters. Transmission is much slower when using escapes.

Popup #5 - Data Type:
---------------------
 You may decide here if  you  are transferring Binary data (no
 conversion performed) or  ASCII  data  (linefeeds  have to be
 changed).

 Automatic data type detections  will  try  to  guess the data
 type by  the  file  extension.   This  is  not  always  safe.
 CoNnect assumes the following extensions  to be extensions of
 ASCII Files:

            TXT, ASC, RTF, C, CPP, C++, H, PAS, F,

            FOR, F77, CAR, PS, EPS, XBM, TEX, STY

Popup #6 - Checksums:
---------------------
 You may select  either  CHECKSUM  (X/Y-Modem), CRC-16 (X/Y/Z-
 Modem) or the standard CRC-32  (Z-Modem) which gives the most
 security.

Full Paths: (not available with CompuServe)
-----------
 Only a few hosts allow this option to be switched on. It will
 send full pathnames  and  try  to  create directories on your
 system if full pathnames are received.

Choose Filenames: (CompuServe only)
-----------------
 When Uploading a fileselector will let the user chose the fie
 to send. This  option  does  not  allow  the  flag 'No Multi-
 tasking' (see below) to be set.

Force Acknowledge:
------------------
 Normally, CoNnect's Z-Modem  runs  in  Stream  Mode.  If this
 switch is on,  CoNnect  wants  an  acknowledge  from the host
 after each transmitted block. This will decrease transmission
 speed.

No Multi-tasking:
-----------------
 If you need  really  high  speed  transfers  this option will
 disable all multi-tasking  within CoNnect  and the system. To
 stop a running transfer you will have to press Control-C.

File attributes:
----------------
 If set, CoNnect sets  the  read-only  flag  of received files
 like the one of the original file.

Concerning Transmission Speed:

 You will obtain high transmission rates  when you set a large
 IO-Buffer in the "Port" dialogue.  A value of 8192 bytes is a
 good choice.

ÝÝ_TransferÝ
Ýbinary filesÝBin„rdateienÝ
ÝGSZRZACCÝZieglerÝ
ÝhereÝZmodemparameterÝ
ÝMichael ZieglersÝZieglerÝ
ÝpathsÝpathselÝ
ÝpathÝpathselÝ
Ý

The File Transfer Dialogue
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Here you make all the necessary settings for the transfer
of binary files. You may either use CoNnect's internal Z-
Modem or external programs like the famous GSZRZACC.

The internal Z-Modem  can  be  chosen  when  you  set the
transfer program popup to "XYZ-Modem (Int.)".

Click here for  the  information  about 'Internal Z-Modem
Parameters'.

If you  are  using  the  registered  version  of  Michael
Ziegler's Z-Modem, which will be faster than the internal
protocol, you may put  this  ACC  on  your boot drive and
CoNnect will start communicating with it. Please read the
Z-Modem instructions carefully and do not forget to put a
"$"  as  the  last  sending  parameter  in  all  external
protocols. Choose "GEMRZSZ.ACC"  in  the transfer program
popup and press the "Search Accessory" button.

To use an external  XYZ-Modem  transfer  program, you may
choose XYZ-Modem (Ext.) from  the  transfer program popup
and select the program paths of this protocol.

Standard parameters for several external programs are:

  GEMSZRZ.GTP:

    Receive: -rz
    Send   : -sz $

  XYZ.TTP

    Receive:
    Send   : -u $

  SRZ:

    Receive:
    Send   : -a $

The "$" sign is  expanded  to  a  file selector box which
opens when the transfer is  started. The file (or several
files if Selectric is  installed)  which  you then select
will replace the "$" in the command line.

If  you  activate  the   Z-Modem  "auto  start",  Z-Modem
reception will start automatically.

With SLOT you may define  up  to eight different protocol
settings which may be selected  when needed for a special
kind of operation.

ÝÝBin„rdateienÝ
Ý

Binary Files
ÿÿÿÿÿÿÿÿÿÿÿÿ
For the transfer of  binary  files, transfer protocols are
used to allow error free and/or fast transfers. Z-Modem is
error free and fast. Kermit is error free, but not as fast
as Z-Modem. X-Modem is very  slow,  but nearly error free.
Without error checking, Y-Modem is very fast.

Normally Z-Modem is the best  choice if it is available.

ÝÝZieglerÝ
Ý

You can  get  a  highly  recommended  Z-Modem
program for DM 30, from:

XENIA Software         XENIA Software
Michael Ziegler        Michael Ziegler
Jagdfeldring 16        Kreissparkasse Muenchen
D-8013 Haar            BLZ 702 501 50
                       Kto: 420354680

You may contact the author on the Maus-Net:

   Michael_Ziegler@M

You may contact the author on the Internet:

   Michael_Ziegler@m.maus.de

ÝÝ_TabulatorÝ
Ý

Tabulator
ÿÿÿÿÿÿÿÿÿ
You may specify your own tabulator setup here.
However, it is a   good  idea  to  set the tab
distance to eight.

The other possible settings are:

  Left and right border in the ANSI Emulation.

  A VT100 margin bell.

  The scroll region -  only  touch this if you
  understand  VT100  and  know  what  you  are
  doing.

ÝÝ_StatuszeileÝ
Ý

The Status Line
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Below the  terminal  menu  you  may  install the
VT100 status line. You can do this by activating
the check box on top of this dialogue.

The information you  will  see  in  this line is
determined  by  the   other   settings  in  this
dialogue.

ÝÝ_SizeÝ
Ýhold screenÝholdscreen-aktivÝ
Ý

Terminal Size
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
You may set the  terminal  size  here (but remember most
hosts want you to use an 80x24 display).

The buffer lines are lines for your history scroll-back-
buffer. If  you  want  to  scroll  back,  it  is  highly
recommended that you  activate  hold screen before doing
so, because  otherwise CoNnect will always scroll to the
bottom of the window when it receives new characters.

When you are using  the  fast  scroll option, you should
install at  least  fifty  buffer  lines  and  enable (at
least) the vertical scroll bar.

Cursor coupling will keep track of  the cursor; if it is
outside the visible part of your window, the window will
be scrolled to make the  cursor visible again. For speed
reasons this coupling is only done vertically.

ÝÝholdscreen-aktivÝ
Ý

Hold Screen
ÿÿÿÿÿÿÿÿÿÿÿ
Normally, the F1 function  key  is set to "holdscreen".
Thus, if you press F1, hold screen gets activated until
F1 is pressed again. When the screen is being held, the
right-hand LED in the terminal  window will be on. This
will allow you to  scroll  back  in your history buffer
without being  disturbed  by  CoNnect  jumping  to  the
bottom when receiving new characters.

To make F1 the "holdscreen" key, you must:

  Open the function key dialogue. Set the text of F1 to
  "holdscreen" (without the quotes) and enable the left
  check box behind this entry.

F1 will then toggle the hold screen status.

ÝÝ_RegistrierungÝ
ÝdistributorsÝWo RegistrierenÝ
ÝmanualÝHandbuchÝ
ÝprogrammerÝProgrammiererÝ
Ý

The Registration Dialogue
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
This dialogue should be used to enter your user data.
Name, address, favourite football player.  :-)

You must, at least,  enter  your  name  here to allow
CoNnect to create a unique  user ID for you. Entering
your  address  will  enable   CoNnect   to  create  a
registration letter, which  is  highly recommended as
it  will  eliminate  lots  of  possible  registration
problems.

If the programmer (me) has received your registration
fee AND the registration, you wil  get the key for an
unlimited version and a printed manual.

The registration  key  has  to  be  entered  in  this
dialogue in one of the six possible slots.

Six - because you will  need  a  special key for each
version of TOS you are  using,  since  the user ID is
dependent on this.

For some countries,  local  distributors  will handle
your registration.

ÝÝProgrammiererÝ
ÝdistributorsÝWo RegistrierenÝ
Ý

You can contact the programmer of CoNnect at:

Mail
----

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

Electronic Mail
---------------

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

Bank
----

    Wolfgang Wander
    Konto-Nummer: 1373482932
    Hamburger Sparkasse
    Bankleitzahl: 20050550

If you are not  living in Germany you
might  find  it  more  convenient  to
contact the local distributors.

ÝÝ_PortÝ
ÝbaudÝBaudrateÝ
Ýdata bitsÝDatenbitÝ
ÝhandshakeÝHandshakeÝ
ÝIO-bufferÝSchnittstellenpufferÝ
ÝparityÝParit„tÝ
ÝportÝPortÝ
Ýstop bitsÝDatenbitÝ
Ý

Port
ÿÿÿÿ
This is  where  you  can specify the  port parameters.

Port parameters consist of port,  baud rate, handshake
mode, data bits, stop bits, parity and IO-Buffer size.

ÝÝHandshakeÝ
ÝIO-BufferÝSchnittstellenpufferÝ
Ý

Handshake
ÿÿÿÿÿÿÿÿÿ
Possible settings for the handshake mode are:

 - No Handshake
 - RTS/CTS
 - XON/XOFF

Handshaking is used between  two  computers (or a
computer and  a  modem)  to  signal  each  other,
whether or not, they  are  able  to receive data.
Without handshaking, lots of  data  would be lost
if the receiving computer is slower in taking the
data than the computer sending out the data.

Without handshaking (because  your  modem or host
does not support it) you  should try to install a
large IO-Buffer.

The different forms of handshaking are:

 ù Software Handshake:  XON/XOFF

   As soon as one  of  the  partners  is ready to
   receive data, it sends  an  XON  (^Q). When it
   wants to stop  transmission  it  will  send an
   XOFF (^S).

 ù Hardware Handshake:  RTS/CTS

   This is quite similar  to software handshaking
   In contrast,  no  characters  are  sent;  only
   voltages on hard wired lines are set. Hardware
   handshake will  give  you  better transmission
   speed.

It is important,  that  both  sides  use the same
form of  handshaking  Otherwise,  the  connection
would be equivalent to  no  handshaking at all or
and in  the  worst  case,  transmission  would be
blocked.

ÝÝSchnittstellenpufferÝ
ÝhandshakeÝHandshakeÝ
Ý

IO-Buffer
ÿÿÿÿÿÿÿÿÿ
The size of  the IO-Buffer can
be set to  values  between 256
bytes and 32767 bytes.

If your  host  or  your  modem
supports handshaking,  a value
of  4096  or   8192   will  be
reasonable (for  fast  Z-Modem
transfers).

Otherwise  the  largest  value
might  still   not   be  large
enough. Set it to 32767 bytes.

ÝÝEchoÝ
Ý

Echo
ÿÿÿÿ
Possible settings for echo are echo on, echo off, and local.

Echo On:   Every character  typed  by  you  on the keyboard will
           be send to the  host  and  will  also be displayed in
           the terminal  window.   If  your  host  will  have  a
           built-in echo,  your  display  will  look  like "oohh
           wwhhaatt nniiccee ddoouubbllee cchhaarraacctteerrss".
           In that case, a better choice would be echo off.

Echo Off:  Working in mailboxes  or  on  Unix computers, this is
           the right choice. Typed  characters  are  sent to the
           host only and the host  is  expected to echo them (if
           you should see them).

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

ÝÝParit„tÝ
Ý

Parity
ÿÿÿÿÿÿ
Possible settings for  parity are
none, even, and odd.

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

If the sent character has an even
number of  set  bits,  the parity
bit will be set/unset if even/odd
parity is enabled and vice versa.

ÝÝDatenbitÝ
ÝparityÝParit„tÝ
Ý

Data Bits
ÿÿÿÿÿÿÿÿÿ
Possible settings  for  data bits
are five, six, seven, or eight.

Each character  sent  consists of
one start  bit,  a  configureable
number of data  bits, an optional
parity bit  and  a  configureable
number of stop bits.

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

ÝÝBaudrateÝ
ÝportÝPortÝ
Ý

Baud Rate
ÿÿÿÿÿÿÿÿÿ
The baud  rate  is  the  number  of  bits  which  can be
transmitted per second on the serial line of your Atari.

  On a simple ST you can specify the following rates:

       19200, 9600, 4800, 3600, 2400, 2000, 1800,
       1200, 600, 300, 200, 150, 134, 110, 75, 50

You may speed up you  ST  by a hardware enhancement (RS-
Speed by Stephan Skrodzki or RSVE by Harun Scheutzow) to
get 38400, 57600  and  115200  BPS.  Those enhancers can
install  a  cookie  so  that   CoNnect  knows  of  their
existence and displays the correct rates.

On a TT, a MegaSTE  and  on  the Falcon030 you have some
additional and higher baud rates.

Show information about the port?

ÝÝPortÝ
Ýbaud ratesÝBaudrateÝ
Ý

Atari Ports
ÿÿÿÿÿÿÿÿÿÿÿ
On all Atari computers, you  can  use  the MIDI Port in
addition  to  the  normal  serial  ports.  Transmission
parameters on MIDI are fixed  to  8N1  (8 data bits, no
parity, 1 stop bit), no handshake, and 31250 baud.

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

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

The MegaSTE has three serial ports:

MODEM1  - This is identical to the ST-Port.
MODEM2  - This is identical to the Falcon port.
SERIAL2 - This has the following additional baud rates:

             125000, 115200, 83333, 62500,
             57600, 38400, 31250, and 14400.

The MegaSTE's ports  have  some  hardware defects. Only
MODEM2 and MODEM1 can give satisfying results.

The TT has four serial ports:

MODEM1  - This is identical to the ST-Port
MODEM2  - This is similar  to  the Falcon port (but not
          able to do 57600 and 115200 baud).
SERIAL1 - This is similar to  the ST-Port (but has less
          lines and is therefore almost unusable).
SERIAL2 - This is identical  to SERIAL2 on the MegaSTE,
          but bug free. It has no Ring indicator.

The higher baud rates will only  be of interest for you
if you are using a  high speed. The Telebit WorldBlazer
is able to receive and send  at 115200 baud but this is
quite hypothetical.

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

The Scan Table
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
This is a file  with  certain  commands for connect that
tell it how to handle any key pressed.

It can either be loaded in the dialogue character set or
by the CoSHy command "scantable".

For example,  you  can   use   the   table  to  map some
country specific keys. The  German  umlaute serves as an
excellent example:

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

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

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

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

NOTE:  The <Space>  character   may  not  be included in
quotes (''). It must be specified as 32.

Negative  numbers  in  the   first   row  refer  to  the
(positive) Scancode  number.  You  will  find a complete
overview of the  scan code table in the manual. (app. C)

To get the  string  "Escape"  when  you press the Escape
key, type:

                   -1 'Escape'

To send the cursor  down  VT100  Sequence when you press
cursor up, type:

                   -72 0x1b '[B'

This is fun!  ;-)

An important application of scan  tables is the doorway-
mode, where you can force  your  Atari  to send DOS scan
codes to  allow  remote  control  of  a  PC  running the
DOORWAY program.

Following the scancode entry, you  may specify a special
SHIFT-State of your keyboard.

To react to a  SHIFT-Escape  keypress, while making sure
that CONTROL and ALTERNATE are not pressed, type:

                 -1 Sca 'escape shift'

                 s = SHIFT not pressed.
                 S = SHIFT pressed.
                 c = CONTROL not pressed.
                 C = CONTROL pressed.
                 a = ALTERNATE not pressed.
                 A = ALTERNATE pressed.

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

ÝÝ_ZeichensatzÝ
ÝmanualÝHandbuchÝ
Ýscan tableÝScantabelleÝ
Ý

Character Set
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
Character sets can be  defined  here. These may
be either the Atari  character  set  or the ISO
character set. The latter  allows you to choose
between several different  national replacement
character sets.

National special keys (the Umlaute) and the way
CoNnect sends them can be defined here as well.
This could also be done in the scan tables, but
it is easier this way.

The scan table is a  file where you can specify
which characters shall be sent if a certain key
is pressed by the user.

A better description  of  this  feature will be
found in the manual.

ÝÝ_Kompatibilit„tÝ
Ý

Compatibility
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
As some hosts  have  problems with
correct  VT100   emulation   (like
CoNnect's),  you   may   use  this
dialogue  to   reduce   the  VT100
correctness of CoNnect.

If there  are  problems  with your
host, play around  with this setup
and search for improvements.

ÝÝ_FunktionstastenÝ
Ý

Function Keys
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
In this  dialogue  you  can  set  up  to eighty
function keys (using combinations of SHIFT, ALT
and CONTROL).

Normally any text placed on a function key will
be sent to the host when the key is pressed. By
activating one of the two CoSHy buttons (to the
right of  the  function  key  string),  you may
install CoSHy commands  which  will be executed
when the function key  is  pressed. If the left
button is on, the  command  will be executed in
the terminal window, if the right button is on,
the command will be executed without windows.

ÝÝ_DarstellungÝ
Ý

Display
ÿÿÿÿÿÿÿ
In the "font" box you  can specify the fonts used
for wide and small terminals.

CoNnect uses GDOS  fonts,  but  even without GDOS
you may use these  fonts  by  putting them into a
directory named GEMSYS in your CoNnect directory.
CoNnect will load these fonts at start-up time if
no GDOS is installed.

You may also set  the  cursor  type,  the kind of
scrolling;  smooth  scrolling  is  nice  to  read
scrolling text, but is very  boring after a while
since it is so slow! Fast scrolling is very fast,
but makes it hard to read incoming data.

ÝÝ_ProtokollÝ
Ý

Capture
ÿÿÿÿÿÿÿ
Here you may specify the file for capturing your on-line session.
       The filename may contain the following characters:

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

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

ÝÝ_EmulationÝ
Ý

Emulation
ÿÿÿÿÿÿÿÿÿ
Here  you  may  select   the  desired  emulation.
CoNnect offers you VT52, VT100, VT102, and VT220.

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

ÝÝ_AsciiuploadÝ
ÝmanualÝ
Ý

ASCII-Upload
ÿÿÿÿÿÿÿÿÿÿÿÿ
With ASCII Upload you can send an ASCII
file without any special protocol.

This is useful to enter short pre-typed
messages into a mailbox editor.

Please do not get confused by the large
number of  options.  Normally,  they do
not need to be  changed.  You will find
further explanations in the manual.

ÝÝ_StatistikÝ
Ý

Charge Statistics
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
To keep track of your telephone charges,
CoNnect  keeps   a   logfile  containing
information about each  telephone number
dialled, the duration of the connection
and  the  money  you  spent  during  the
connection. This dialogue  offers  you a
comfortable way to create statistics out
of this logfile.

Play around with it.

ÝÝ_LernenÝ
Ý

Learn a Script
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
CoNnect is able to keep track of the
user activity in a host and create a
CoSHy script which  will  repeat all
the actions the user performed.

This is especially  useful  when you
want  to   create   automatic  login
scripts or automatic poll scripts.

Here you can  activate this learning
mode and select  the actions CoNnect
shall keep track of.

ÝÝ_TeksetupÝ
ÝmanualÝHandbuchÝ
Ý

TEK-Setup
ÿÿÿÿÿÿÿÿÿ
In the TEK-Setup  dialogue,  you can configure
your TEK 4014 emulation.  As most mailboxes do
not   offer   this   emulation,   just   leave
everything as it is.  Help concerning the TEK-
Mode can be found  in  the  manual. Also, your
system administrator (machines  that offer Tek
normally have one!) will be able to help you.

ÝÝ_SoundÝ
Ý

Sounds
ÿÿÿÿÿÿ
CoNnect has a built-in facility to co-operate
with the  shareware  product  PAULA,  which is
able to play .MOD files.  In addition to Paula
in later versions of  CoNnect  you can specify
.HSN Files for  the  Sound Player CrazySounds.
You may  also  specify  other  sound  files  -
CoNnect will try to play them itself.

Here you  can  setup  the  sound  reaction  of
CoNnect to certain system  events. Just select
the appropriate files  by  double  clicking on
the path entries for the events.

ÝÝ_HotkeysÝ
Ý

Hotkeys
ÿÿÿÿÿÿÿ
Hotkeys are normally used to allow
access  to   menu   items  without
selecting them using the mouse.

Here you can select a certain menu
item and press your desired hotkey
for this item.

CoNnect's default hotkey table can
be  activated   by   pressing  the
"Default" button.

ÝÝ_FarbenÝ
Ý

Colours
ÿÿÿÿÿÿÿ
CoNnect uses the first 16 VDI-colours
and assumes they are installed in the
default manner. If  this  is not true
you may use this dialogue to create a
CoNnect internal colour table.

ÝÝ_AnrufbeantworterÝ
ÝparametersÝ_AnrufparameterÝ
ÝmanualÝHandbuchÝ
Ý

The Answering Machine
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
This is the CoNnect automatic answering machine,
which enables you  to  use  a  Voice  Modem as a
private  answering  machine.   Using  the  CoSHy
Script language you are  able  to configure this
machine to a  more  powerful  one  than the best
commercial hard wired ones available!

By  pressing  the  parameters   button  you  can
configure the answering machine.

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

ÝÝ_AnrufparameterÝ
ÝmanualÝHandbuchÝ
Ý

Answering Machine Parameters
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Here you can configure the name of the
greeting message a  caller gets. Also,
the  path  for   new   messages  which
callers leave should be set here.

CoSHy commands that are activated when
certain types of calls  come in can be
installed here.

Detailed information can  be  found in
the manual.

ÝÝFensterÝ
Ýhelp windowsÝOnlinehilfeÝ
ÝmiscÝ_AllgemeinesÝ
ÝTektronix windowsÝTektronixfensterÝ
Ýterminal windowsÝTerminalfensterÝ
Ýwindow dialoguesÝFensterdialogeÝ
Ýwindow menusÝFenstermenÝ
Ý

Windows
ÿÿÿÿÿÿÿ
CoNnect currently offers four different kinds
of windows to the user. These are:

             ù terminal windows
             ù Tektronix windows
             ù help windows
             ù window dialogues

The first two types have  another menu bar in
their top  region.  These  are  window menus,
which allow user actions that affect only the
window the option was selected from.

The  user  interface  for  window menus   and
window dialogues  can  be  configured  in the
"Misc." dialogue.

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

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

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

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

Help can be obtained  in  any window dialogue
by simply pressing the HELP key. A new window
will open to provide the needed information.

Using the sending  mechanism  of  CoNnect you
may  paste  selected   text   parts  (or  the
contents of the  GEM-clipboard  - see "misc")
of the terminal window to  edit fields of the
dialogue.  This  is  useful  if  you  want to
enter new  telephone  numbers  to  the  phone
editor.

ASCII characters that cannot be accessed from
the keyboard may be entered using the ALT key
and the numeric keypad. Press the 2 4 9 while
pushing the ALT key down will give you a 'ù'.

ÝÝEmulation-EinfÝ
ÝemulationÝ_EmulationÝ
Ý

Emulation Introduction
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
CoNnect emulates all incoming characters. It
scans the incoming  data  stream for special
characters which will  not  be printable but
give information about  the  display  of the
following printable  characters.   The  data
stream involves information  on the position
of characters, their size,  what colour they
are displayed in, and more.

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

ÝÝTastenVersendenÝ
ÝCoSHyÝCoSHyÝ
Ýfunction keysÝ_FunktionstastenÝ
ÝhotkeyÝ_HotkeysÝ
ÝmanualÝHandbuchÝ
Ýscan tableÝScantabelleÝ
Ýtype ahead bufferÝ_VorschreibzeileÝ
Ý

Sending Keys
ÿÿÿÿÿÿÿÿÿÿÿÿ
To send  characters  to  the host,
CoNnect  offers  many  (too  many)
possibilities.

ù Normal Keys

  Letters,  numbers,  spaces,  and
  special characters will  be sent
  without translation to  the host
  (if no scan table is installed).

ù CONTROL + Keys:

  If there is  no  hotkey for this
  combination, then  the following
  combinations are sent:

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

ù ALTERNATE + Keys:

  If there is  no  hotkey for this
  combination, then  the following
  combinations are sent:

  CoNnect    will     send     the
  corresponding character with the
  highest bit set.

      ALT+A sends 193 ($C1)

  The numeric  keypad  has another
  meaning  in   conjunction   with
  ALTERNATE:

  The pressed numbers are combined
  to at   most 3  digits and their
  decimal ASCII  value is sent.

  ALT+131 Sends:  ƒ

ù Function Keys:

  If you have  entered  a text for
  this key  in  the  function keys
  dialogue   and   none   of   the
  corresponding CoSHy  buttons  is
  set, the corresponding text will
  be sent.

ù Backspace, Delete,  UNDO, Cursor
  Keys, Insert, Home:

  The corresponding  VT52,  VT100,
  VT220 meaning will  be sent (see
  manual).

ù Pressing CONTROL+INSERT:

  The    type ahead buffer    will
  appear to let  you  enter a line
  which will be sent to the host.

With several  CoSHy  functions you
may also send  text and characters
to the modem.

ÝÝOnlinemausÝ
Ý

Working on-line in  a  full  screen editor
like emacs, edt or some other product, you
can use the mouse to place the cursor. Try
double clicking  to  the  desired position
while pressing  down  the  CONTROL  key  -
CoNnect will TRY  to  place  the cursor on
the right position...

ÝÝTerminalfensterÝ
ÝemulationÝEmulation-EinfÝ
ÝholdscreenÝholdscreen-aktivÝ
ÝKeys pressedÝTastenVersendenÝ
Ýmain menuÝHauptmenÝ
ÝselectÝMarkierenÝ
Ýterminal menuÝMenue-TermÝ
Ýuse the mouseÝOnlinemausÝ
Ý

Terminal Window
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
The  terminal   window   is   the  user
interface for  communications  with the
host. Keys pressed will  be sent to the
host and received  characters  from the
host will be displayed according to the
emulation used.

If you  have  enabled  scroll bars, and
the history  buffer,  you  may  use the
scroll bars to  re-read  text  that has
scrolled out  of  the  current terminal
window.

SEE ALSO:  holdscreen

With  the   terminal   menu,   you  can
configure   all    terminal    specific
parameters  of  the   window  that  the
terminal menu is in.

The main menu is  used to configure the
global settings of CoNnect.

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

You  may  try to  use the mouse in some
on-line editors.

ÝÝMenue-TekÝ
ÝmanualÝHandbuchÝ
Ý

Tektronix Window Menu
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
The  Tektronix  window  menu   is  used  for
manipulating the displayed graphics. You may
save these graphics, print  them,  or choose
another zoom factor. See the manual for more
details.

If you are interested in the Tektronix mode,
please be aware of the  fact that nearly all
software able to  create  Tektronix graphics
is installed on  workstations or mainframes.
If you have  access  to  Tektronix software,
please ask your   system  administrator  for
advice. She/He  will  be  able  to configure
CoNnect for your hosts specific requests.

ÝÝTektronixfensterÝ
ÝTektronix menuÝMenue-TekÝ
Ý

Tektronix Window
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Here you may open a  Tektronix 4014 window where
your host can send you  vector graphics. You may
also create drawings with the mouse if your host
has the necessary software installed.

In the  upper  region  of  the  Tektronix window
there is another menu, the Tektronix menu.

Using the mouse you may  zoom into the displayed
graphics by selecting  the  desired  part of the
window. To get back to normal resolution, select
the 'normal resolution' menu item.

ÝÝFenstermenÝ
Ýmain menuÝHauptmenÝ
ÝTektronix windowÝMenue-TekÝ
Ýterminal windowÝMenue-TermÝ
Ý

Window Menus
ÿÿÿÿÿÿÿÿÿÿÿÿ
Window menus are menus where you can
configure local parameters belonging
to a specific window.

SEE ALSO:  main menu
           terminal window
           Tektronix window

Global parameters can be  set in the
main menu.

ÝÝgl_BeendenÝ
Ý

Quit
ÿÿÿÿ
This function may cause the immediate
exit from  CoNnect.  No  warranty  is
given. Be careful.

ÝÝgl_™ffnenÝ
Ýterminal windowÝTerminalfensterÝ
Ý

Open
ÿÿÿÿ
Using this main menu item, a new window
is opened. If  CONN0.SET  is available,
the information in  this  file  is used
for the  terminals'  setup.   Otherwise
default parameters are used.

SEE ALSO:  terminal window

ÝÝgl_RotierenÝ
Ý

Rotate
ÿÿÿÿÿÿ
Using the menu item "Rotate", the
current   window    will   become
inactive and the next  one in the
window queue will be topped.

ÝÝgl_SchlieáenÝ
Ýwindow dialogueÝFensterdialogeÝ
Ý

Close
ÿÿÿÿÿ
The  current   window   will   be
closed. If the  current window is
a  window dialogue,  changes made
to its parameters will be lost.

This function  is  equivalent  to
clicking on  the  closer  of  the
current window.

ÝÝgl_Volle_Gr”áeÝ
Ý

Full Size
ÿÿÿÿÿÿÿÿÿ
The current window will be set to full
size or,  if  it  is  already  at full
size, it  will  be  reset  to  its old
size. This function  is  equivalent to
the FULLER button of the windows.

ÝÝgl_FensternamenÝ
Ý

Window Names
ÿÿÿÿÿÿÿÿÿÿÿÿ
The names of the ten last opened
windows  are   displayed   here.
Selecting an item  will  top the
corresponding window.

ÝÝgl_OptionenÝ
Ý

Load and Save Options
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
All settings of the  main  menu, as well as
the positions and setup files of the opened
terminal windows, will be saved/loaded from
the options (*.OPT) file.

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

ÝÝHauptmenÝ
ÝAbout CoNnectÝ_InfoÝ
ÝCharge StatisticsÝ_StatistikÝ
ÝCloseÝgl_SchlieáenÝ
ÝColoursÝ_FarbenÝ
ÝFull SizeÝgl_Volle_Gr”áeÝ
ÝHelpÝGeneralÝ
ÝHotkeysÝ_HotkeysÝ
ÝLoad OptionsÝgl_OptionenÝ
ÝMisc.Ý_AllgemeinesÝ
ÝOpenÝgl_™ffnenÝ
ÝQuitÝgl_BeendenÝ
ÝRegistrationÝ_RegistrierungÝ
ÝRotateÝgl_RotierenÝ
ÝSave OptionsÝgl_OptionenÝ
ÝSoundÝ_SoundÝ
ÝStart A ProgramÝProgrammstartÝ
ÝStart A ScriptÝgl_ScriptstartÝ
ÝStart A ShellÝgl_ShellstartÝ
ÝStart CoSHyÝgl_CoSHystartÝ
Ýwindow menusÝFenstermenÝ
ÝWindow NamesÝgl_FensternamenÝ
Ý

The Main Menu
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
The main menu in CoNnect is the standard
GEM menu bar. Global settings and global
information can be accessed there.

Local  parameters  of   windows  can  be
accessed  in  the  corresponding  window
menus.

In the  main  menu  you  will  find  the
following items.

 ù CoNnect
      ø About CoNnect

 ù File
      ø Start A Shell
      ø Start A Program
      ø Start CoSHy
      ø Start A Script
      --------------
      ø Quit

 ù Windows
      ø Open
      ø Close
      ø Rotate
      ø Full Size
      --------------
      ø 'Window Names'
        ...

 ù Options
      ø Registration
      ø Misc.
      ø Hotkeys
      ø Colours
      ø Charge Statistics
      ø Sound
      --------------
      ø Load Options
      ø Save Options

 ù HELP
      ø Help

ÝÝgl_CoSHystartÝ
ÝCoSHy'sÝCoSHyÝ
Ý

CoSHy Start
ÿÿÿÿÿÿÿÿÿÿÿ
CoNnect's internal Shell can only be started on the
TOS-Screen (without windows) when  running a single
tasking TOS. If you are  running Mag!X or MultiTOS,
this feature is disabled.

The user will be able  to enter commands to CoSHy's
command line and CoNnect will  try to execute them.
To exit type exit  (and  then  press return) on the
command line.

ÝÝgl_ScriptstartÝ
ÝCoSHyÝCoSHyÝ
Ý

Start a Script
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
CoNnect's internal Shell can only be started on
the TOS-Screen (without windows) when running a
single tasking TOS. If you are running Mag!X or
MultiTOS this item will be disabled.

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

ÝÝProgrammstartÝ
Ý

To start an external program this menu item
will open a file selector where the user is
able to select the program to be started.

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

ÝÝgl_ShellstartÝ
ÝmanualÝHandbuchÝ
Ý

TOS-Shell
ÿÿÿÿÿÿÿÿÿ
Starting a TOS-Shell out of the main menu.

CoNnect tries to  start  a  program  that has
been installed as a  shell.  (Either by using
the  _shell_p  pointer   or  the  environment
variable $SHELL).

If no shell is installed nothing will happen.

Normally the shell will  be  started with all
CoNnect windows closed on the TOS-Screen.

Under MultiTOS  CoNnect  will  ask  TOSRUN to
start the shell.

(If this help was no  help  to you due to the
hundreds of  misspelled  computer  words, you
will probably find  the  manual more helpful,
since it has less spelling mistakes.)

ÝÝHandbuchÝ
Ý

Manual
ÿÿÿÿÿÿ
Every registered CoNnect  user  will receive a
printed manual  automatically.  Normally  this
won't take more  than  four  days (in Germany)
after the money has  arrived.  Due to problems
with the printing and  new versions of CoNnect
this may take  longer  than  even eight weeks.
Please be patient.  We  won't forget you. Mail
us to make sure that we have not forgotten you
after about four weeks.

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

Mail:
-----

Philipp Oelwein
Ringelsgasse 22a
69226 Nuáloch

Electronic Mail:
----------------

Philipp Oelwein @ HD (MausNet)
op@uphys1.uphysn.uni-heidelberg.de (Internet)

The current price is  DM  25, plus postage and
packing.

ÝÝOnlinehilfeÝ
ÝexampleÝOnline-FettÝ
ÝwindowÝFensterÝ
ÝselectingÝMarkierenÝ
Ý

On-line Help
ÿÿÿÿÿÿÿÿÿÿÿÿ
In this window you can find  help  for  the handling of help windows. The
on-line help can be activated by simply pressing the HELP button whenever
(nearly always) you think a little  help  could be useful. CoNnect's help
is context sensitive. It will always  provide the information you need at
the moment (when working in a certain dialogue, in the terminal window or
on the command line of CoSHy). There is a difference between pressing the
HELP key and activating help in the main menu. The former one is the
context sensitive help whereas the latter  will  always give you the help
home page.

In the help  text  you  get  in  the  help  windows,  there  may  be some
underlined phrases or words written in  bold. These are phrases where you
can follow the 'links' by double-clicking on them. Try this now with this
example.

Another useful feature is  selecting  of  help  texts. Get information on
this item by double-clicking the highlighted word above.

You may either use the mouse to  follow  the  links in the help window or
use the keyboard to get around.

The following keys have a special meaning in CoNnect's help window:

   TAB:                    - Moves the cursor to the next help item.

   SHIFT + TAB:            - Moves the cursor to the previous help item.


   RETURN / HELP:          - Will  open  a  help  item if  the  cursor is
                             currently positioned on one.

   UNDO:                   - Will go back to the previous help window, or
                             - if there was none - close the current help
                             window.

   CURSOR KEYS:            - Will move the cursor in the standard manner.

   SHIFT + CURSOR LEFT:
   SHIFT + CURSOR RIGHT:   - Will move  to the  beginning  or  end of the
                             current line.

   CONTROL + CURSOR LEFT:
   CONTROL + CURSOR RIGHT: - Will move  to the  previous or  next word of
                             the help text.

   SHIFT + CURSOR UP:
   SHIFT + CURSOR DOWN:    - Will move the cursor one page up or down.

   HOME:                   - Will move the cursor to the first line.

   SHIFT + HOME:           - Will move the cursor to the last line.

ÝÝMarkierenÝ
ÝsendÝPasteÝ
ÝmiscÝ_AllgemeinesÝ
ÝquoteÝquotenÝ
Ý;-)ÝSmileyÝ
Ý

Mark
ÿÿÿÿ
In a text window  of  CoNnect, (terminal window/help
window), you can  select  parts  of  the  text using
mouse. You may also want  to  send the selections to
the host, quote it, or ask the printer to print it.

All this is possible in  CoNnect, but you might need
to teach your fingers how to do it.

 ù Selecting Character By Character:

    Move the mouse pointer to the beginning of the
    text part you want to select.  Then press down
    the left button and do not lift it again.  Now
    move the mouse pointer, while keeping the left
    button pressed to the end of the text you want
    to select.  To finish  selection,  you may now
    lift the mouse button again.

 ù Selecting Word By Word

    Move the mouse  pointer to the  word where you
    want to start selecting. Now do a double click
    - or a single click while pressing the CONTROL
    key -  and keep the mouse button pressed.  Now
    moving the  mouse  pointer  while  keeping the
    mouse button  pressed will select text word by
    word.

 ù Selecting Line By Line

    This is similar to the word-by-word selection.
    Just do a triple click (very fast) or keep the
    ALTERNATE key  pressed  while  performing  the
    first click and continue as described above.

To extend a marked  portion  of  text, you may press
the SHIFT key while clicking in the terminal window.
The marked part of the  text  will be extended up to
the clicked-on position.

Now having selected a portion  of text, you may send
this text in  a  certain  window   (either  a window
dialogue or a terminal window) by 'just' clicking in
this window with the left button, while pressing the
right button down.

If you are  using  the  GEM-Clipboard  for selecting
(see the  misc  dialogue)  you  may  also  use  your
selections in other  applications  or  may  send the
clipboards contents filled by  other applications to
the host.

Extended  functions,  like  sending,  quoting,  file
saving, printing, and  others  are  available if you
(ATTENTION) press the right mouse button down before
lifting the left button  to  end the selection. Then
lift the left  button  and  afterwards  the right. A
little exercise for your fingers!  ;-)

ÝÝPasteÝ
Ý

Sending Selected Text
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Having selected a portion of text, you may
send this text in a certain window (either
a window dialogue or a terminal window) by
'just' clicking in  this  window  with the
left  button,  while  pressing  the  right
button down.

ÝÝquotenÝ
ÝselectedÝMarkierenÝ
Ý

Quoting
ÿÿÿÿÿÿÿ
Quoting means sending a selected text to the
host with the slight  change, that every new
line starts with a ">" character.

Quoting is normally used when answering mail
messages.

For example:

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

   Sure. But when  you  receive this letter,
   this information will be invalid.

ÝÝMikeÝ
Ý

If you are in  North  America,  it might be more
convenient if you send shareware payments to:

     Michael Baffoni
     2493 Beechwood Dr.
     Paso Robles, CA
     93446

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

Email:
mbaffoni@farad.calpoly.edu

ÝÝSolutionsÝ
Ý

If you live in Great Britain you should contact:

    System Solutions
    Windsor Business Centre
    Vansittart Estate
    Windsor Berks SL4 1SE
    Tel. 0753 832212
    Fax. 0753 830344

for your registration.

ÝÝWo RegistrierenÝ
ÝMichael BaffoniÝMikeÝ
ÝSystem SolutionsÝSolutionsÝ
ÝauthorÝProgrammiererÝ
Ý

The number of local  CoNnect distributors all
over the  world  is  increasing  rapidly.  As
there have been none last year, now there are
two (an increase of more than 1000%!)  ;-).

For North America, contact:  Michael Baffoni

For Great Britain, contact   System Solutions

Otherwise, you should  contact  the author of
CoNnect.

A distributor for  New  Zealand and Australia
is on his way there.  :-)

ÝÝ_InfoÝ
ÝcountryÝWo RegistrierenÝ
ÝGreat BritainÝSolutionsÝ
ÝregistrationsÝ_RegistrierungÝ
ÝsharewareÝSharewareÝ
ÝUSÝMikeÝ
Ý

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

If you want to  register  CoNnect, you should open
the registrations dialogue.

To get information about  where to register, check
for your  country  here.  Local  distributors  are
available in the US and Great Britain.

ÝÝL„chelnÝ
Ý;-)ÝSmileyÝ
Ý

CoNnect does not smile at the moment. You
will see this by looking at byte 0x11341
relative to the basepage.  This byte should
contain 0x00 when connect is smiling!  ;-)

ÝÝWitzÝ
ÝauthorÝProgrammiererÝ
Ýnasty joke on menÝm„nnerfeindlichÝ
Ý:-)ÝSmileyÝ
Ý

Adam in paradise. He walks around and seems to be a little
unhappy. The lord recognizes this and asks him:

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

Adam, quite annoyed, answers:

   You! You can talk nonsense  like  this. You do not have
   to bother about the daily boring work like cleaning the
   clothes,  cooking,  dishes,   cleaning   the  paradise,
   brushing your teeth, feeding the cat and the crocodile.
   All this is done by your  angels.  But me? I'm not that
   happy with this status...

The lord, always having been a kind of bargainer:

   Let's see. I  think  I  could  help  you  and  give you
   someone to help you with  all  these  jobs and who will
   give you love and warmth.  But  this will certainly not
   be for free.

Adam,  who  is  suddenly   very   interested   in  a  good
relationship to his lord:

   How much!?

The Lord:

   Not that much. Two legs and two arms only.

Adam, shocked:

   No, no, no! That's too much. But - what could I get for
///one rib, only?

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

ÝÝNeinÝ
Ý

I
think
I
said
so
some
time
ago.
-
Nothing
will
follow
this
text.

ÝÝRacheÝ
ÝendÝNeinÝ
Ý

No text will be found here.
Even if you think there should
be a text on this topic.

:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:

OK - stop scrolling down.
This really is the end!

ÝÝm„nnerfeindlichÝ
Ý...ÝRacheÝ
Ý

Man are like onions,

you remove skin by skin,

and when you come to the point,

you can't help crying.

-----------------------------
You think this joke is funny?
Yes? Tell me a better one
... ;-)

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

Remember.

This text is intended to remind the user about something.

I just do not know.  Let me think.

Just a second...

Right! Always remember that  telecommunications  is a non-
humorous thing. No one would  ever  think of making jokes.
Some telecommunications  programs  even  react  in  a very
harmful manner to jokes made about or with them.

Once a user of  a  concurrent  program  tried  to fool his
system by telling a  joke  in  French.  He didn't know the
system was able to  understand  French. They still haven't
found him - well, all of him that is.

CoNnect nevertheless will try to react with a gentle smile
on jokes made by you, if  and  only if it doesn't know the
joke so far and if its  humour index is above 0.0001%. But
be aware of the fact, that  computers have another kind of
humour than humans have.

ÝÝSharewareÝ
ÝauthorÝProgrammiererÝ
ÝmanualÝHandbuchÝ
ÝpoliceÝPolizeiÝ
Ýto rememberÝErinnerungshilfeÝ
ÝuserÝAnwenderÝ
Ýwhere to registerÝWo RegistrierenÝ
Ý

Shareware
ÿÿÿÿÿÿÿÿÿ
CoNnect is shareware, which means you may test and
distribute the program but  have to register after
a certain amount of testing  time. CoNnect and the
author agree on the  fact  that  30 hours of using
CoNnect is enough to  make  the  user dependent on
CoNnect and so you  should think about registering
quickly. After the  30  hours,  work  with CoNnect
will not be that  easy  any  more  if  you did not
register.

For the user's benefit,  CoNnect  disables some of
its  functions.  Otherwise,  there  might  be  the
danger that the user will  work for two years with
an illegal copy of  CoNnect  and  will then notice
it. He then would go the  police and would want to
go to jail - this  is avoidable. CoNnect helps you
to remember the shareware status, which most users
think to  be  one  of  the  best  features  of the
program.  ;-)

The registration fee is  DM  60 for non-commercial
use and DM 150 for  commercial use.  On multi-user
systems (like Universities)  a  multi-user license
for DM 399,- is due. For this fee you will receive
a printed manual and  a  registration  key to make
your CoNnect a registered and unlimited version.

How do you know if  you  need a commercial version
or not?  That's  quite  easy.  If  you  are  using
CoNnect with the aim  to  make  any kind of profit
for yourself or  your  company,  you  will  need a
commercial registration (the  profit  made  by the
telephone company from CoNnect's  use is of course
excluded). The author  of  CoNnect  himself  has a
commercial registration, too.

If you are  using  a  non-commercial registration,
you should check if the  above  lines now apply to
you. In  this  case  you  have  to  upgrade  to  a
commercial version.

If you live in North America, or in Great Britain,
you will find  information  on  where  to register
here.

ÝÝAnwenderÝ
Ý;-)ÝSmileyÝ
Ý

The user is the one sitting  in front of this help
text at the moment. This will be in most instances
you. Some users do  not  even  know they are users
and this text  is  intended  to  help  them to get
several problems solved with  their lives and with
their user-status. Only those users who really are
aware of their user status will be able to pay for
CoNnect - so remember - YOU ARE A USER!  ;-)

ÝÝSmileyÝ
Ý

Wow. You just found a smiley in the help
text.  Congratulations,  this   was  the
first time a user has found this item.

To look at  smileys  (and  frownies) you
have to turn your head 90 degrees left:

  :-)  a smiling smiley
  :-(  a frowning frowny
  :'-( a frowny with tears in his eyes
  ;-)  a sarcastic smiley
     ...

ÝÝPolizeiÝ
Ýgreen dotÝ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  policemen  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.  ;-)

ÝÝ_AllgemeinesÝ
ÝCoSHyÝCoSHy-AllgÝ
Ýterminal windowsÝTerm-AllgÝ
Ýwindow dialoguesÝFens-AllgÝ
ÝGEM-clipboardÝKlemm-AllgÝ
Ý

The Miscellaneous Dialogue
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
In this dialogue  you  can  set  global parameters
concerning the terminal windows, window dialogues,
the GEM-clipboard, and CoSHy.

ÝÝCoSHy-AllgÝ
ÝselectedÝpathselÝ
ÝmanualÝHandbuchÝ
Ý

Misc.
ÿÿÿÿÿ
Parameters concerning CoSHy in the "Misc."
dialogue.

  ù The CoSHy start-up file (normally
    COSHY.RC) can be selected here

  ù The start-up directory can also be
    selected.  See the manual for further
    information.

ÝÝTerm-AllgÝ
Ý

Terminal Windows
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Parameters concerning the terminal windows in the
"Misc." dialogue.

Here you can determine if text windows are always
placed on  a  horizontal  position  that  can  be
divided by eight. This will  speed up the display
if you do not  own  NVDI.  You may also configure
the window menus  to  be  either Atari-like drop-
down menus or Mac-like pull-down menus.

ÝÝFens-AllgÝ
Ý

Windows in General
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Parameters concerning window dialogues in the
"Misc." dialogue.

You can decide if dialogues open in the centre
of the screen, at the last position or centred
according to the current mouse position.

Frames around certain elements of the dialogues
have titles.  You may specify here how you want
them to look.

In a common GEM-Dialogue,  RETURN and ENTER are
used to leave the dialogue  as  if the user had
clicked on the default button. CoNnect may also
use this key like in  an  editor to jump to the
next dialogue text input field.

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

ÝÝKlemm-AllgÝ
ÝselectÝMarkierenÝ
ÝpasteÝPasteÝ
Ý

Clipboard Introduction
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Parameters concerning the GEM-clipboard in the "Misc." dialogue.

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

ÝÝpathselÝ
Ý

Path & File Input
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
In all dialogues where CoNnect wants to have a filename
in an editable input field, you may double-click on the
editable line to use the file selector for locating and
selecting the lines content.

ÝÝOnline-FettÝ
Ý

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

ÝÝCoSHyÝ
ÝAbout This HelpÝCOSHYHLP\ABOUTMEÝ
ÝActions On A Command LineÝCOSHYHLP\INPWORKÝ
ÝCommand DelimitersÝCOSHYHLP\KMDTRÝ
ÝDebuggingÝCOSHYHLP\DEBUGÝ
ÝExplanation of CoSHy CommandsÝCOSHYHLP\COMMANDSÝ
ÝGeneral UsageÝCOSHYHLP\AÝ
ÝInput/Output RedirectionÝCOSHYHLP\IOREDIRÝ
ÝListing of CoSHy CommandsÝCOSHYHLP\LISTÝ
ÝMeta-CharactersÝCOSHYHLP\METASÝ
ÝMisc.ÝCOSHYHLP\OVERALLÝ
ÝQuotesÝCOSHYHLP\QUOTESÝ
ÝOverview Of The CommandsÝCOSHYHLP\OVERALLÝ
ÝWordsÝCOSHYHLP\WORTEÝ
Ý

CoSHy
ÿÿÿÿÿ
You  get  into  CoSHy  either  by  activating  the
interactive mode (the  "CoSHy"  menu  item)  or by
activating the script mode  where CoSHy will start
to run a script file.

This help  will  be  useful  for  you  in creating
scripts. The largest part of this help consists of
the description of a  number of available internal
commands. To get an overview  of CoSHy it would be
a good idea to read  the  manual,  but if you have
some UNIX shell programming  experience, this will
also  help.    CoSHy   is   a   UNIX   like  shell
environment.

0.0  About This Help

1.1  General Usage

  1.1.1  Meta-Characters
  1.1.2  Words
  1.1.3  Command Delimiters
  1.1.4  Input/Output Redirection
  1.1.5  Quotes
  1.1.6  Debugging

1.2  Actions On A Command Line

1.3  Overview Of The Commands

  1.3.1  Listing of CoSHy Commands

ÝÝCOSHYHLP\ABOUTMEÝ
ÝGeneral UsageÝCOSHYHLP\AÝ
Ý

0.0  About This Help
     ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
The help text  to  CoSHy  was  created  by Stephan
Skrodzki and myself,  (the  author  of CoNnect and
bad translator  of  the  help  texts).  I  wish to
express my thanks to Stephan for his work.

If you did  not  understand  his  German  (see the
German on-line help texts), you  may at least want
to thank  him  for  his  work.  His  internet mail
address is:

   stephan_skrodzki@ka.maus.de

Next Chapter:

   1.1  General Usage

ÝÝCOSHYHLP\AÝ
ÝMeta-CharactersÝCOSHYHLP\METASÝ
ÝquoteÝCOSHYHLP\QUOTESÝ
Ý

1.1  General Usage
     ÿÿÿÿÿÿÿÿÿÿÿÿÿ
After starting CoSHy in  interactive mode you will
get a command line where you can enter commands in
the command  language  of  CoSHy.  In  addition to
CoSHy internal  commands,  you  may  want  to  use
external  tools.  Starting  external  programs  is
quite easy;  just  type  their  names  (paths) and
append parameters delimited by spaces.  If you are
using the  environment  variable  PATH  CoSHy will
evaluate  its  content  to   search  for  external
programs.

If  you  want  a   UNIX-like  environment,  it  is
recommended that you  install  the  tools like ls,
echo, cat, mkdir,  cp  (and  others)  in your /bin
directory  and  set   a   PATH   pointer  to  this
directory.

ATTENTION:

   In contrast  to  TOS  pathname  delimiters (\),
   CoNnect  uses  UNIX  pathname  delimiters  (/).
   If your external  programs  need  "\"  in their
   arguments, you will have to quote the "\".

CoShy is able to perform TAB expansions!

An attempt is made to expand the first word on the
command line as a  command.  The directory pointed
to by the $PATH variable  is searched for matching
executables. For example,  type  "lha<TAB>" and if
you have an LHARC.TTP installed on your system and
$PATH points to  the  directory  where it resides,
you will get "lharc" on the command line. If there
are several possible expansions, CoSHy will expand
up to the first difference  in  the names. Say you
have printenv and printall on your system and type
in "pri<TAB>", you will  get print<BEEP>. A second
<TAB> will then show  you  all possible expansions
in the next line:

printall printenv

If you try to  expand  a  parameter  to a command,
CoSHy will do this in the same way, but not search
in $PATH and  not  for  executables  only  but all
files.

Next Chapter:

 1.1.1  Meta-Characters

ÝÝCOSHYHLP\METASÝ
ÝWordsÝCOSHYHLP\WORTEÝ
Ý

1.1.1  Meta-Characters
       ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Meta-characters are characters that separate words
on  a  command  line  when  non-quoted.  They  are
<space>, <tab>, <newline>, &, |, ;, < and >.

Next Chapter:

 1.1.2  Words

ÝÝCOSHYHLP\WORTEÝ
ÝCommand DelimitersÝCOSHYHLP\KMDTRÝ
Ý

1.1.2  Words
       ÿÿÿÿÿ
A word is a string  between two non-quoted spaces.
Meta-characters may also be contents of a word but
only if quoted.

The examples below all have one word per line:

 hello

 hello\ Pete

 hello\       two lines, but one word!
 you

 'Hello You'

 Hello' 'You

 hello" You"

 "Hello\"\ \"You"

Next Chapter:

 1.1.3  Command Delimiters

ÝÝCOSHYHLP\KMDTRÝ
ÝInput/Output RedirectionÝCOSHYHLP\IOREDIRÝ
Ý

1.1.3  Command Delimiters
       ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
The following characters  do  separate commands if
they are not quoted.

Character:  Meaning:

 ;          Normal

 <newline>  Normal

 &          Like ";" (No background tasks, sorry!)

 |          Pipe.  Example:

            cmd1 | cmd2.

            The output  of  cmd1  will  become the
            input of cmd2. Return value is the one
            of cmd2.

 &&         AND.  Example:

            cmd1 && cmd2

            The command cmd2  is  executed if, and
            only if, cmd1  has  a  return value of
            true (0).  Returns  false  (1)  or the
            return code of cmd2.

 ||         OR.  Example:

              cmd1   || cmd2.

            The command cmd2  is  executed  if and
            only if cmd1 has  a  return a value of
            false (1). Returns true  or the return
            code of cmd2.

Next Chapter:

 1.1.4  Input/Output Redirection

ÝÝCOSHYHLP\IOREDIRÝ
ÝQuotesÝCOSHYHLP\QUOTESÝ
Ý

1.1.4  Input/Output Redirection
       ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 cmd   < file  The command  cmd will get its input
               from the file  'file'  and not from
               the keyboard.

 cmd   > file  The command cmd  writes  its output
               to file. The previous contents of a
               possibly existing file will be lost.

 cmd   >> file The command cmd appends it's output
               to file.

Next Chapter:

 1.1.5.  Quotes

ÝÝCOSHYHLP\QUOTESÝ
ÝDebuggingÝCOSHYHLP\DEBUGÝ
Ý

1.1.5  Quotes
       ÿÿÿÿÿÿ
To remove the special meaning of characters, you
may quote them:

\ (Backslash):  "\" is  the  escape character of
the shell and removes a special meaning from any
directly following character.  To  obtain  a "\"
you will have to enter "\\".

' (Single  Quote):   All  characters,  even  all
other  quote  characters   loose  their  special
meaning  when  found   between   single  quotes.
Between '...'  no  expansion  is  performed. The
single quote cannot be found in between '...' as
it always ends a single quotation.

"  (Double-Quote):    All   characters   but   `
(backquote), ' (single  quote),  $ (dollar sign)
and \ (back slash)  loose their special meaning.
Whereas, and $ always keep their special meaning
this is true for \ only if the following char is
a $, ', " or  <newline>.  You  may  enter a " in
between "..." by placing  a  \  in  front of it:
"here it is \"."

Next Chapter:

 1.1.6 Debugging

ÝÝCOSHYHLP\DEBUGÝ
ÝActions On A Command LineÝCOSHYHLP\INPWORKÝ
Ý

1.1.6  Debugging
       ÿÿÿÿÿÿÿÿÿ
To activate CoSHy's  debug mode, use
the command:

   set -x

All commands  passed  to  CoSHy will
then  be  displayed   in  completely
expanded form before execution.

To switch debugging off, just enter:

   unset -x

Example:

   c:\> set -x
   c:\> echo *.acc
   + echo gszrz.acc xcontrol.acc
   gszrz.acc xcontrol.acc
   c:\> unset -x
   + unset -x
   c:\>

Next Chapter:

 1.2 Actions On A Command Line

ÝÝCOSHYHLP\SPECPARÝ
Ý
Special Parameter Substitution
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 ${parameter}
     The value of parameter is substituted.  
     The braces are required when parameter 
     is  a  positional  parameter with more 
     than one  digit,  or when parameter is 
     followed  by  a character which is not 
     to be interpreted as part of its name.

In  each of the cases below, word is subject 
to   parameter  expansion, command substitu-
tion, and arithmetic expansion. 
CoSHy  tests  for a  parameter that is unset 
or  null;  omitting  the  colon results in a 
test only for a parameter that is unset.

 ${parameter:-word}
     Use Default Values.  If  parameter  is 
     unset  or  null, the expansion of word 
     is substituted.  Otherwise,  the value 
     of parameter is substituted.
 ${parameter:=word}
     Assign Default Values. If parameter is 
     unset  or  null, the expansion of word 
     is assigned to parameter. The value of 
     parameter is then substituted.  
 ${parameter:?word}
     Display  Error  if Null  or  Unset. If 
     parameter is null or unset, the expan-
     sion of word (or a message to that ef-
     fect if word is not present) is  writ-
     ten  to  the  standard  error  and the 
     shell,  if  it  is   not  interactive, 
     exits.  Otherwise,  the value of para-
     meter is substituted.
 ${parameter:+word}
     Use  Alternate  Value. If parameter is 
     null or unset, nothing is substituted, 
     otherwise  the  expansion  of  word is 
     substituted.
 ${#parameter}
     The  length in characters of the value 
     of parameter  is substituted. 
 ${parameter#word}
 ${parameter##word}
     The word is expanded to produce a pat-
     tern just as in pathname expansion. If 
     the  pattern  matches the beginning of 
     the  value  of parameter, then the ex-
     pansion is the value of parameter with 
     the  shortest matching pattern deleted 
     (the ``#''  case)  or the longest mat-
     ching  pattern   deleted  (the  ``##'' 
     case).

 ${parameter%word}
 ${parameter%%word}
     The word is expanded to produce a pat-
     tern just as in pathname expansion. If 
     the pattern matches a trailing portion 
     of  the  value  of parameter, then the 
     expansion  is  the  value of parameter 
     with the shortest matching pattern de-
     leted  (the ``%'' case) or the longest
     matching  pattern  deleted (the ``%%'' 
     case).


ÝÝCOSHYHLP\INPWORKÝ
ÝexprÝCOSHYHLP\EXPRÝ
ÝextensionsÝCOSHYHLP\SPECPARÝ
ÝOverview of the CommandsÝCOSHYHLP\OVERALLÝ
Ý

1.2  Actions On A Command Line
     ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Each command line evaluated  by CoSHy undergoes
a special sequence of steps.

 * Separation In Words
 * Bracket Expansion
 * Parameter & Variable Substitution
 * Command Substitution
 * Arithmetic Substitution
 * Separation In Words (Again!)
 * Path Expansion
 * Quote Removal

A more detailed description follows below:

Separation of Words:

 Words are  consecutive  characters  which  are
 separated by  non  quoted  meta-characters. As
 long as a command  is  not completely read in,
 CoSHy will read the  next  line  or prompt the
 user to input another line.

 Example:

  ls -l /usr  Consists of 3 words; 'ls', '-l'
              and '/usr'.

Bracket Expansion

 Each  word  of  a  complete  command  will  be
 searched for pairs  of  brackets.  Single non-
 quoted brackets will  not  be  tolerated  on a
 command line.

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

 Example:

  abc{defgh,ij}klmno

  abc                  = Prefix
     {defgh,ij}        = Bracket
               klmno   = Postfix

 The words in brackets  are separated by commas
 and for all of the words z1 to zn, all words.

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

 Will be generated and  inserted in the command
 line instead of the bracket expression.

 Example:

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

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

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

Parameter & Variable Substitutions

 Each  word  will  be  searched  for  $name  or
 ${name}. If  name  is  a  shell  variable, its
 content will be replaced for $name or ${name}.
 Otherwise, this expression will be deleted.

 The second form is used  to separate name from
 possibly following  characters:  $names  won't
 bring the  wanted  results,  whereas  ${name}s
 does. ${n} will also allow larger numbers than
 9 for n.
 
 The second form also denoted some extensions.

Special CoSHy Variables

 $n    Where n is a value between 0 and 9.
 <or>
 ${n}  Where n is a value between 0 and
       32767, and is the n-th parameter
       given to a function or a script.
       $0 is the name of the function or
       the script.

 $#    Number of parameters given to a
       function or a script.
 $?    Status/Return value of the last
       called process/command.
 $@    The parameters of the called script
       or funktion. If $@ is expanded in
       between "" the expansion will be
       performed like
             "$1" "$2" "$3"
 $*    The parameters of the called script
       or funktion. If $@ is expanded in
       between "" the expansion will be
       performed like
             "$1 $2 $3"
       The character between the arguments
       (here space) can be modified using 
       $IFS.
 
Command Substitution

 Each word is searched for $(cmd) or `cmd`. The
 command cmd is  executed  and  its output will
 replace the above expressions. $() expressions
 may be nested, `` expressions may not.

 Example:

 editor $(grep -l double *.c)

 This calls an editor with the parameters being
 all  *.C-Files  containing  the  word  double.
 Grep is an external file utility.

 a=$(expr $a + 1)

 This increments the value of "a" by one.

Arithmetic Substitution.

 Each word is searched for $[ expression ]. The
 'expression' is passed to the expr command and
 its output will replace the $[ expression ].

 Example:

 a=$[ $a + 1 ]  is equivalent to

 a=$(expr $a + 1) and increments a by one.

Separation Of Words (Again!)

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

 Example:

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

  $a              The variable "a" will consist
                  of  three  words  after  this
                  step.

Path Expansion

 Valid filenames containing wildcard
 characters will be expanded:

 *.c          Expands to  all  *.C filenames in
              the current directory.
 *o*          Expands    to    all    filenames
              containing the  letter  o  in the
              current directory.
 *[ch]        Expands to all filenames that end
              with  c  or  h   in  the  current
              directory.
 [a-d]*       Expands to  all  files that start
              with  a,  b,  c   or   d  in  the
              current directory.
 [^a-d]*      Expands  to all files that do not
              start with a, b, c,  and d in the
              current directory.
/*/*.c        Expands to all  *.C filenames one
              directory  level  away  from  the
              root  directory  of  the  current
              drive.
 *a*/*b*/*c*  This is just a joke, but works:
              Expands to all filenames that are
              Two  levels  above  the   current
              working  directory,   where   the
              first  directory  name   has  the
              letter a in  it,  the  second has
              the  letter  b  in   it  and  the
              filename contains a 'c'.

Next Chapter:

 1.3 Overview of the Commands

ÝÝCOSHYHLP\OVERALLÝ
ÝListing of CoSHy CommandsÝCOSHYHLP\LISTÝ
Ý

1.3  Overview of the Commands
     ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Please take note:  All internal commands
concerning a particular  terminal window
or the  serial  port  are  not available
while running CoSHy on the TOS screen.

Assigning Variables

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

Internal & External Commands

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

If a  command  is  not  available  as an
internal  command,   CoSHy   scans   the
environment  (not  the  shell)  variable
$PATH where it  should  find directories
to access external  commands.  To change
the value of $PATH,  you  will also have
to export this value to the environment.

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

Next Chapter:

 1.3.1 Listing of CoSHy Commands

ÝÝCOSHYHLP\LISTÝ
Ý[ expression ]ÝCOSHYHLP\AUSDRUCKÝ
Ý# ...ÝCOSHYHLP\TRUEÝ
Ý! ...ÝCOSHYHLP\NOTÝ
Ý. ...ÝCOSHYHLP\SCRIPTÝ
ÝalertÝCOSHYHLP\ALERTÝ
ÝaliasÝCOSHYHLP\ALIASÝ
ÝbaudÝCOSHYHLP\BAUDÝ
ÝbellÝCOSHYHLP\BELLÝ
ÝblitmodeÝCOSHYHLP\BLITMODEÝ
ÝbreakÝCOSHYHLP\BREAKÝ
ÝcdÝCOSHYHLP\CDÝ
ÝcarrierÝCOSHYHLP\CARRIERÝ
ÝcaseÝCOSHYHLP\CASEÝ
ÝcttyÝCOSHYHLP\CTTYÝ
ÝdialÝCOSHYHLP\DIALÝ
ÝdownloadÝCOSHYHLP\DOWNLOADÝ
ÝechoÝCOSHYHLP\ECHOÝ
ÝenvÝCOSHYHLP\ENVÝ
ÝevalÝCOSHYHLP\EVALÝ
ÝexitÝCOSHYHLP\EXITÝ
ÝexprÝCOSHYHLP\EXPRÝ
ÝfalseÝCOSHYHLP\FALSEÝ
ÝfileselectÝCOSHYHLP\FILESELÝ
ÝfkyÝCOSHYHLP\FKYÝ
ÝflushÝCOSHYHLP\FLUSHÝ
ÝforÝCOSHYHLP\FORÝ
ÝfunctionÝCOSHYHLP\FUNCTIONÝ
ÝgetÝCOSHYHLP\GETÝ
ÝgetkeyÝCOSHYHLP\GETKEYÝ
ÝgettoneÝCOSHYHLP\GETTONEÝ
ÝhangupÝCOSHYHLP\HANGUPÝ
ÝholdscreenÝCOSHYHLP\HOLDSCRNÝ
ÝifÝCOSHYHLP\IFÝ
ÝlogÝCOSHYHLP\LOGÝ
ÝnoiseÝCOSHYHLP\NOISEÝ
ÝOverview Of The CommandsÝCOSHYHLP\OVERALLÝ
ÝplayÝCOSHYHLP\PLAYÝ
ÝprotÝCOSHYHLP\PROTÝ
ÝquitÝCOSHYHLP\QUITÝ
ÝreadÝCOSHYHLP\READÝ
ÝreadkeyÝCOSHYHLP\READKEYÝ
ÝrecordÝCOSHYHLP\RECORDÝ
ÝredrawÝCOSHYHLP\REDRAWÝ
ÝsavebufÝCOSHYHLP\SAVEBUFÝ
ÝscantableÝCOSHYHLP\SCANTABLEÝ
ÝsendÝCOSHYHLP\SENDÝ
ÝsendbreakÝCOSHYHLP\SENDBREAKÝ
ÝsetÝCOSHYHLP\SETÝ
ÝsetenvÝCOSHYHLP\SETENVÝ
ÝshiftÝCOSHYHLP\SHIFTÝ
ÝsleepÝCOSHYHLP\SLEEPÝ
ÝslotÝCOSHYHLP\SLOTÝ
ÝtestÝCOSHYHLP\TESTÝ
ÝtrueÝCOSHYHLP\TRUE1Ý
ÝunaliasÝCOSHYHLP\UNALIASÝ
ÝunsetÝCOSHYHLP\UNSETÝ
ÝuploadÝCOSHYHLP\UPLOADÝ
ÝversionÝCOSHYHLP\VERSIONÝ
ÝwaitforÝCOSHYHLP\WAITFORÝ
ÝwhileÝCOSHYHLP\WHILEÝ
Ý

1.3.1  Listing of CoSHy Commands
       ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
[ expression ]   # ...            ! ...               . ...
alert            alias            baud                bell
blitmode         break            cd                  case
carrier          ctty             dial                download
echo             eval             exit                expr
false            fileselect       fky                 flush
for              function         get                 getkey
gettone          hangup           holdscreen          if
log              noise            play                prot
quit             read             readkey             record
redraw           savebuf          scantable           send
sendbreak        set              setenv              shift
sleep            slot             test                true
unalias          unset            upload              version
waitfor          while

ÝÝEnvironmentÝ
ÝcdÝCOSHYHLP\CDÝ
Ý

CoSHy Environment Variables
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Here you find a list of environment variables used by
CoNnect:

ù PATH
  The access path for CoSHy  program calls. The paths
  are separated by , or ;

  Example:
            PATH=c:/usr/bin,c:/bin,c:/etc

ù PROMPT
  The default prompt for CoSHy.  %p%g will give you a
  dos like command prompt.

  Possible Elements:

             ù %p the current directory
             ù %g the sign >
             ù %t the current time
             ù else the given character

ù COLUMNS
  The number  of  columns  for  a  default  terminal.
  CoNnect  also  sets  this   variable  when  calling
  external programs running in a CoNnect window.

ù LINES
  The number of rows for  a default terminal. CoNnect
  also  sets  this  variable  when  calling  external
  programs running in a  CoNnect  window. If lines is
  not  available, CoNnect will try to evaluate ROWS.

ù SHELL
  A pathname for an external TOS-Shell.

ù HOME
  The home path will be branched to, when calling cd
  without arguments.

             c:/connect> HOME='c:/home'
             c:/connect> export HOME
             c:/connect> cd
             c:/home>

ù CDPATH
  The syntax is  equivalent  to  PATHs  one.  cd will
  search the given  path  names  for possibilities to
  branch to if  a  given  directory  name  can not be
  found in the current directory:

             c:/connect> CDPATH='c:/usr;c:/'
             c:/connect> cd bin
             c:/usr/bin> cd usr
             c:/usr>

ù SUFFIX
  A comma separated list of extensions CoSHy searches
  for,  if  you  name  an  external  program  without
  extension that has to be started.

           Default:  'prg,tos,app,ttp,gtp'

ù GEMSUFFIX
  A comma separated  list  of  extensions where CoSHy
  switches the mouse pointer  on  before starting the
  application.

           Default:  'prg,app,gtp'

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

ÝÝCOSHYHLP\ALERTÝ
Ý

Command alert
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
alert <defaultbutton> <alertstring>

This displays a GEM  alert box. The
parameters are  the  parameters  of
the gem function form_alert().

ÝÝCOSHYHLP\ALIASÝ
Ý

Command alias
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
alias cmd replace

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

To delete an alias, you can use:

alias cmd <or> unalias cmd

Example:  alias l 'ls -l'

This will execute an "ls  -l" if "l" is
entered on the command line.

ÝÝCOSHYHLP\BAUDÝ
Ýport dialogueÝ_PortÝ
Ý

Command baud
ÿÿÿÿÿÿÿÿÿÿÿÿ
baud [rate] [options]

This will display the current baud rate.

If rate is given,  the current port will
be set to this rate.

Options:

 echo   : Echo on
 noecho : Echo off
 local  : Echo local

 rts    : rts/cts  Hardware-Handshake
 xon    : xon/xoff Software-Handshake
 none   : no Handshake

 8N1    : 8 data bits, no
          parity, 1 stop bit
 7E1    : 7 data bits, even
          parity, 1 stop bit
 6O2    : 6 data bits, odd
          parity, 2 stop bits
 5N3    : 5 data bits, no
          parity, 1.5 stop bits

          etc...

Example:

 baud 38400     This  will  set the rate
                to 38400 baud.

SEE ALSO:  port dialogue

ÝÝCOSHYHLP\BELLÝ
ÝnoiseÝCOSHYHLP\NOISEÝ
Ýsound dialogueÝ_SoundÝ
Ý

Command bell
ÿÿÿÿÿÿÿÿÿÿÿÿ
bell n

This will create very beautiful sounds!  ;-)

The following values for n are available.

        1: Bing               2: Bang
        3: Crash              4: Ring
        5: Call               6: Accord

Why? To tease your cat, or to let you know if
a transmission has finished,  or  a script is
now waiting for user input, or ...

Example:

 bell 3    This will make a "crash" sound.

SEE ALSO:  noise, sound dialogue

ÝÝCOSHYHLP\BLITMODEÝ
Ý

Command blitmode
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
blitmode [option]

This command displays the current
blitter status.

 y  - Blitter is on
 n  - Blitter is off
 u  - Blitter is unavailable

Options:

 y    switches the blitter on
 n    switches the blitter off.

ÝÝCOSHYHLP\BREAKÝ
Ý

Command break
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
break n

This will break out  of n nested if,
case, for, or while  structures.  If  
n is omitted, it will be set to one.

Example:

          if [expr1]; then
           if [expr2]; then
            cmd1
           else
            cmd2
            break 2
           fi
            cmd3
          fi

A break level of 2 is needed because
both if structures are to be left.

ÝÝCOSHYHLP\CARRIERÝ
Ý

Command carrier
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
carrier

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

Example:

   if carrier; then
    hangup
   fi

Hangup, if there  is a
carrier.

ÝÝCOSHYHLP\CASEÝ
Ý
 case word in 
   [ pattern [ | pattern ] ... ) 
   list ;; ] ... 
 esac

          
A case command first expands word, and 
tries to match it against each pattern 
in  turn.  When  a match is found, the 
corresponding list is executed.  After 
the first match, no subsequent matches 
are attempted. The exit status is zero 
if no patterns are matches. Otherwise, 
it is the exit status of the last com-
mand executed in list.

Example:

  case $box in
    *Maus*) echo wir sind in einer Maus ;;
    *)      echo wir sind in keiner Maus ;;
  esac


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

Command cd
ÿÿÿÿÿÿÿÿÿÿ
cd path

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

If path begins with a slash (/), then $CDPATH is
not used. The  variable  $OLDPWD  is  set to the
name of the current working directory before the
change.

Example:

 cd connect   Changes to the directory
              CoNnect.

ÝÝCOSHYHLP\CTTYÝ
Ýcharacter set dialogueÝ_ZeichensatzÝ
Ýcompatibility dialogueÝ_Kompatibilit„tÝ
Ýemulation dialogueÝ_EmulationÝ
Ý

Command ccty
ÿÿÿÿÿÿÿÿÿÿÿÿ
ctty [options]

This changes several terminal parameters.

Options:

 VT52
 VT100
 VT102
 VT220-7  switches to  the  corresponding
 VT220-8  terminal emulation.

 VT52id
 VT100id
 VT101id
 VT102id
 VT220id  the same for the terminal id.

 cursnum  normal cursor keys
 cursappl application cursor keys

 keypadnum  numeric keypad
 keypadappl application keypad

 crlflf  incoming <lf>s are expanded to <cr><lf>
 lflf    no expansion of <lf>

 crcrlf  outgoing <cr>s are expanded to <cr><lf>
 crcr    no expansion of <cr>

 bsdel   del (delete) will be sent
         as bs (backspace) and bs
         will be sent as del.
 bsbs    bs and del have their original
         meaning.

 Atari   Atari character set and 'umlaute'
 ISO     ISO character set and 'umlaute'

 autowrap   auto wrap is active
 -autowrap  auto wrap is disabled

 smooth     use smooth scrolling
 -smooth    use fast scrolling

 colour     display ANSI colours
 -colour    do not use ANSI colours

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

 destructive   destructive backspace
 -destructive  normal backspace

SEE ALSO:  emulation dialogue,
           character set dialogue
           compatibility dialogue

ÝÝCOSHYHLP\DIALÝ
Ýdialling dialogueÝ_WahlÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
Ý

Command dial
ÿÿÿÿÿÿÿÿÿÿÿÿ
dial [opt] number

Dials a given phone number. Normally this will be a
text (the text of a phonebook entry in the dialling
dialogue). If there is no matching text, the number
is dialled as it is (containing all symbols in it).

NOTE:  If the text  in  the phonebook entry
       contains spaces, you  should put the
       <number> argument in quotes ' '. You
       may also  just  give  the  first few
       letters of the telephone book entry.
       CoSHy searches for matching entries.

Options:

 -z seq    <seq>  becomes  the reset string. <n> is
 -r n      the number  of  tries  CoSHy  will do to
           get a carrier.  n=0 is used for infinite
           tries.
 -s tim    <tim>  is  the  time between consecutive
           tries (time format).
 -i ini    <ini> becomes the init string.
 -d dia    <dia> becomes the dial string.
 -v        Verbose.
 -n        will display the real number for a given
           phonebook entry. But will not dial.

 number    either phonebook entry or real number.

Returns:

   0  Connect     3  Busy        4  reserved
   5  No Carrier  6  No Answer   7  No Dialtone
   8  Error       9  Ring        10 Userdef
   11 Timeout

Example:

            dial -s 10s -r 5 0623760897

SEE ALSO:  dialling dialogue

ÝÝCOSHYHLP\DOWNLOADÝ
Ýfile transfer dialogueÝ_TransferÝ
Ý

Command download
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
download [-p path]  [filename]

A file will be received with the options set in the
file transfer dialogue. A filename  may be given if
you want to override the  files  filename or if you
are using a protocol  where  the filename itself is
not transmitted (like X-modem).  The option -p path
is  used  to  specify  a  certain  path  where  the
incoming file should be placed.

Example:

 download -p 'f:\dfue\'

ÝÝCOSHYHLP\ECHOÝ
Ý

Command echo
ÿÿÿÿÿÿÿÿÿÿÿÿ
echo [-n] arg1 ...

This will write all its
arguments separated  by
spaces to standard out.
If  -n  is   omitted  a
linefeed is appended.

Example:

 echo "hallo"

ÝÝCOSHYHLP\ENVÝ
ÝenvironmentÝEnvironmentÝ
ÝsetenvÝCOSHYHLP\SETENVÝ
Ý

Command env
ÿÿÿÿÿÿÿÿÿÿÿ
env  [arg1 ...]

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

ÝÝCOSHYHLP\EVALÝ
Ý

Command eval
ÿÿÿÿÿÿÿÿÿÿÿÿ
eval  command

This will  execute  the  given  command  in
CoSHy and will NOT stop  the execution of a
running script, if an error in execution of
the command should occur.

Using eval you may  write a 'remote' script
to run on your computer and you may dial in
from outside  to  work  on  CoSHy's command
line.

Example:

 while true; do
   while true; do
     send 'Remote Script'
     send -n 'please enter password :'
     get -n pass
     if [ $pass = 'joshua' ]; then
       break 2
     fi
   done
   while true; do
     send -n 'Your Input >'
     get a;
     if ! carrier; then
       break 2
     fi
     echo "$a";
     eval "$a" > AUX:
   done
 done

ÝÝCOSHYHLP\EXITÝ
Ý

Command exit
ÿÿÿÿÿÿÿÿÿÿÿÿ
exit n

The current shell  level  is left.  Shell
level might also  be  a  script  file, in
which case execution  will  be stopped if
an exit is executed.  The return value of
the source or . command that executed the
script will be n or 0 if n is omitted.

ÝÝCOSHYHLP\SCANTABLEÝ
Ýscan tableÝScantabelleÝ
Ý

Command scantable
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
scantable [filename]

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

ÝÝCOSHYHLP\EXPRÝ
Ý

Command expr
ÿÿÿÿÿÿÿÿÿÿÿÿ
expr expression

This will evaluate  an  expression  and  put the
result to standard out.  If  you put the command
in $( ) or in `  `  (backquotes) you may use the
result to  fill  other  variables  (see  example
below). The return value of  expr is true (0) if
the result is not 0 and  false (1) if the result
is 0 or the expression contains errors.

Each part  of  expression  has  to  be  a single
argument.

There are the following  operations (in order of
hierarchy).

| OR:   The result  is  the  result  of  its
        first argument if this  is not zero.
        Otherwise, and  only  otherwise, the
        second argument is evaluated and the
        result of the  expression  is set to
        the one of the second argument.

& AND:  The result  is  the  result  of  its
        first  argument  if  this  is  zero.
        Otherwise, and  only  otherwise, the
        second argument is evaluated and the
        result of the  expression  is set to
        the one of the second argument.

< <= != => >:  Compare  its   arguments  and
               return 1 if  the  relation is
               true, 0 otherwise (do not mix
               this up with  the shell value
               for true(0) and false(1)). If
               the arguments are non-numeric
               the comparison  is  done  for
               alphabetical order.

+ -:    Plus and minus;  both  arguments have
        to be  numeric.  The  result  is  the
        result of  the  corresponding numeric
        operation.

* / %:  Multiply,  divide,   and   mod;  both
        arguments have to be  numeric and the
        result is  again  the  result  of the
        corresponding numeric operation.

In all operations brackets may be used to change
operators hierarchy.  Take  care to  quote  them
correctly as ( ) are shell symbols also.

Example:

 expr \( 3 + 2 \) \* 2
             Writes 10 to STDOUT.

 `expr 3 + 2`
             This will replace  the result of
             the expression `  ...  `  with 5
             and tries to execute the command
             5. This normally will fail! :-)

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

 a=$(expr $a + 1)
             Here, "a" will be increased by 1.

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

ÝÝCOSHYHLP\AUSDRUCKÝ
ÝtestÝCOSHYHLP\TESTÝ
Ý

Command expression
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
[ expression ]

The expression is evaluated like in the
test  command.  In   fact   CoSHy  will
replace this construction by:

  test expression.

Example:

[ $v -gt $w ]  Test if the  value of $v
               is higher than the value
               of $w.  The  return code
               will be  0  for  true or
               not 0 for false.

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

Command false
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
false

Will return false (1) as return value.
It is equivalent to "!true".

Example:

 false
 echo $?

ÝÝCOSHYHLP\FILESELÝ
Ý

Command fileselect
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
fileselect <pfad> <default name>
           <extension> <message>

This calls the gem file selector. The
return value is true  (0) if the user
has pressed OK to leave the selector.
The chosen filename will  be found in
the variable $FILESELECT.

ÝÝCOSHYHLP\FKYÝ
Ýfunction key dialogueÝ_FunktionstastenÝ
Ý

Command fky
ÿÿÿÿÿÿÿÿÿÿÿ
fky [opt] num [value]

This command displays or sets function keys.

Options:

 -c CoSHy script key (the left coshy button).
 -n CoSHy script key (the right coshy button).
 -o Will display the old content to stdout.

If value is given,  the  specified key will be
set to the value. num  is  the  same as in the
function key dialogue.

Example:

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

ÝÝCOSHYHLP\FLUSHÝ
Ý

Command flush
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
flush

This command will remove all pending characters
in the IO-Buffer of the SERIAL/MIDI device.

ÝÝCOSHYHLP\FORÝ
Ý

Command for
ÿÿÿÿÿÿÿÿÿÿÿ
for  name in list;
  do cmd1; cmd2; ...
done

For every word in list,  the value of $name
is set to this word and  the commands cmd1,
cmd2, ... between do and done are executed.

Example:

 for a in 1 2 3 4 5 6 7 8 9
  do
   echo $a
  done

This will display the numbers 1 to 9.

ÝÝCOSHYHLP\FUNCTIONÝ
Ý

Command function
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
function name { commands }

This command defines a function named name.
The commands will  be  executed always when
name is executed. Arguments  to name may be
given and will be found in $1, $2 ...

Examples:

 function doubleecho {
                      echo $1 ;
                      echo $1
 }

 doubleecho HELLO

 This will result in:

  HELLO
  HELLO

function name

 This will delete the function named name.

function

 This will display all defined functions.

ÝÝCOSHYHLP\GETÝ
ÝevalÝCOSHYHLP\EVALÝ
ÝreadÝCOSHYHLP\READÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
ÝwaitforÝCOSHYHLP\WAITFORÝ
Ý

Command get
ÿÿÿÿÿÿÿÿÿÿÿ
get <opt> <timoutval> <var1> <var2> ..

This is  equivalent  to  the  read  command. The
input is not typed  in  on  the  keyboard but is
taken from the serial port.  There you will have
the possibility to get  input  from the host (or
remote) side. (See example of the eval command).

The first parameter may  be  -n which will force
get not to send  an  echo  of  the typed in text
(useful for password inputs).

With -v (verbose)  the  typed  in  text  will be
displayed in CoNnect's terminal  window. -c will
cause get to return 2 on carrier loss.

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

SEE ALSO:  time format, waitfor

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

ÝÝCOSHYHLP\GETKEYÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
Ý

Command getkey
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
getkey [-n] [-c] [-v] [timeout] var1 [ var2 ...   ]

This will read as  many  characters from the serial
port as variables are  given.  If  -v  is set, this
characters will be  displayed  on CoNnect's screen.
If -n is set this characters  are not echoed to the
remote side.

A given timeout value  will  cause getkey to return
false if the remote user  did not enter the desired
number of keys  in  the  time  timeout value.

SEE ALSO:  time format

-c will cause getkey to return 2 on carrier loss.

ÝÝCOSHYHLP\GETTONEÝ
Ýanswering machineÝ_AnrufbeantworterÝ
Ý

Command gettone
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
gettone <timeoutval> <var>

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

SEE ALSO:  answering machine.

ÝÝCOSHYHLP\HANGUPÝ
Ýdialling dialogueÝ_WahlÝ
Ý'hangup'ÝT\HANGUPÝ
Ý

Command hangup
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
hangup

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

Example:

 if carrier; then
  hangup
 fi

Hangup is equivalent to  the terminal menu
item 'hangup'.

ÝÝCOSHYHLP\HOLDSCRNÝ
Ýfunction keyÝholdscreen-aktivÝ
Ý

Command holdscreen
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
holdscreen [parameters]

This command toggles - if no parameters are given
- between hold screen on  and off. Watch the hold
screen LED in the terminal menu.

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

Possible parameters are 1 or activate hold screen
or 0 to deactivate it.

ÝÝCOSHYHLP\IFÝ
Ý

Command if
ÿÿÿÿÿÿÿÿÿÿ
if  cmd1; cmd2; ...; then
  cmd3; ...;
[else
  cmd4; ...;]
fi

The  commands  between  if  and  then  are
executed, where the  return  value  of the
last command is important  for the further
proceeding.  If  this  is   true  (0)  the
commands between then and  else  (or fi if
else is omitted) will  be  executed. If it
is false (1) the commands between else and
fi are executed.  The  else  branch may be
omitted.

Example:

 if cmd1;  then    If the return  value of
  echo "Yeah! ;-)" cmd1 is 0, a message of
 else              success is printed.
  echo "damn ;-(" If not, the script won't
 fi                be happy.

ÝÝCOSHYHLP\LOGÝ
Ýcapture dialogueÝ_ProtokollÝ
ÝechoÝCOSHYHLP\ECHOÝ
ÝprotÝCOSHYHLP\PROTÝ
Ý

Command log
ÿÿÿÿÿÿÿÿÿÿÿ
log [-n] text

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

The syntax is equivalent to echo.

SEE ALSO:  prot, capture dialogue

ÝÝCOSHYHLP\NOISEÝ
ÝbellÝCOSHYHLP\BELLÝ
Ý

Command noise
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
noise filename ...

This command plays  a filename by
activating the .MOD  player Paula
or using DMA-Sound.

If neither Paula is installed nor
DMA available you may use bell as
a last chance to produce noise.

ÝÝCOSHYHLP\NOTÝ
Ý

Command !
ÿÿÿÿÿÿÿÿÿ
!  cmd ...

Executes cmd and negates the return code.
True becomes false and vice versa.

In contrast to  Unix  shells the argument
to | may not be a pipe.

Example:

 if ! cmd1 | cmd2; then    UNIX

 if cmd1 | ! cmd2; then    CoSHy

ÝÝCOSHYHLP\PLAYÝ
Ýanswering machineÝ_AnrufbeantworterÝ
Ý

Command play
ÿÿÿÿÿÿÿÿÿÿÿÿ
play name

Plays a voice modem file. Output device
and voice mode have to be set first.

Returns:

  0 Successful
  1 Successful (Truncated Message)
  2 Modem Not Voice Modem.
  3 Timeout
  4 Fax Call
  5 DTMF-Code Received
  6 Data Call
 10 Modem Is Old ZyXEL
 11 CoNnect Not Registered (RECORD ONLY)
 12 Voice-Mode Not Active
 -1 File Write Protected
 -2 File Not Found
 -5 Output Error
-12 Out Of Heap
-13 No File Access
-28 Disk Full

The value of $DTMF  will  be  set to the
received digit in case  a  DTMF code was
received.

SEE ALSO:  answering machine

ÝÝCOSHYHLP\PROTÝ
Ýcapture dialogueÝ_ProtokollÝ
Ý

Command prot
ÿÿÿÿÿÿÿÿÿÿÿÿ
prot [options] [filename]

Options:

 -on    : Capture on, Ascii-Mode
 -asc   : Capture on, Ascii-Mode
 -bin   : Capture op, Binary-Mode
 -off   : Capture off.
          (Default -on)

 -dist  : Select the capture file after
          carrier loss.
 -nodist: Write always to the specified
          file.

 filename: name  of  the  capture file
           (only -on, -asc, -bin)

SEE ALSO:  capture dialogue

ÝÝCOSHYHLP\QUITÝ
Ý

Command quit
ÿÿÿÿÿÿÿÿÿÿÿÿ
quit <val>

Quits CoNnect. CoSHy is terminated and
all windows are  closed.  <val> is the
return code CoNnect will return to the
calling process. Default val is 0.

ÝÝCOSHYHLP\READÝ
Ý

Command read
ÿÿÿÿÿÿÿÿÿÿÿÿ
read name [name2 ...]

Uses STDIN (normally the keyboard) to read in a
string and divides it  (regardless of quoting!)
into parts containing no  spaces  or tabs.  The
parts are then assigned  to the variables name,
name2,  ...  If  there   are  less  parts  then
variables the last  variable  will  be assigned
all missing parts.

Example:

 read bbs; dial $"bbs"

This reads is a bbsname and starts dialling in.

ÝÝCOSHYHLP\READKEYÝ
Ýtimeout valueÝCOSHYHLP\TIMEFORMÝ
Ý

Command readkey
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
readkey [-v] [timeout] var1 [var2...]

Reads as many   characters   as  there are
variable names  (var1,  var2,...) from the
keyboard and assigns the keystrokes to the
given  variable.  If   a  timeout value is
given,  readkey  will  return false (1) if
the user needs too long to enter the keys.

If the option  -v   is   set, readkey will
echo its input on the terminal screen.

ÝÝCOSHYHLP\RECORDÝ
Ýanswering machineÝ_AnrufbeantworterÝ
Ý

Command record
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
record filename

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

Returns:

 0   Successful
 1   Successful (Message Too Long -- Truncated)
 2   Modem Not Voice Modem
 3   Timeout
 4   Fax Call
 6   Data Call
 10  Modem Is Old ZyXEL
 11  CoNnect Not Registered
 -1  Read Only File
 -2  File Not Found
 -5  Write Error
 -13 File Access Refused
 -28 Disk Full

SEE ALSO:  answering machine

ÝÝCOSHYHLP\REDRAWÝ
Ý

Command redraw
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
redraw

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

ÝÝCOSHYHLP\SAVEBUFÝ
Ý'save buffer'ÝT\SAVPUFÝ
Ý

Command savebuf
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
savebuf [-a]  filename

Saves the history buffer  to  a file filename.
If option -a is set, the buffer is appended to
a possibly existing file.

This command  is  useful  before  starting  an
external editor:

Example:

Set a function key to:

  savebuf d:/s.txt; cd c:/edit; edit d:\\s.txt

Click on the left coshy button.

Savebuf  is  similar  to   the  terminal  menu
function 'save buffer'.

ÝÝCOSHYHLP\SCRIPTÝ
Ý

Command . (Script)
ÿÿÿÿÿÿÿÿÿ
.  file arg1 arg2 ...

Runs a file as  a CoSHy Script. The
command is the  dot,  so  between .
and file there has  to  be a space.
Following arguments are assigned to
the values $1 to  $n.  $0 is always
set to the name of file.

Example:

 . maus   Runs a  script maus or if
          the maus is available the
          script MAUS.SCR.

ÝÝCOSHYHLP\SENDÝ
ÝechoÝCOSHYHLP\ECHOÝ
Ý

Command send
ÿÿÿÿÿÿÿÿÿÿÿÿ
send [-n]  arg1 arg2 ....

Is similar to echo, but writes its arguments
to the serial device.

Example:

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

ÝÝCOSHYHLP\SENDBREAKÝ
Ý'sendbreak'ÝT\BREAKÝ
Ý

Command sendbreak
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
sendbreak

On the current port a 'break' will be sent
(0.7s $00 without start or stop bits).

This command is  equivalent  to the action
'sendbreak' in the terminal menu.

ÝÝCOSHYHLP\SETÝ
Ý

Command set
ÿÿÿÿÿÿÿÿÿÿÿ
set  arg1 val1 arg2 val2 ...

Without  arguments  the   shell  variables  are
shown.  Otherwise,   identical   to  arg1=val1;
arg2=val2; ... (this is not a good Unix set!).

Example:

 set HLP 'C:\'     Sets the  shell variable HLP
                   to 'C:\'.

ÝÝCOSHYHLP\SETENVÝ
Ýenvironment variablesÝEnvironmentÝ
Ý

Command setenv
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
setenv  arg1 val1 arg2 val2 ...

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

Example:

 setenv ROWS 24

SEE ALSO: Environment Variables

ÝÝCOSHYHLP\SHIFTÝ
Ý

Command shift
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
shift  m

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

Example:

 shift 3

ÝÝCOSHYHLP\SLEEPÝ
Ýtime formatÝCOSHYHLP\TIMEFORMÝ
Ý

Command sleep
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
sleep [-t] n

Waits a given time  n  (  n  is in the
CoSHy time format).

If option -t is used, n is the time of
day to wait for.

Example:

 sleep 120          Waits 120 sec.
 sleep 2H           Waits   2 h
 sleep -t 730       Waits until 7:30am

ÝÝCOSHYHLP\SLOTÝ
ÝTransfer DialogueÝ_TransferÝ
Ý

Command slot
ÿÿÿÿÿÿÿÿÿÿÿÿ
Without arguments,  this  command
prints the current transfer slot.

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

SEE ALSO: Transfer Dialogue

ÝÝCOSHYHLP\TESTÝ
Ý[  expr  ]ÝCOSHYHLP\AUSDRUCKÝ
ÝifÝCOSHYHLP\IFÝ
ÝwhileÝCOSHYHLP\WHILEÝ
Ý

Command test
ÿÿÿÿÿÿÿÿÿÿÿÿ
test  expression

Returns  either  true   (0)   or   false  (1)
depending of the evaluation  of the relations
in expression.

Possible relations are:

Expression: returns true if:

-d file    file exists and is a directory.

-f file    file exists and is a normal file.

-r file    file exists and is readable.

-s file    file length is not zero.

-t  fd     fd is opened on a tty.   If fd is
           omitted it defaults to 1 (stdout).

-w file    file exists and is writeable.

-z string  length of string is 0.

-n string  length of string is > 0.

str1=str2  str1 and str2 are identical.

str1!=str2 str1 and str2 not identical.

!expr1     expr1 is false.

expr1 -a expr2
           expr1 and expr are true

expr1 -o expr2
           expr1 or expr2 are true

arg1 OP arg2
           an arithmetical comparison
           between arg1 and arg2.
           Values for OP:
           -eq equal
           -ne not equal
           -lt less than
           -le less or equal
           -gt greater than
           -ge greater or equal
           arg1 and arg2 should be integers.

The command  test  can  use  brackets  to set
operator hierarchy.

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

The result of test, normally is used in if or
while statements. It can also be found in $?.

Example:

 test 1 -gt 4  returns false

 [-f connect.prg] should return true in
                  CoNnect's directory.

 test -z ""    returns 0 (true).

ÝÝCOSHYHLP\TIMEFORMÝ
Ý

CoSHy Time Format
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
You can specify the following units
in time format.

 s = Second
 m = Millisecond
 M = Minute
 H = Hour
 h = Centisecond

Example:

   sleep  42H    Waits 42 hours.

ÝÝCOSHYHLP\TRUEÝ
Ý

Command # text
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
This command always returns true. It can
be used as a comment.

Example:

 # quit       (Quit will not be executed
               as it is a comment.)

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

Command true
ÿÿÿÿÿÿÿÿÿÿÿÿ
Always returns true. Identical
to !false.

Example:

 true         (Returns '0')
 echo $?

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

Command unalias
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Removes an alias definition.

unalias alias name

ÝÝCOSHYHLP\UNSETÝ
Ý

Command unset
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
unset arg1 arg2 ...

All variables in the command line will be
unset (deleted).

Example:

 unset a PATH

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

ÝÝCOSHYHLP\UPLOADÝ
ÝTransfer DialogueÝ_TransferÝ
Ý

Command upload
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
A file will be uploaded using the parameters in
the Transfer Dialogue. If filename is missing a
file selector will be  opened  to let you chose
your selection. If  you  are  using an external
protocol, a given filename  will  replace the $
sign in the command line to this programs.

The option -p will allow you to setup a default
upload path.

Example:

 upload 'c:\test\infile.txt'

SEE ALSO: Transfer Dialogue.

ÝÝCOSHYHLP\VERSIONÝ
Ý

Command version
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
The command version  will  display the
current number  of  CoNnect. Normally,
this function will not get in trouble,
if the  version  number  changes while
the command is executed.

ÝÝCOSHYHLP\WAITFORÝ
ÝtimeÝCOSHYHLP\TIMEFORMÝ
Ý

Command waitfor
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
    waitfor [-s -c -i -o file -t time] string1
                          string2 ... string20

Waits until one  of  the  strings  appended as
parameters to waitfor  occurs  in the incoming
data stream or the timeout is reached.

If no timeout occurs waitfor returns true (0).
In addition the variable WAITID  is set to the
string number received (1  -  ...) and WAITSTR
is set to the  string  received. While waiting
all characters received  will  be displayed on
the terminal screen  unless  the  parameter -s
(silent) is set.

The following options are known to waitfor:

 -s       silent - just waiting - not output -
 -c       returns 2 on carrier loss.
 -i       Incoming data is scanned  regardless
          of upper and lower case.
 -t time  timeout value.
 -o file  appends all incoming data to file.

Example:

      if waitfor -t 60 'CONNECT' 'BUSY'
                        'NO CARRIER'; then
        if [ $WAITID = 1 ] ; then
         echo 'we got CoNnected'
        else if [ $WAITSTR = 'BUSY' ]; then
          echo 'Busy'
         else
          echo 'something very funny'
         fi
        fi
       fi

ÝÝCOSHYHLP\WHILEÝ
Ý

Command while
ÿÿÿÿÿÿÿÿÿÿÿÿÿ
     while  cmd1; cmd2; ...; do
       cmd3; ...;
     done

All commands between while and do are
executed and if  the  return  code of
the last  command  is  true  (0)  the
commands  between  do  and  done  are
executed.  Then   proceeding   starts
again until the  last command between
while and do returns false.

Example:

     while [$a -ne 0]
       do
        a='expr $a - 1'
        b='expr $b + 2'
     done

ÝÝEdithelpÝ
Ý

CoNnect On-line Help Editing
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
On-line help in CoNnect needs two files: CONNECT.HLP
and CONNECT.IDX. If you want  to edit help texts (to
remove the lots of  spelling  and grammar mistakes),
you will have to  change  CONNECT.HLP only.  CoNnect
will fix the index file itself.

If you have  corrected  parts  of  the  help file, I
really ask you to  send  them  to  me.   I will then
apply them to the next release.

Help entries start with the line (a help marker).

 ÝÝHelp EntryÝ

Note: When reading this help,  the L dot will appear
as a Ý character.

Where Help Entry is an  arbitrary  marker and can be
used for referencing this help text. Below this line
are the references.

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

The end of the references is marked by a single Ý on
the next line.

Below the help text can  be  found where all phrases
which are equal to the  first  string in a reference
will be bold and  underlined  to  show the user that
this word or phrase is  linked  to another help text
which can  be  reached  by  double-clicking  on  it.
Selecting such an item  will  cause  CoNnect to show
the suitable help text that  has a help marker equal
to the second string in the reference.

ÝÝNeues2.0nÝ
Ý

The information regarding changes
in releases  2.00, 2.01 and 2.02,
has not yet been supplied. Please
contact the author for this.

ÝÝNeues2.10Ý
ÝCharacter SetÝ_ZeichensatzÝ
Ýhistory bufferÝ_PufferÝ
Ýscan tableÝCOSHYHLP\SCANTABLEÝ
Ý

New in 2.10
ÿÿÿÿÿÿÿÿÿÿÿ
 ù CoNnect now has  a  HyperText-like context sensitive
   on-line help.  This  will  be  helpful  for  all the
   beginners in using this  program  as most complaints
   are concerned  with  the  large  number  of possible
   settings.

 ù CoNnect got an  internal  X-,  Y-, Z-Modem protocol.
   Get  more  information,  by   opening  the  transfer
   dialogue and pressing HELP  there.  CompuServe B and
   B+ are also supported internally.

 ù Finally, you are now able  to see the history buffer
   in an extra window. All selecting and clipping stuff
   works fine there too.

 ù CoNnect got some so called  scan tables. They may be
   used to define  any  key  of  the    Atari keyboard.
   Using this  feature  you  can  easily  implement the
   doorway mode  to  have  remote  control  over  a  PC
   running the doorway program.

   A doorway scan table can be found in this archive.

 ù The Type Ahead Buffer (CONTROL+INSERT) will now stay
   open till its window is closed.

 ù Redrawing TEK-windows is  a  lot  faster, due to the
   fact that I needed it myself.  ;-)

 ù Status reports of the TEK-mode are now suppressible.
   This will be a useful feature for VMS-users.

 ù 115200 Baud  on  TT's  Serial2,  on  the  Falcon and
   MegaSTE's MODEM2 and SERIAL2 ports.

 ù Preparations for Mag!X (1.11 and 2.0).

 ù The dialling dialogue now has colour icons.

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

 ù Placing "^" in the  dialling sequence will pull down
   DTR for 700MS.

 ù CONNECT.NUM + Entries

   +t 15.0  Time the modem needs to get a carrier after
            the other side has taken up the phone.

   +T 5.0   Time  a  carrier  must  be  present to make
            CoNnect think it was a real carrier.

   +u DM    Unit of your money - probably $ or œ.

   NUM.DOC provides lots  of  useful  information about
   the programming of CONNECT.NUM!

 ù Using the  compatibility  dialogue  you  can now set
   <LF> to clear screen.

 ù MultiTOS:

   Drag and Drop:   CoNnect  will  start uploading when
   you drop files on its windows.

 ù Money  (Philipp's  request)  can  be  found  in  the
   terminal menu.

 ù A new special character for dialling strings:

     @  escapes the next character.
     @~ does not delay but sends ~
     @@ sends @

 ù Real-time slider in the dialling dialogue.

ÝÝNeues2.20Ý
Ýfrom keyboardÝWahltastaturÝ
Ý

New in 2.20
ÿÿÿÿÿÿÿÿÿÿÿ
 ù PC Colours are  supported finally. See the
   compatibility dialogue for details.

 ù Output speed has  increase  up to a factor
   of 30%.

 ù Bug fixes in the Tek 4014 emulation.

 ù Problems with voice recording and HS-Modem
   /mint fixed.

 ù New help text: Operating the dial dialogue
   from keyboard.

 ù On some  MultiTOS  Versions CoNnect didn't
   work  on  the  Falcon.   Use  one  of  the
   following lines in your MINT.CNF:

         setenv MODEMDEV U:\DEV\AUX
         setenv MODEMDEV U:\DEV\MODEM1
         setenv MODEMDEV U:\DEV\MODEM2

One of them is supposed to give good results,
even on your Falcon.

 ù Like  Mupfel,  CoSHy   now   supports  the
   environment    variables     SUFFIX    and
   GEMSUFFIX. In case you call a GEM program,
   the mouse will be visible. Otherwise, not.

   setenv SUFFIX     'prg,tos,app,ttp,gtp'
   setenv GEMSUFFIX  'prg,app,gtp'

 ù CoNnect now supports the XSDD block device
   drivers for serial I/O.

 ù  Error  131,  which  showed  up  when  'No
   Multi-tasking' was active is removed now.

ÝÝNeues2.40Ý
ÝgetÝCOSHYHLP\GETÝ
ÝgetkeyÝCOSHYHLP\GETKEYÝ
Ýmouse in on-line editorsÝOnlinemausÝ
ÝwaitforÝCOSHYHLP\WAITFORÝ
ÝcaseÝCOSHYHLP\CASEÝ
Ý$* and $@ÝCOSHYHLP\INPWORKÝ
Ýextensions to parameter substitutionÝCOSHYHLP\SPECPARÝ
Ý

New in 2.40
ÿÿÿÿÿÿÿÿÿÿÿ
 ù The upgrade to CoNnect 2.40  is not free DM 10,--)
   for the first time.

 ù Help System updated.

 ù On-line time display does not flicker.

 ù CompuServe  B  and  B+  finally   work.  Thanks to
   CompuServe Munich for the friendly support.

 ù Scripts run a lot faster now.

 ù Z-Modem Autostart  works  fine  now  when  you are
   using the internal Z-Modem -  even if the terminal
   window is in the  background  (lots of Mag!X users
   asked for that).

 ù After  a  file  transfer  the  correlated terminal
   window will top automatically.

 ù Z-Modem Upload got lots  of faster. TT->TT runs at
   15000cps (under Mag!X 2.0).

 ù Mouse interrupts  are  now  disabled when enabling
   the box: 'No Multi-tasking' during file transfers.

 ù Multiple file up/download  will  now have a better
   display in the transfer window.

 ù Crazy Sound will  now  co-operate with CoNnect and
   vice versa.

 ù You can use the mouse in on-line editors.

 ù The ALT key  becomes  more  emacs19 friendly. M->,
   M-< and M-C-x finally work.

 ù The new HS-Modem is  supported.  Users not able to
   install the new HS-Modem due  to a lack of English
   docs, should at least remove the old HS-Modem from
   their autofolders as this one will bomb CoNnect.

 ù Transfer priorities  became  flexible. Windows are
   more easy to use when a transfer is in progress.

 ù 'Z-Modem rename' changed!  Now  the  old file will
   become renamed.  The  received  file  will    keep
   it's name.

 ù get, getkey and waitfor  got  a new parameter (-c)
   to enable carrier checking in these commands.

 ù Adaptions for WinX 2.3 (still beta).

 ù Remarkable output speed improvements.

 ù These  Background windows allow  blinking text and
   blinking cursors.

 ù CoNnect will no longer open all ports but only the
   ones selected by the user.

 ù Severe bugs handling the new HS-Modem were solved.

 ù Bug in Scan tables  removed. Bug made entries with
   less than 3 fields useless.

 ù Some  bugs  in the  Falcon Tos don't cause trouble
   any more.
   1) Io-Redirection
   2) Touching of read-only files.

 ù Scripts are running as an own CoNnect process now.
   This  means  multitasking while CoNnect is working
   on a script.

 ù Even in scriptmode the internal dialog box for the
   file transfer is shown.

 ù Enhancements to vt220.

 ù CR  is  now  mapable  on CRLF in the input stream,
   too.
   
 ù echo $( ls *.c | wc -l ) Files 
   did  not  work  as  there  was a bug in piping in 
   command substitutions.

 ù Voice modems of type TIA TR29.2 are supported
 
 ù CoSHy got a new command: case
 
 ù A new 'LED' in the terminal's menu bar indicates
   an active CoSHy.
 
 ù Two new special parameters for the CoSHy:
   $* and $@

 ù new extensions to parameter substitution 
   were introduced: ${parameter:+word} ...

 ø CompuServe B and B+ work again. Versions
   2.40 - 2.45 had another bug implemented.

 ù ZModem 8K blocks. This option is non 
   conformant with the OMEN protocol and 
   therefore not with DSZ but works fine
   with GEMSZRZ and some unix implementations.
 
 ù The internal file transfer protocols now
   write statistics information into CONNECT.LOG
   which can again be evaluated in the 
   charge statistics dialog.
ÝÝHistoryÝ
ÝChanges up to 2.10ÝNeues2.10Ý
ÝChanges in 2.20ÝNeues2.20Ý
ÝChanges in 2.4xÝNeues2.40Ý
Ý

History
ÿÿÿÿÿÿÿ
We hope you are  using  CoNnect 2.0 or
higher because otherwise  reading this
history will not be much fun for you.

Regarding version  1.96,  CoNnect 2.20
has got a lot of improvements.

           Changes up to 2.10
           Changes in 2.20
           Changes in 2.4x


ÝÝPreislisteÝ
Ýwhere to registerÝWo RegistrierenÝ
Ý

The current shareware fees for CoNnect (valid
until 1.3.1993) can be found in this table:

               | commercial  | non commercial  |
------------------------------------------------
   Key  &      |   DM 150,-  |       DM 60,-   |
   Manual      |    $ 110,-  |        $ 50,-   |
               |    œ  65,-  |        œ 29,95  |
------------------------------------------------
   Key  &      |   DM 170,-  |       DM 65,-   |
   Manual     &|    $ 125,-  |        $ 55,-   |
   Disk        |    œ  70,-  |        œ 33,-   |
------------------------------------------------
   From foreign|   (s.oben)  |     (s. oben)   |
   countries   |   + DM 10,- |      + DM 10,-  |
   to germany  |             |                 |
------------------------------------------------

How do you know if you need a commercial version
or not?   That's  quite easy.   If you are using
CoNnect  with the aim to make any kind of profit
for  yourself or your  company,  you will need a
commercial  registration (the profit made by the
telephone  company  from  CoNnect's  use  is  of
course excluded).  The author of CoNnect himself
has a commercial registration, too ;-)

If  you are using a non-commercial registration,
you should check if the above lines now apply to
you.  In this  case  you  have  to  upgrade to a
commercial version.

It is always important where to register.  Check
here for local distributors.

ÝÝUpdatesÝ
ÝauthorÝProgrammiererÝ
Ý

Updates for CoNnect will be published from
time to  time.  They  usually  involve bug
fixes as well as new features.

As the key system provides a good facility
for registered  users  to  download  a new
version  and  run  a   unlimited  copy  of
CoNnect, I  would  like  to  continue with
this system.

If you  do  not  find  a  new  version  of
CoNnect in your local  bbs,  you  may want
to contact the author for an update.

In this case you have to send him:

 1) An empty formatted disk (3.5" DD).
 2) An envelope with your address on it.
 3) DM 5,- (or equivalent).
 4) + enough money for postage.

If one of these four points is missing you
can be sure not to get any response...

ÝÝFehlerÝ
Ý

Bugs
ÿÿÿÿ
I have  tried  to  release  CoNnect  with  as few
errors as possible  but  CoNnect  is  software so
there will certainly be some  bugs which were not
found until the date  of release... Please inform
the author if you think you have found a bug.

This is a kind of  cookbook  on how to proceed in
such a case.

 a) Try to reproduce the  bug without AUTO folder
    and ACCs.
 b) If the bug is not  present in case a), try to
    find the guilty AUTO-PRG or ACC.
 c) Write a bug report. This should contain:

   ù  the version of CoNnect.

   ù  a description of your system, (TOS-Version,
       Memory, etc).

   ù  a statement saying either  the bug is still
      present using a)  or  specifying the guilty
      component of b) above.

   ù  and a DETAILED description how to reproduce
      the bug.

Following these  instructions  you  can  be  sure
to receive an answer soon.

ÝÝGeneralÝ
ÝhereÝOnlinehilfeÝ
ÝCoSHyÝCoSHyÝ
ÝMain MenuÝHauptmenÝ
ÝTerminal MenuÝMenue-TermÝ
ÝTektronix MenuÝMenue-TekÝ
ÝCreating Help FilesÝEdithelpÝ
ÝsharewareÝSharewareÝ
ÝBug ReportsÝFehlerÝ
ÝChanges In Previous ReleasesÝHistoryÝ
ÝpriceÝPreislisteÝ
Ý

This is the on-line help for CoNnect.
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
Do not forget that CoNnect is a shareware
product. It  is  not  freeware  or public
domain - you have to pay to use it.

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

     Other help may be obtained for:

      CoSHy
      Main Menu
      Terminal Menu
      Tektronix Menu

      Changes In Previous Releases

      Bug Reports

      Creating Help Files

Check for all CoNnect features first and then
compare them to CoNnect's incredible low price.
