Madness Mailbox-System                               Hamburg, den 10.04.1994
======================

System-External: Fullscreen-Chat fr VT52 & VT100, Version V1.72
                 (c) by Jrgen Meyer


Neue Features in der V1.72 (nderungen seit V1.71)

- Anpassung an Farbfhigkeiten und Mad-Sys V4.05.R1

- Mehr Mglichkeiten in der Datei "CHATMODE.DAT" (Ordner \SYSTEM). Bitte
  Info in der Datei selbst nachlesen!


Neue Features in der V1.71 (nderungen seit V1.70)

- Im Einfach-Chat-Modus wird nach Eingabe des 79.igsten Zeichens automatisch
  ein CR/LF ausgefhrt, damit das Protokollfile nicht mehr als 79 Zeichen/
  Zeile enthlt; zudem kommen manche Uralt-Terminalprogramme damit nicht
  zurecht

- BACKSPACE lscht nun nicht mehr den Protokollbuffer, wenn der Cursor am
  Anfang der Zeile steht (Einfach-Chat-Modus)

- Hervorheben von Eingaben durch CTRL-A nun auch im Einfach-Chat-Modus
  mglich.


Neue Features in der V1.70 (nderungen seit V1.63)

- Chataufruf nun ber alle Schnittstellen mglich. ber Console mu immer
  RETURN zur Annahme des Chats gedrckt werden, ber eine beliebige Schnitt-
  stelle mu "CHAT" + CR gesendet werden.

- Chat nun auch via jede beliebige Schnittstelle mglich. Umgeschaltet auf
  den Primitiv-Chat wird nur noch dann, wenn der Aufruf von der eigenen
  Console kam oder der Gegenuser mit weniger als 2400 bps eingeloggt ist.

- Im Fullscreen-Modus hat nun jeder Teilnehmer 9 Zeilen zum Schreiben statt
  bisher 8 Zeilen. Die Trennung der Fenster wurde zusammengezogen.

- Aufgrund des mglichen totalen Gegenschreibens im FS-Chat sah ein evtl.
  mitgespeichertes Protokoll wst bis absolut unverstndlich aus. Daher
  wird das Protokoll im FS-Chat-Modus nun vllig anders abgespeichert.
  Im Protokollfile erscheint jeweils eine Zeile des betreffenden Users.
  Zeilen, die mit "S:" beginnen, sind vom SysOp getippt worden, Zeilen
  mit "U:" vom User. Damit der zeitliche Ablauf im Protokoll ersichtlich
  ist, wird immer dann eine Zeile gesichert, wenn der User/SysOp das
  Ende der Zeile erreicht hat, RETURN drckt, mit CTRL-C seinen Bildschirm
  lscht oder der Chat beendet wird.
  Somit sollten mitgespeicherte Protokolle deutlich verstndlicher sein
  als zuvor.

- Diverse Unschnheiten im Protokollfile beseitigt.

- Whrend des Chats (FS-Chat only) kann beliebig zwischen der Gegen-Chat-
  Stelle (also seitens des SysOp) gewechselt werden. Hat der SysOp den
  Chat ber MIDI (zum Beispiel) angenommen, so langt ein Druck der RETURN
  Taste auf der Mailbox-Console und der Chat wird auf die Console des
  MB-Rechners umgelenkt. Der User sieht davon nichts, auer einem Neuauf-
  bau des Bildschirm. Dran denken: Zum SysOp hin arbeitet der FS-Chat
  *IMMER* mit der VT52-Emulation!
  Wurde der Chat ber Console angenommen, so kann durch Senden von "CHAT"
  + CR whrend des Chatvorganges die Ein-/Ausgabe fr den SysOp auf die
  Schnittstelle umgelenkt werden, von der das "CHAT" + CR kam.

Generell: Die Umlenkung funktioniert nur fr via Bconmap() (ab TOS 2.xx)
erreichbare Schnittstellen. Evtl. Carrier-berwachungen seitens der SysOp-
Seite finden natrlicht nicht statt.


