

                                     Das

                                 kleine Buch

                                     zum

                                   Logbuch


1. Einleitung
-------------
Logbuch ist der 1001. Programmstarter auf dem Atari. Anders als die
Konkurrenz imitiert es jedoch nicht die Start-Schaltflche von Macabrosoft
Windows 95, sondern orientiert sich an einem Schreibtischzubehr auf dem
Macintosh ("Benutzte Programme").

Logbuch merkt sich gestartete Programme und verwaltet ihre Namen in einer
Liste. Diese Programme knnen in einem Popupmen ausgewhlt und dadurch erneut
gestartet werden.

2. Rechtliches
--------------
Zunchst die gute Nachricht:

Logbuch ist Freeware!

Jede nichtkommerzielle Verbreitung von Logbuch ist ausdrcklich
erwnscht, sofern die Distribution vollstndig weitergegeben wird.

Und nun der Haken:

Wir, die Autoren, bernehmen keine Haftung fr Schden jedweder Art,
die aus dem Gebrauch von Logbuch oder dieser Anleitung entstehen,
sofern wir sie nicht vorstzlich oder grob fahrlssig verschuldet
haben.

Merke: Du lieber Leser bist selbst schuld!

3. Dateien in diesem Archiv
---------------------------
logtsr.prg     der residente Teil, der das Logbuch fhrt
logbuch.acc    das Hauptmodul, das das Popup zugnglich macht
logbuch.rsc    die Resource des logbuch.acc  
logbuch.cpx    ein CPX-Modul fr diverse Einstellungen
liesmich.txt   dieser Text

4. Systemvoraussetzungen
------------------------
Zunchst einmal brauchen Sie eines der Multitasking-Systeme MagiC (ab Version
3.00) und N.AES. Sie knnen mglicherweise auch Geneva, oAESis oder ein
sonstiges System verwenden; unter dieser Software haben wir Logbuch
allerdings nicht getestet.

Logbuch kann unter SingleTOS NICHT sinnvoll eingesetzt werden - und luft
auch nicht.

Ferner benutzt Logbuch einen Desktop, der das AV-Protokoll untersttzt, um
die Programme zu starten. Insoweit kommen etwa Thing und Gemini in Betracht.

Schlielich ist es sinnvoll, ein erweitertes Kontrollfeld zu nutzen, um
Logbuch mit dem logbuch.cpx konfigurieren zu knnen. 

5. Installation
---------------
Fhren Sie die nachfolgenden Schritte aus, um Logbuch auf Ihrem System zu
installieren.

(1)   Der residente Teil logtsr.prg sollte beim Systemstart ausgefhrt werden.

      Unter MagiC kopieren Sie ihn dazu in den Start-Ordner. Dies ist der
      Ordner, der in der Datei magx.inf bei #_APP angegeben ist; typischerweise
      handelt es sich um die Verzeichnisse \gemsys\magic\start oder
      \gemsys\magic\apps auf Ihrem Bootlaufwerk.
      
      Verwenden Sie N.AES, so fgen Sie in die Datei n_aes.cnf die Zeile
         run c:\logbuch\logtsr.prg
      ein (wobei wir hier voraussetzen, da Sie Logbuch in das Verzeichnis
      c:\logbuch entpacken; Sie knnen natrlich auch jeden anderen Pfad
      verwenden).
                    
      Logtsr.prg gehrt dagegen auf keinen Fall in den AUTO-Ordner! Es
      bentigt initialisierte AES, um laufen zu knnen.

      Bei Bedarf kann logtsr aber auch zu jedem spteren Zeitpunkt
      nachgestartet werden. 
          
(2)   Kopieren Sie logbuch.acc und logbuch.rsc in das Verzeichnis, aus dem Sie
      Ihre Accessories booten.
      
      Sie knnen logbuch.acc aber auch in logbuch.app umbenennen und als
      parallel laufende Applikation verwenden; so sparen Sie unter MagiC
      einen der raren Accessory-Slots. Beachten Sie aber, da der Aufruf des
      Programmes dadurch etwas komplizierter wird: Sie bentigen nmlich eine
      Software, die logbuch.app mit einer VA_START-Meldung aufweckt.
      Konfigurieren Sie dazu Ihren Desktop so, da er Logbuch diese Meldung
      schickt. Unter Gemini selektieren Sie dazu das Programmicon von
      logbuch.app und whlen im Dialog Anwendungen des Mens Extras die Option
      "Versteht VA_START" an. Bei Thing machen Sie das gleiche im Dialog
      Applikationen des Mens Extra, und zwar auf der Karteikarte Optionen.
      Danach ruft ein Doppelklick auf das Programmicon das Popup-Men des
      bereits laufenden Logbuchs auf.          
      
