                           Dokumentation zu

                              AV-Server

                             Version 1.1
                            3. Januar 1997

                                 von

                           Alexander Barton




Inhaltsverzeichnis
------------------

1  Einfhrung
   1.1  Funktionsbeschreibung
   1.2  Zukunft
   1.3  Rechtliches
   1.4  Autor
   1.5  Danksagungen

2  Installation

3  Konfiguration

4  Technisches

5  History



1 Einfhrung
------------

Der Desktop MagXDesk von MagiC untersttzte bis zur Version 4 von
MagiC kein AV-Protokoll und in Version 5 nur einige wenige Funktio-
nen. Daher war es unter MagiC bis einschlielich Version 5 mit MagX-
Desk als Desktop nicht mglich, bestimmte Programme und/oder Funk-
tionen sinvoll einzusetzen. Einige Funktionen konnten auch berhaupt
nicht ausgefhrt werden.

Mein Ziel war es daher, einen externen AV-Server fr MagiC und MagX-
Desk zu schreiben, der es auch unter dieser Konfiguration erlaubt,
das AV-Protokoll zu benutzen.

Ich denke, da ich dieses Ziel verwirklichen konnte. Allerdings kann
der AV-Server nicht das komplette Protokoll nachbauen, da AV-Server
MagXDesk so weit nicht beeinflussen kann: so ist zum Beispiel kein
globaler Fensterwechsel mit den Fenstern von MagXDesk mglich.



1.1 Funktionsbeschreibung
-------------------------

AV-Server ist ein externer AV-Server, der zusammen (und nur zusammen)
mit MagiC und MagXDesk eingesetzt werden kann und die fehlenden Funk-
tionen des AV-Protokolls auch unter dieser Konfiguration verfgbar
macht.

Folgende Funktionen, die ber das AV-Protokoll abgewickelt werden,
sind mit installiertem AV-Server unter MagiC mit MagXDesk (wieder)
mglich:

- Dateien knnen aus MagXDesk auf Fenster von angemeldeten AV-
  Clients gezogen werden. Dies ist z.B. mit AppLine, PacShell und
  ST-Guide sinnvoll.
- Programme knnen z.B. aus ParaFin oder Finder wieder nachgestartet
  werden.
- Dateien knnen mit Drag&Drop zwischen angemeldeten AV-Clients aus-
  getauscht werden. Dies ist z.B. mit ParaFin, PacShell und AppLine
  sinnvoll.
- Verzeichnisfenster von MagXDesk lassen sich z.B. von Finder oder
  ParaFin ffnen.
- Lschen von Dateien aus den Fenstern von z.B. ParaFin oder Finder
  ist mglich, indem die Dateien auf den Papierkorb von MagXDesk
  gezogen werden. Es wird dann genau so verfahren, wie wenn die Da-
  teien direkt aus MagXDesk gelscht wrden: MG-Copy wird gestartet
  (ein Betrieb mit Kobold ist zur Zeit [noch] nicht implementiert).
- Dateien knnen z.B. aus ParaFin kopiert werden, indem Sie auf
  Laufwerksfenster oder Laufwerksicons von MagXDesk gezogen werden;
  es wird dann MG-Copy gestartet.
  ACHTUNG: Im gegensatz zu MagXDesk wird eine Datei immer in das Ver-
  zeichnis des Fensters kopiert, auch wenn ein Ordnerobjekt das Ziel
  war!
- Dateien knnen aus z.B. ParaFin oder Finder auf Programmicons auf dem
  Desktop von MagXDesk gezogen werden. Das entsprechende Programm wird
  dann mit dieser Datei als Parameter gestartet bzw. die datei wird mit
  VA_START an das Programm bergeben.
- Unter angemeldeten AV-Clients (z.B. ST-Guide, Finder, ParaFin etc.)
  ist globales Window-Cycling mit CTRL+W mglich.

Dieses ist nur eine beispielhafte Aufzhlung von mglichen Einstzen
von AV-Server. Eigentlich alle Programme, welche das AV-Protokoll
ntzen - und das sind einige - knnen wieder mit vollem Funktionsum-
fang unter MagiC zusammen mit MagXDesk eingesetzt werden.