Neu in Version V1.63 gegenber V1.62

- Nur Bugfixes


Neu in Version V1.62 gegenber V1.61 / V1.6

- Nur Bugfixes


Neu in Version V1.6 gegenber V1.5:

- Anpassung an V4.00 und Umlautwandlung


Neu in Version V1.5 gegenber V1.4:

- SYS_CHAT.PRG erlaubt nun das Mit-Protokollieren des Chats. Der User bekommt
  davon nichts mit. Der Protokoll-Status kann vom SysOp mit CTRL-P gewechselt
  werden. SYS_CHAT.PRG schaltet den Protokoll-Status selbstndig auf "AUS",
  also nicht mitprotokollieren, wenn kein Speicher mehr verfgbar ist. Pro
  Aufruf von SYS_CHAT.PRG kann maximal der restliche ST-RAM Speicher als
  Protokoll-Buffer genutzt werden.
  Die Protokolle werden unter dem Dateinamen "SYSCHPRO.TXT" im Ordner \TEXTE
  abgelegt. Sofern die Datei bereits existiert, werden aktuelle Protokolle
  immer an die Datei angehngt.


Neu in Version V1.4 gegenber V1.3:

- Nur Anpassung auf Entfernung von Tilden in Parameter-Dateien


Neu in Version V1.3 gegenber V1.2:

- Nur interne Korrekturen & Anpassung an neue Ausgaberoutine


Neu in Version V1.2 gegenber V1.1:

- Feature "CTRL-Z"
- Anzeige der Vorgnge im Programm, sofern SysOp-Console eingeschaltet
- Warnung vor Zeitgrenze-erreicht bei Restzeit < 2 Minuten


Neu in Version V1.1 gegenber V1.0:

- Feature "CTRL-A"
- Einbau des 08/15 Chats bei TTY oder User nicht ber RS232 eingeloggt
- Umschalten auf Einfach-Chat bei bps-Raten kleiner 2400 bps



Dieses External bietet nun auch fr das Mad-Sys einen echten Fullscreen-
Chat mit zwei geteilten Bildschirmen. Der FS-Chat arbeitet mit VT52 oder
VT100 zusammen.


Installation
------------

Das Programm "SYS_CHAT.PRG" mu in den Ordner \EXTERN kopiert werden.
Anschlieend mu der Aufruf in "MENUE.DAT" (im Ordner \SYSTEM) fest-
gelegt werden. Der FS-Chat wird mit "X SYS_CHAT.PRG" aufgerufen. Da
die Madness ab Version V3.66.R1 keinen eingebauten Chat mehr besitzt,
sollte SYS_CHAT.PRG in MENUE.DAT unter dem Befehl "CH" installiert
werden.


Technisches
-----------

Der FS-Chat kann nur bei einem Login ber die RS232 und eingeschalteter
VT52 oder VT100/VT102/ANSI-Emulation genutzt werden. Bei TTY-Emulation
(also: Keine Emulation) oder Login ber MIDI wird ein normaler 08/15-
Chat, wo beide Seiten blind gegenschreiben, verwendet. Ist der User
ber die RS232 mit einer bps-Rate von kleiner als 2400 eingeloggt,
so wird ebenfalls der Einfach-Chat verwendet.

Dieses External ersetzt ab Mad-Sys Version V3.66.R1 komplett die
internen Chat-Routinen. Wird also mittels F12 oder F8 vom Mad-Sys
aus ein Chat gewnscht, wird dieses Programm gestartet. Wird es
nicht gefunden, ist halt kein Chat mglich. Somit ist es aber nun
einfach, einen eigenen Chat einzubinden, sofern durch Erscheinen dieses
Programmes berhaupt noch der Wunsch besteht.

