                           Die Anleitung zu

                               APP_LIST

                                 0.4
                            7. April 1995

                                 von

                           Ralf Zimmermann
                            Am Ruhwehr 35
                          D-65207 Wiesbaden

                        Ralf Zimmermann @ OF2



Inhaltsverzeichnis
==================

 1 Motivation

 2 Die Anzeige im Fenster

 3 Popup-Menu 'Allgemein'

 4 Popup-Menu 'Programm'

 5 Die Parameter-Datei

 6 Iconifizierung

 7 Wo wird die INF-Datei gesucht?

 8 Copyright

Anhang

A Das Format von APP_LIST.INF
B Bezugsquellen



1 Motivation
============

Das Programm ist nur unter Mag!X bzw. MultiTOS sinnvoll einsetzbar.
Getestet wurde es bei mir unter Mag!X und MultiTos. Einige der neuen
Features laufen nur unter Mag!X, da ich MultiTOS fast nie benutze.

Nachdem ich einige Monate lang Mag!X benutzt habe, kam es immer wieder
vor, da ich den Rechner ausgeschaltet habe, obwohl gerade noch eine
Applikation lief, das dadurch eventuell Daten verlor.

Nur, weil gerade kein Fenster mehr offen ist, heit es noch lange
nicht, da keine Applikation mehr luft.

Da ich nichts anderes finden konnte, habe ich mich hingesetzt und
selbst ein Programm geschrieben, das mir immer anzeigt, welche
Applikationen gerade laufen.

Falls man den UFSL (Ultimate Font Selector) im AUTO-Ordner hat, kann
man den verwendeten GDOS-Font auswhlen.



2 Die Anzeige im Fenster
========================

Im Fenster wird eine Info ber den freien Hauptspeicher, die Anzahl
der laufenden Applikationen und die Liste der Applikationen angezeigt.
Ab Version 0.3 wird der Speicher getrennt nach ST- und TT-RAM
angezeigt. Falls alle Applikationen angezeigt werden, so sind die als
IGNORE gekennzeichneten Applikationen normal geschrieben, die
restlichen Eintrge sind fett, damit sie sich hervorheben. Damit hat
man eine schnelle bersicht ber die Applikationen.

Was wird zu den einzelnen Applikationen angezeigt?

    Der Name

    Der Typ der Applikation (APPlikation/ACCessorie/SYStem)
     (Diese Angabe kann ausgeblendet werden)

    Die ID der Applikation (Diese Angabe kann ausgeblendet werden)

    Die Menge des benutzten Speichers
     (nur falls das Betriebssystem das Verzeichnis U:\PROC\ existiert)

Unter Mint und MagiC 3.0 existiert das Laufwerk U:, welches unter
anderem den Ordner PROC enthlt. APP_LIST ermittelt zur Zeit auf diese
Weise den Speicherbedarf der Applikationen.



3 Popup-Menu 'Allgemein'
========================

Indem man auf den oberen Teil des Fensters klickt, erhlt man einen
Popup-Dialog mit den mglichen Optionen. Ab Version 0,.2 hat das
Programm keine eigene Menuzeile mehr, das war nicht sehr praktisch!

    ber APP_LIST...
     Eine kurze Info ber das Programm.

    Zeichensatz...
     Es wird der UFSL aufgerufen, um den neuen Font fr die Anzeige
     auszuwhlen.

    Parameter sichern
     Hier werden die aktuellen Parameter in die Datei APP_LIST.INF
     gesichert.

    Ausblenden/Alle Anzeigen
     Hier kann man umschalten, ob alle Prozesse angezeigt werden
     sollen, oder nur diejenigen, die nicht als IGNORE gekennzeichnet
     sind.

    Screen aufrumen
     Unter MagiC! wird ein kompletter Bildschirm-Redraw ausgelst.

    Mover entfernen/aktivieren
     Man kann das Fenster von APP_LIST ohne Rahmenelemente verwenden.
     Dies wird ber diesen Punkt gesteuert. Man kann das Fenster ohne
     die Titelzeile zwar nicht mehr bewegen, aber es wird kleiner!
     (Ich benutze dieses Feature zwar nicht, aber es wurde gewnscht!)

    Typ ausblenden/anzeigen
     Hiermit kann konfiguriert werden, ob in der Anzeige eine Spalte
     fr den Programmtyp angezeigt werden soll.

    Id ausblenden/anzeigen
     Hiermit kann konfiguriert werden, ob in der Anzeige eine Spalte
     fr die Programm-Id angezeigt werden soll.