AV-Server hat aber noch eine weitere Funktion: er kann als Server
fr das Font-Protokoll eingesetzt werden und bietet dafr den in
MagiC fest integrierten Fontselektor an. Mit dieser Funktion kann
z.B. in ST-Guide ohne zustzlich installierten externen Fontselektor
unter MagiC ein Zeichensatz ausgewhlt werden. Von dieser Funktion
profitieren alle Programme, welche das Font-Protokoll untersttzen.


1.2 Zukunft
-----------

Generell wre es wnschenswert, wenn MagXDesk selber den vollen Funk-
tionsumfang des AV-Protokolls untersttzen wrde - dann wre der AV-
Server berflssig.

Da dieses in absehbarer Zeit aber wohl nicht in MagXDesk implemen-
tiert wird, wird AV-Server weiterhin ntig sein. Ich werde daher AV-
Server an alle weitern Versionen von MagiC und MagXDesk anpassen und
evtl. den Funktionsumfang so anpassen, da immer nur die bentigten
Funktionen noch von AV-Server ergnzt werden. Dies wird bereits zur
Zeit so gemacht.

Da mir zur Zeit MagiC 5 noch nicht vorliegt, wre also der nchste
Schritt, AV-Server an diese Version von MagiC anzupassen, um den AV-
Server mglichst klein zu halten.


1.3 Rechtliches
---------------

AV-Server ist Freeware. Das bedeutet, da Sie das komplette Programm-
archiv beliebig lang und kostenlos benutzen drfen. Der Autor freut
sich aber dennoch ber kleine Spenden und sonstige (nette?) Rckmel-
dungen... ;-)

Sie drfen AV-Server unverndert und als komplettes Archiv (bitte
nicht umpacken!) kostenlos beliebig oft kopieren, weitergeben und in
Mailboxen sowie auf FTP-Server uploaden.

Folgende Dateien gehren zum AV-Server-Programmpaket:

AVSERVER.APP       Das eigentliche Programm, welches die Funktionen
                   nachrstet.
AV-TEST.APP        Ein Testprogramm fr das AV-Protokoll
AV-TEST.RSC        Die Resource-Datei von AV-Test
A_MAN.LZH          Das original A-MAN-Archiv von Sven Kopacz. A-Man
                   wird von AV-Server bentigt.
DOKU\AVSERVER.HYP  Dokumentation zu AV-Server im ST-Guide-Format.
DOKU\AVSERVER.TXT  Dokumentation zu AV-Server im ASCII-Format.
DOKU\AV-TEST.TXT   Dokumentation zu AV-Test im ASCII-Format.


Ein kommerzieller Vertrieb von AV-Server ist nur mit ausdrcklicher
schriftlicher Genehmigung des Autors gestattet! Der Vertrieb in PD-
Serien ist nur dann gestattet, wenn der Diskettenpreis nicht mehr als
DM 10.- betrgt.

Alle Rechte an AV-Server und dieser Dokumentation liegen beim Autor.



1.4 Autor
---------

Autor:

 Alexander Barton
 Eichbergstrae 46
 79117 Freiburg
 Deutschland

Wer von mir eine Antwort erwartet, der sollte einen ausreichend fran-
kierten Rckumschlag beilegen!

ber eMail erreicht man mich unter:

 Alexander Barton @ FR (MausNet)
 alexander.barton@metronet.de (InterNet)



1.5 Danksagungen
----------------

Mein Dank geht an:

- Holger Weets (Holger Weets @ OL) fr gute Tips, neue Ideen, aus-
  fhrliche Tests und einige Assembler-Funktionen.
- Holger Dietrich (MausNet: Holger Dietrich @ FR) fr ausfhrliche
  Beta-Tests
- Sven Kopacz (Sven Kopacz @ LB) fr A-MAN.



2 Installation
--------------