Aufgrund der Problematik, da unter Umstnden (z.B. F12 drcken -->
Chatanforderung) der Chat mitten in einer Eingabe aufgerufen werden
kann, wei der User nach Verlassen des Chats evtl. nicht, was er
nun machen soll - Die Box kehrt ja wieder in die Eingabe-Schleife
zurck. Aus diesem Grunde sollte man als SysOp einen User nur im
Menue zum Chat holen, oder besser noch, die F8-Funktion nutzen.
Im Menue wiederum erkennt die Box das Starten von SYS_CHAT.PRG und
baut das Menue nach Rckkehr aus dem Chat selbst wieder auf.


Betrieb
-------

Beim Start des FS-Chat wird die Datei "CHATMODE.DAT" (Ordner \SYSTEM)
ausgelesen und das aktuell eingestellte SysOp-Flag beachtet. Ist auf
der Mad-Sys Console "SysOp nicht anwesend" aktiv, so bekommt der User
den in CHATMODE.DAT definierten Text angezeigt. Gleiches gilt fr die
zweite, definierbare Option (Mad-Sys Console: "SysOp ...").

Ist die Console auf "SysOp ist anwesend" geschaltet, so wird dem User
auch hier der passende String gesendet und das Chat-Ruf-Signal ertnt.
Dieses Signal ist von der Akustik identisch mit dem Mad-Sys internen
Chat-Ruf. Es werden maximal 40 Rufzeichen ausgegeben. Der User bekommt
jedesmal "RING ..." auf seinem Bildschirm angezeigt. Wie beim Mad-Sys
internen Chat auch, kann der User jederzeit mit ESC, CTRL-X etc. das
Rufen abbrechen.

Beantwortet der SysOp das Ruf-Signal nicht, wird dergleiche Text wie
im Mad-Sys ausgegeben ("SysOp nicht in Nhe des Rechners ...").

Die Annahme eines Chat-Rufs ist auf zwei Weisen mglich. Einmal kann
der SysOp bei Ertnen der Ruf-Signales die RETURN- oder ENTER-Taste
bettigen. Der Chat-Bildschirm wird dann aufgebaut.

Eine Annahme ist aber auch ber die MIDI-Schnittstelle mglich. Diese
zweite Mglichkeit besteht daran, whrend des Ruf-Signales den String
"CHAT"+CR ( CR = ASCII 13, RETURN) zu senden. Erkennt der FS-Chat
whrend des Rufens diesen String von der MIDI-Schnittstelle, so wird
der Chat ber die MIDI-Schnittstelle abgewickelt. Auf dem Mad-Sys
Consolen-Bildschirm wird dann nichts ausgegeben. Hier noch mal in
Kurzform:

1. Mglichkeit: Der User ruft zum Chat, der SysOp drckt RETURN oder
                ENTER auf dem Boxrechner. Der Chat findet dann zwischen
                dem ber die RS232 (Modem) eingeloggten User und der
                Mad-Sys Console statt.

2. Mglichkeit: Der User ruft zum Chat, der SysOp sendet ber die MIDI-
                Schnittstelle den String "CHAT"+CR (ohne Anfhrungs-
                Zeichen). Der Chat findet dann zwischen dem ber die
                RS232 eingeloggten User und der MIDI-Schnittstelle, an
                der ein zweiter Rechner angeschlossen sein sollte, statt.

Ein Chat zwischen Console und einem ber die MIDI-Schnittstelle einge-
loggtem User ist demzufolge nicht im Fullscreen-Modus mglich. Wird ein
Chat per MIDI-Login angefordert und der SysOp quittiert dies, so wird
der altbekannte, einfache Gegenschreib-Chat aufgerufen. Dieser bietet
allerdings keine Extras.


Der Chat
--------

Der Chat-Bildschirm besteht aus zwei Teilen. Im oberen Fenster sind die
Eingaben des SysOps zu sehen, im unteren Fenster die Eingaben des Users.
Der SysOp bekommt auf seinem Bildschirm zustzlich den Usernamen, Status,
Onlinezeit und verbleibende Restzeit angezeigt. Diese Anzeige wird alle
5 Sekunden aktualisiert. Der User sieht in der entsprechenden Zeile nichts.