4 Popup-Menu 'Programm'
=======================

Klickt man auf einen Programm-Eintrag, so erhlt man das Popup-Menu
fr das Programm. Dies sind zur Zeit folgende Aktionen:

    Aktivieren
     Der Screenmanager von Mag!X wird beauftragt, den Prozess zu
     aktivieren. Leider betrifft dies wohl nur die Menuzeile, nicht
     die Fenster. Falls der Prozess ein ACC ist, wird ihm die
     Nachricht VA_START geschickt. Das sollte das ACC veranlassen,
     sein Fenster zu ffnen oder nach vorne zu bringen.

    Beenden
     Dem Prozess wird die Nachricht AP_TERM geschickt. Das Programm
     sollte sich dann selbst beenden.

    Lschen
     Nach einer Sicherheitsabfrage wird Mag!X beauftragt, diesen
     Prozess aus dem Speicher zu entfernen.
     Das Programm wird NICHT ordnungsgem beendet!



5 Die Parameter-Datei
=====================

Das Programm sucht beim Start die Datei APP_LIST.INF, worin ein paar
Einstellungen gespeichert werden knnen. Die Eintrge sind zeilenweise
angeordnet.

Die IGNORE-Eintrge sollten per ASCII-Editor an die eigene
Konfiguration angepast werden. Der restlichen Eintrge werden vom
Programm selbst erzeugt, wenn man im Popup-Menu 'Parameter sichern'
auswhlt. Hier ist ein kurzes Beispiel fr die Syntax:

# IGNORE
#   Mittels dem Ignore-Eintrag kann man die Namen von Applikationen
#   angeben, die nicht in der Liste erscheinen sollen.
#   Ich finde es ist etwas bersichtlicher, wenn die Standard-
#   Programme wie z.B. der Desktop oder Accessories nicht in der
#   Liste erscheinen.
#   Zur Zeit sind 20 Eintrge in der Liste erlaubt. Immer nur ein Name
#   pro Zeile!
IGNORE = GEMINI
IGNORE = ST-GUIDE

Fr weitere Informationen lesen Sie bitte
'Das Format von APP_LIST.INF' im Anhang.



6 Iconifizierung
================

Unter Iconifizierung versteht man die Verkleinerung eines normalen
GEM-Fensters auf minimale Gre. Das Fenster ist dann sehr klein und
zeigt nur noch ein Symbol an, nicht mehr den echten Inhalt. Besonders
bei vielen offenen Fenstern ist es sehr angenehm, die geffneten
Fenster eines Programms vorbergehend 'aus dem Weg zu schaffen'.

APP_LIST beherscht zwei verschiedene Arten des Iconify:

    MultiTOS-Iconify

     Unter MultiTOS wird rechts oben im Fenstertitel eine
     Iconify-Knopf angezeigt. Klickt man darauf, so wird das Fenster
     zu einem Icon verkleinert.

    ICFS-Iconify

     Falls kein MultiTOS mit Iconify-Mglichkeiten gefunden wird und
     der Iconify-Server (ICFS) vorhanden ist, so wird das Iconify per
     ICFS untersttzt. Wenn man den Schlie-Knopf des Fensters
     bettigt und gleichzeitig eine der Tasten

     -  Control

     -  Shift

     -  Alternate

     gedrckt hlt, so wird das Fenster zu einem Icon verkleinert.

Das Iconifizieren kann man auch per Tastatur mittels
Control-Alternate-Leertaste erreichen. Also einfach die Control- und
die Alternate-Taste gedrckt halten und dann die Leertaste bettigen.



7 Wo wird die INF-Datei gesucht?
================================