(3)   Das CPX-Modul logbuch.cpx kopieren Sie in den Suchpfad ihres
      Kontrollfeldes.
      
(4)   Stellen Sie sicher, da folgende Environmentvariablen korrekt gesetzt
      sind:
      
      AVSERVER mu den Namen des Desktops enthalten (z. B. "THING" oder
      "GEMINI").
      
      HOME sollte ein Verzeichnis angeben, in dem Logbuch die Programmliste
      logbuch.his beim Shutdown abspeichern kann; ist HOME nicht gesetzt, so
      wird die Datei ins Wurzelverzeichnis des Bootlaufwerks geschrieben.
      
      Beispiel:
      Wir nehmen an, da Sie den Desktop Gemini benutzen und ihr
      Home-Verzeichnis c:\gemini2\user ist.
      
      Unter MagiC fgen Sie dann diese Zeilen in die magx.inf ein:
         #_ENV AVSERVER=GEMINI
         #_ENV HOME=c:\gemini2\user
      Fr N.AES tragen Sie stattdessen diese Befehle in die n_aes.cnf ein:
         export AVSERVER=GEMINI
         export HOME=c:\gemini2\user
      
(5)   Verwenden Sie MagiC, so stellen Sie bitte sicher, da das Programm
      xmen_mgr.prg installiert ist. Nhere Informationen dazu finden Sie im
      Handheft von MagiC.

6.  Bedienung
-------------
Nach Aufruf von logbuch.acc (oder von logbuch.app) whlen Sie einen Eintrag an
und veranlassen damit den Desktop, das gewnschte Programm zu starten. 

Im Applikationsmodus existiert ein zustzlicher Meneintrag Beenden.

Das war's.

7. Konfiguration
----------------
Logbuch.acc und logtsr.prg knnen mit dem beiliegenden logbuch.cpx
konfiguriert werden.

Das CPX-Modul enthlt drei Dialoge:

 Hauptdialog
 Bootparamter
 sofort wirksame Optionen

Zwischen diesen drei Dialogen knnen Sie mit dem Popupmen im oberen Drittel
des Kontrollfeldes umschalten.

Im Hauptdialog werden die in den anderen Dialogen vorgenommenen Einstellungen
gesichert, gesetzt oder verworfen. Beim Sichern mssen Sie in einem
Dateiselektor das logtsr.prg lokalisieren, in welchem die Einstellungen
abgespeichert werden. 

Darber hinaus besteht im Hauptdialog die Mglichkeit, die bestehende
Programmliste (im RAM und gegebenenfalls auf der Festplatte) zu lschen.

Der Bootparameter-Dialog behandelt Optionen, die erst nach einem erneuten
Start des Systems wirksam werden; sie haben also keinen Effekt, wenn das
Kontrollfeld geschlossen oder mit OK verlassen wird. Es ist vielmehr
erforderlich, diese Optionen im Hauptdialog abzuspeichern. Aus diesem Grund
werden zu den Bootparametern in Klammern die jeweiligen aktuellen
Einstellungen angegeben. 

Im einzelnen werden hier die maximale Anzahl der gemerkten Programme und die
StIc-Untersttzung (siehe dazu den Abschnitt "Ntzliche Software")
eingestellt.

Schlielich knnen im dritten Dialog sofort wirksame Optionen gesetzt werden:

  die Anzeige der Programme als kompletter Pfad, als Dateiname oder als
   AES-Prozename,
  die 3D-Darstellung des Popups (bei mindestens 16 Farben) und
  das Sichern der History auf der Festplatte. Ist hier "Liste sichern"
   aktiviert, so wird beim Shutdown die Datei logbuch.his im Verzeichnis $HOME
   angelegt.