Der AV-Server arbeitet sowohl als Accessory als auch als "normale"
Applikation und mu daher entweder als AVSERVER.ACC ins Accessory-
Verzeichnis (vgl. #_ACC in MAGX.INF) oder als AVSERVER.APP in das
START-Verzeichnis (vgl. #_APP in MAGX.INF) von MagiC kopiert werden.
Nach Mglichkeit sollte AV-Server als Applikation und nicht als
Accessory installiert werden.

Um AV-Server zu aktivieren, mu in MAGX.INF noch folgende Zeile ein-
getragen werden: #_ENV AVSERVER=AVSERVER

Wenn diese Zeile nicht vorhanden ist, also die Environmentvariable
AVSERVER nicht oder nicht auf AVSERVER gesetzt ist, so installiert
sich AV-Server nicht.

ACHTUNG: Es sollte immer nur eine Zeile in MAGX.INF geben, die mit
'#_ENV AVSERVER=' beginnt, da immer nur die Zuweisung beachtet wird,
welche in MAGX.INF zuletzt erscheint. In MAGX.INF knnen Zeilen mit
';' auskommentiert werden.

Wenn AV-Server auch als Server fr das FONT-Protokoll verwendet werden 
soll, so mu zustzlich folgende Zeile in MAGX.INF hinzugefgt werden:
#_ENV FONTSELECT=AVSERVER

ACHTUNG: AV-Server bentigt, um Drag&Drop-Aktionen mit MagXDesk aus-
fhren zu knnen, zwingend das Programm A-MAN von Sven Kopacz! Ist
dieses Programm nicht installiert, so sind diese Funktionen von AV-
Server nicht verfgbar. A-MAN liegt diesem Programmpaket bei, be-
achten Sie bitte den zu A-MAN gehrenden Text.

Nach diesen Schritten ist AV-Server auf Ihrem System installiert und
wird nach dem nchsten Neustart aktiv.

ACHTUNG: AV-Server ist nur fr den Betrieb zusammen mit MagXDesk aus-
gelegt und bentigt diesen Desktop fr einige Funktionen zwingend. Es
kann daher ohne MagXDesk als Desktop zu Fehlfunktionen kommen!


3 Konfiguration
---------------

HINWEIS: Zur Konfiguration von AV-Server wird das Programm Setter
(als SETTER.PRG oder SETTER.TTP) von Harun Scheutzow (bzw. Markus
Kohm, GEM-Version) bentigt.

Die genaue Bedienung von Setter entnehme man bitte den jeweiligen
Texten zu diesem Programm.

AV-Server kann zur Zeit nur in einem einzigen Punkt konfiguriert wer-
den: Dateinamen knnen bei AV_STARTPROG wahlweise in Grobuchstaben
gewandelt werden, da ansonsten einige alten Programme zusammen mit
MagXDesk Schwierigkeiten haben.

Diese Einstellung (AV_STARTPROG: Convert filename to upper-case)
kann in Setter ein- und ausgeschaltet werden. Als Default ist diese
Option eingeschaltet.

Weitere Konfigurationsmglichkeiten existieren zur Zeit (noch) nicht.



4  Technisches
--------------

AV-Server hngt sich in den AES- bzw. VDI-Trap (Trap #2), um Drag-
And-Drop-Aktionen abfangen zu knnen. Da AV-Server etv_term jedoch
verwendet, ist ein Entfernen von AV-Server im Task Manager von MagiC
bzw. ein Lschen in U:\PROC\ auch im laufenden Betrieb mglich.

AV-Server untersttzt ShutDown und AP_TERM.



5  History
----------

Version 1.0

- erste ffentliche Version

Version 1.1

- Fehlermeldung bei keiner MAGX.INF
- Anpassung an MagXDesk 3.1x (MagiC 5)
- Interne Anpassungen am D&D-Handler.
- AV_PATH_UPDATE sicherer gemacht.
- AV_COPYFILE und AV_DELFILE werden untersttzt
- Kommandozeile fr MG-Copy modifiziert: Option -f (freien Speicher
  testen) wird verwendet. Somit funktioniert auch die Anzeige "kBytes"
  in MG-Copy wieder.

