                           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)