8. Fehlermeldungen
------------------
Das logtsr.prg kann folgende Fehlermeldungen ausgeben:

  LogTSR can't be run from the AUTO folder!
   Sie haben logtsr.prg im AUTO-Ordner installiert; Sie mssen es aber, wie
   oben unter 5 beschrieben, nach den AES starten.
   

  LogTSR is already installed!
   Diese Meldung erscheint, wenn Sie logtsr.prg zweimal starten; der zweite
   Proze beendet sich dann sofort.

  Couldn't allocate memory!
   Offensichtlich haben Sie zuwenig Speicher. 
   Unter MagiC knnen Sie dem mglicherweise abhelfen, indem Sie die
   #_TSL-Zeile in der magx.inf auskommentieren.
   
Das logbuch.acc (logbuch.app) gibt diese Fehlermeldungen aus:

  Die AES untersttzen keine Popup-Mens! Logbuch terminiert daher!
   Offenbar verwenden Sie nicht MagiC >= 3 oder N.AES, oder Sie haben unter
   MagiC das XMEN_MGR.PRG nicht installiert (s. oben unter 5).
      
  Der residente Teil ist nicht installiert worden!
   Logbuch.acc konnte den von logtsr.prg angelegten Cookie nicht finden. Haben
   Sie logtsr.prg richtig installiert?
      
  Wo ist mein AV-Server? Haben Sie in der Environment-Variablen AVSERVER
   Ihren Desktop angemeldet?

  Warnung: Der AV-Server antwortet nicht. Logbuch sendet ihm trotzdem 
   Nachrichten.
   Das AV-Protokoll sieht einen anfnglichen Handshake zwischen Klient und 
   Server vor. Hier hat der Server auf die Anmeldung von Logbuch nicht 
   geantwortet. Logbuch ignoriert das und sendet ihm dennoch Nachrichten, 
   die er im schlimmsten Fall nicht zur Kenntnis nimmt.

  Der AV-Server meldet, da er das Programm nicht starten konnte.
   Mglicherweise haben Sie ein bereits gelschtes Programm starten wollen.

  Der AV-Server kann keine Programme via AV-Protokoll starten!
   Ihr AV-Server untersttzt die Message AV_STARTPROG nicht.

  Die Aktion wurde wegen Speichermangels abgebrochen!

Fehlermeldungen des CPX-Moduls:

  Ein Fehler beim Sichern ist aufgetreten!

  Der Logbuch-Cookie konnte nicht gefunden werden!
   berprfen Sie die Installation von logtsr.prg!

9. Ntzliche Software
---------------------
Logbuch untersttzt den Icon-Server StIc von John McLoud. Wenn Sie ihn
installieren, knnen im Popup von Logbuch zu den Programmnamen passende Icons
dargestellt werden (abhngig von der Einstellung in der CPX).

Sinnvoll erscheint es auch, logbuch.acc (oder logbuch.app) in "Start me up"
von Thomas Much als Eintrag anzumelden.

10. Kontakt
-----------
Wenn Sie Fehler gefunden haben oder uns einfach nur mit berschwenglichem Lob
berschtten wollen, knnen Sie uns unter folgenden EMail-Adressen erreichen:

   juergen_holtkamp@do.maus.ruhr.de (Mausnet: Jrgen Holtkamp @ DO)
   juergen.holtkamp@cww.de
   uwe.holtkamp@cww.de
   
11. Fr Programmierer
---------------------
Nehmen wir einmal an, da Sie zufllig an einem Desktop oder einem
Start-Button programmieren und die Programmliste des logtsr.prg direkt
untersttzen wollen. In diesem Fall haben Sie darauf vollen Zugriff ber den
Cookie "LOGB", der auf folgende Struktur zeigt:

typedef struct 
{
   WORD  numln, reserved1, reserved2, reserved3, reserved4, reserved5,
         reserved6;  
   char  **lnptr;
} HISTREC;

Lnptr zeigt auf ein Feld von maximal numln nullterminierten Strings, die die
Programmnamen mit vollem Pfad enthalten. Sind es weniger als numln Eintrge,
so endet die Liste mit einem Leerstring.

Die XBRA- und die Cookie-Kennung von logtsr.prg lauten "LOGB".