APP_LIST sucht seine INF-Datei mit den Voreinstellungen der
Reihenfolge nach mit folgenden Methoden:

  1. Im AES-Environment, per shel_envrn(), wird nach der Variablen
     HOME gesucht.

  2. Das beim Programmstart bergebene Environment wird nach der
     Variablen HOME abgesucht.

  3. Mittels shel_read() wird versucht den Startpfad zu ermitteln.

  4. In argv[0] wird nach dem Startpfad gesucht.

  5. Auf dem Wurzelverzeichnis des Bootlaufwerks, welches mittels
     _bootdev ermittelt wird. blicherweise also C:\.

Sobald eine der Methoden einen Pfad liefert, so wird er zum Laden und
Speichern der INF-Datei verwendet.

Es wird empfohlen, die HOME-Variable zu benutzen. In Zukunft werden
hoffentlich immer mehr Programme dieses Verfahren benutzen.



8 Copyright
===========

Das Programm ist Freeware, d.h. man darf es fr den privaten Gebrauch
frei kopieren. Wenn jemand Geld daran verdient, dann bitte der Autor!
Wer mir also etwas spenden mchte, dem sei gesagt ich kann das Geld
gut gebrauchen!

Der Autor:

   Ralf Zimmermann
   Am  Ruhwehr  35
   65207 Wiesbaden

   MausNet     :  Ralf Zimmermann @ OF2
	internet    :  ralf_zimmermann@of2.maus.de
   PacketRadio :  DL1FDT@DB0GV

   Bankverbindung:
   Naspa Wiesbaden
   BLZ  510 500 15
   Kto 1010 299 72




A Das Format von APP_LIST.INF
=============================

Die Eintrge sind zeilenweise angeordnet, bisher gibt es folgende
Eintrge:

# WINDOW
#   Hier werden die x- und die y-Koordinate des Fensters gespeichert,
#   und zwar in einem Bildschirm-unabhngigen Format. (0-32767)
WINDOW = 24563;21753
#
# FONT
#   Hier kann man die Id und die Gre des gewnschten Fonts
#   eintragen. Falls man den UFSL beutzt kann diese Angabe von
#   APP_LIST selbst geschrieben werden.
FONT = 97;10
#
# IGNORE
#   Mittels dem Ignore-Eintrag kann man die Namen von Applikationen
#   angeben, die nicht in der Liste erscheinen sollen.
#   Ich finde es ist etwas bersichtlicher, wenn die Standard-
#   Programme wie z.B. der Desktop oder Accessories nicht in der
#   Liste erscheinen.
#   Zur Zeit sind 20 Eintrge in der Liste erlaubt. Immer nur ein Name
#   pro Zeile!
IGNORE = GEMINI
IGNORE = ST-GUIDE
#
# DISPLAY_IGNORE
#   Hier wird bestimmt, ob die unter IGNORE angegebenen Applikationen
#   angezeigt werden sollen oder nicht.
DISPLAY_IGNORE = TRUE
#
# DISPLAY_MOVER
#   Hier wird bestimmt, ob das dargestellte Fenster einen
#   Verschiebebalken haben soll oder nicht. Man spart etwas Platz
#   auf dem Bildschirm, wenn man den Mover entfernt.
DISPLAY_MOVER = TRUE
#
# DISPLAY_TYP
#   Hier wird bestimmt, ob zu den Applikationen der Programmtyp
#   angegeben werden soll.
DISPLAY_TYP = TRUE
#
# DISPLAY_ID
#   Hier wird bestimmt, ob zu den Applikationen die Programm-ID
#   angegeben werden soll.
DISPLAY_ID = TRUE

Die IGNORE-Eintrge sollten per ASCII-Editor an die eigene
Konfiguration angepast werden. Der restlichen Eintrge werden vom
Programm selbst erzeugt, wenn man im Popup-Menu 'Parameter sichern'
auswhlt.



B Bezugsquellen
===============

Die jeweils aktuelle Version des Programms ist beim Autor gegen
Einsendung einer formatierten Diskette sowie eines frankierten und
adressierten Rckumschlags erhltlich.

Besitzer eines Modems finden die aktuelle Version dieses Programms in
der Maus Offenbach 2:

    Maus OF2: 06103-928316

Der Archivname lautet jeweils APP_LIST.LZH.

Auf jeweils neue Versionen wird in der MausNet-Gruppe "ATARI.NEWS"
hingewiesen.


-eof-  (UDO Rel. 2)