Beide Chat-Teilnehmer knnen parallel tippen. Der SysOp hat insofern
Prioritt, als da er immmer als Erster nach Tastatureingaben abgefragt
wird und die Ausgaben immer zuerst an den SysOp stattfinden. Somit kann
der SysOp durch schnelles Tippen den User immer zu Unterbrechungen
zwingen. Allerdings mu man dann _sehr_ schnell tippen knnen :-)

Jedem Teilnehmer steht ein Fenster aus 75 Spalten x 8 Zeilen zur Ver-
fgung. Die 76.igste Spalte ist zwar erkennbar, kann aber nicht genutzt
werden, da sonst der Bildschirm durch Fehler in gngigen Terminalpro-
grammen zerstrt wird. Gelangt man an das Ende der aktuellen Zeile,
so wird automatisch zum Anfang der nchsten Zeile gesprungen.

Ist einer der Teilnehmer am Ende der 8. Zeile angetroffen oder drckt
vorzeitig RETURN, um in eine neue Zeile zu gelangen, so wird die 8.
Zeile zur Orientierung in die 1. Zeile des eigenen Fenster kopiert und
die folgenden Zeilen gelscht. Es wird dann an Zeile 2, Spalte 1 weiter
eingegeben.


Funktionen im Chat
------------------

Derzeit gibt es drei Funktionen im Chat, die jederzeit von jedem Teil-
nehmer aktiviert werden knnen. Diese Funktionen sind nur im Full-
Screen-Chat Modus verfgbar!

CTRL-X   Durch Drcken dieser Tasten-Kombination seitens des Users oder
         seitens des SysOps wird der FS-Chat beendet. Auf beiden Seiten
         wird der Bildschirm gelscht.

         Mit CTRL-X wird auch der einfache Gegenschreib-Chat beendet!

CTRL-R   Drckt einer der Teilnehmer diese Kombination, wird der gesamte
         Bildschirm komplett neu aufgebaut. Die Cursor beider Teilnehmer
         stehen nach beendetem Aufbau wieder an den Stellen, wo sie vor
         Aktivierung dieses Features gestanden haben. Diese Funktion ist
         dann gut anwendbar, wenn der eingeloggte User kein Fehler-
         sicherungsprotokoll (MNP oder V.42 bzw. HST oder PEP) verwendet
         und demzufolge Strzeichen in der bertragung den Bildaufbau
         zerstren knnten, da die Steuersequenzen nicht mehr korrekt
         empfangen werden. Auch wenn der SysOp den Chat mal ber die
         MIDI-Schnittstelle bedient, kann es gelegentlich zu Strungen
         kommen. Die Verwendung dieser Funktion kann zur einer starken
         Verzgerung kommen, wenn der eingeloggte User nur ber eine
         geringe bps-Rate verfgt.

CTRL-C   Wenn einer der beiden Teilnehmer diese Kombination drckt, so
         wird der jeweilig eigene Bildschirm-Bereich (Fenster) gelscht
         und der eigene Cursor an Spalte 1, Zeile 1 gesetzt.

CTRL-A   Hiermit wird der Invers-Modus aus- bzw. eingeschaltet. Durch
         Drcken dieser Kombination erscheint bei demjenigen, der die
         Taste gedrckt hat, alle Zeichen invertiert, d.h. bei normaler
         Farbendarstellung weie Zeichen auf schwarzem Grund (bei
         Farbmonitoren entsprechende Invertierungen). Praktisch zum
         hervorheben einiger Wrter. Dieses Feature kann von jedem
         Teilnehmer genutzt werden und beeinflut wie bei CTRL-C immer
         nur die eigene Seite des Bildschirms.

CTRL-Z   Diese Taste kann nur vom SysOp gedrckt werden. Hiermit wird
         auf den Normal-Chat, den einfachen Gegenschreib-Chat, umge-
         schaltet. Ein Zurckschalten auf den FS-Chat ist dann nicht
         mehr mglich.


MfG. Jrgen Meyer

