Computer Club Elmshorn Atari PD/CCE_PD.iso/pc/0600/CCE_0616.ZIP/CCE_0616.PD/MASKERAD/MASKERAD.DOK

Text File | 1993-06-23 | 10KB | 181 lines

Dokumentation zu MASKERADE Programmversion 1.3 vom 22.06.93

Einleitung

MASKERADE ist ein Programm zur Bearbeitung von Disketten und Festplatten.
Eine spezielle Aufgabe von MASKERADE ist die Datei- und Textsuche. Maskerade
benutzt zur Dateisuche die BIOS Funktionen des Betriebssystems und ist deshalb
besonders schnell. Es besitzt eine GEM konforme Oberfläche und läuft auf Atari
Rechnern als Programm sowie als Accessory. Es ist auflösungsunabhängig pro-
grammiert. Die Ausgabe auf den Bildschirm erfolgt sauber über VDI Befehle.
Maskerade benutzt GDOS (falls vorhanden) und ermöglicht so die Arbeit mit
verschiedenen Fontarten und -größen. Die Dialoge von Maskerade sind ver-
schiebbar. Zu jeder Dialogbox ist eine Hilfestellung verfügbar.

Warnung

Maskerade greift auf BIOS Ebene auf die Sektoren von Datenträgern zu, um
deren Verzeichnisstruktur zu analysieren und zu bearbeiten. Dies bedeutet, das
hauptsächlich Zugriffe auf die FAT und die Directorys durchgeführt werden.
Unglücklicherweise sind diese beiden Strukturen auch die empfindlichsten auf
Datenträgern. Maskerade geht dabei sehr gewissenhaft vor und prüft z.B. bei
jedem Zugriff, ob die Daten im Speicher auch noch mit denen der Diskette
übereinstimmen (Bei media change: Bit-Vergleich der kompletten 1.FAT u.a.).
Insbesondere, wenn mit zweifelhaften Datenträgern gearbeitet wird und Fehler
auftreten, kann ein Verlust von Daten nicht 100%-ig ausgeschlossen werden.
Dafür übernehme ich keine Verantwortung! Erstellen Sie vor der Änderung des
Mediums eine Sicherheitskopie! Dies sollten Sie besonders bei der Benutzung
des Menüpunktes CHKDISK beherzigen. Benutzen Sie Maskerade nur bei normalen
Dateisystemen mit 12- oder 16bit FAT. Die Dateiattribute schreibgeschützt,
versteckt und Systemdatei spielen für Maskerade keine Rolle! Sollten Sie ein
externes Programm starten und Dateien ändern müssen Sie die Verzeichnisstruktur
wieder einlesen (Laufwerkszeile selektieren und 'U' drücken)!
Auf keinen Fall mit dem alten Fensterinhalt weitermachen (geht im Normalfall
durch eine Warnung auch nicht).

Die Speicherverwaltung

Maskerade kennt 3 Arten der Speicherverwalung:
1. Dynamisch bei normalem Programmstart
2. Dynamisch bei Start als Accessory
3. Statisch
Dynamisch bedeutet dabei, das Speicher vom Betriebssystem dann angefordert
wird, wenn er gerade benötigt wird. Statisch fordert bei Programmstart einen
Speicherbereich fester Größe vom Betriebssystem an und verwaltet diesen
Speicher selbst und effizienter als das Betriebssystem. Da Maskerade gerade-
zu mit Speicheranforderungen und -freigaben um sich schmeist, empfehle ich
die statische Speicherverwaltung, auch wenn der reservierte Speicher für an-
dere Programme nicht mehr zur Verfügung steht. GEMDOS benutzt zur Orga-
nisation des Speichers eine statische Struktur und nicht selten bekommt man
die Meldung: "Out of internal memory. System halted... use ADDMEM.PRG"
zu Gesicht. Auf jeden Fall können Sie sich das Ereignis anschauen, wenn sie
bei dynamischer Speicherverwaltung ihre Festplattenpartitionen der 128 MB
Platte einlesen. Nun möchte ich etwas zu dem wichtigsten Punkt der Spei-
cherverwaltung von Maskerade sagen, die dynamische Speicherverwaltung von
Accessorys. Normalerweise sind Accessorys nicht in der Lage nach der Initia-
lisierung weiteren Speicher dynamisch anzufordern. Der Grund dafür ist, daß
der angeforderte Speicher bedingt durch einen Denkfehler der Betriebssystem-
bauer immer der gerade laufenden Applikation gehört. Accessorys haben sie
glattweg vergessen. Sie besitzen keine vollständige Basepage und haben auch
keinen Prozessdeskriptor. Das Accessory ist für GEMDOS also der gleiche
Prozeß wie das gerade laufende Programm. Beenden sie dieses Programm,
dann gehen auch alle angeforderten Speicherblöcke unseres ACC verloren und
dieses weis nichts von seinem Pech. Normale Accessorys können aus eben
diesen Gründen auch keine Programme starten. Maskerade benutzt nun einige
nicht dokumentierte Tricks und überlistet das halbe Betriebssystem und kann
deshalb externe Programme starten und Speicher anfordern, wie eine richtige
Applikation. Dies funktioniert jedoch erst nach Beendigung eines Autostart-
programms (ab TOS 1.4.) und wird mit Garantie nicht mehr bei MULTITOS
und eventuellen neuen Betriebssystemen funktionieren. Außerdem sollten die
gestarteten Programme in Fenstern laufen und keine globale Menüzeile instal-
lieren. Auch ihre wind_updates sollten ordnungsgemäß funktionieren. Das be-
ste, was mir passiert ist: Innerhalb einer Dialogbox! zum Formatieren von
Disk A konnte ich die Menüleiste des Desktop anwählen und habe lustigerwei-
se versucht Disk B ebenfalls zu formatieren. Ich habe nur ein Laufwerk...-
aber mein ST geht noch. Die Einstellung der Speicherverwaltung nimmt man
in der SETUP Dialogbox vor: Geben sie für die statische Speichergröße einen
negativen Wert an, dann bedeutet das, daß der gesamte Speicher abzüglich
dieser Größe reserviert wird. Wissen sie schon welchen Wert sie beim Start
als ACC verwenden müssen? Die Einstellung wird logischerweise erst beim
nächsten Programmstart aktiv und sollte abgespeichert werden (AUTO.CFG im
Verzeichnis von MASKERAD.PRG (*.ACC)).

Programmbedienung

Ich werde hier nur solche Dinge erwähnen, die nicht mit HELP zu erreichen sind.
Die Umschaltung der Funktionstastenleiste erfolgt mit der SHIFT oder mit der
ALTERNATE Taste. Auf der ALTERNATE-Tastenleiste befinden sich die kri-
tischen Funktionen KILL und FORMAT. Der Formatdialog ist nur eine
Schnittstelle zur Betriebssystem-Funktion Flopfmt(), also keine eigene Routine
mit Abfrage nicht erlaubter Parameter!
Die Tastenkombination SHIFT-SHIFT dient zum vorzeitigen, kontrollierten
Abbrechen von Funktionen (Die RESET-Taste dient zum Abbrechen von Funktionen).
Die Funktionen LOAD bzw. SAVE dienen zum Laden/Sichern des Fensterin-
haltes samt Einstellung der Konfiguration und eingelesener Verzeichnisstruktu-
ren. Beim Einlesen im FINDFILE-Dialog wird immer die gesammte Verzeich-
nisstruktur eingelesen, egal was Sie als Maske oder anderen Einschränkungen
angegeben haben. Dies wird erst bei der Aktivierung des Button "Suchen" be-
rücksichtigt.
Ein COPY oder MOVE hat als Ziel immer den im FINDFILE-Dialog angebenen Pfad,
egal wo die Quelldatei sich befindet. Der Pfad wird eventuell automatisch
angelegt. Die Dateien werden auch umbenannt: z.B. COPYPFAD = "C:\KOPIE\*.BAK"
-> alle Extensionen in BAK umbenennen. Möglich sind auch:
"*", "*.*", "NAME.*" oder "NAME.EXT" nicht jedoch solche Sachen wie:
"NAME*.*" (wie auch).
Hören Sie beim Programmstart einen ASCII(7)-Pling, dann konnte Maskerade
den abgespeicherten GDOS Font nicht finden und wählt deshalb den immer
verfügbaren Systemfont.
Die Klemmbrettausgabe (Taste CLIPBRD) erfolgt in den Formaten
SCRAP.TXT (ASCII Text), SCRAP.CSV (durch Komma getrennte Werte) und
SCRAP.GEM (Metafile). Metafile nur bei Verwendung von GDOS und gelade-
nem META.SYS Treiber. META.SYS ist PD (zumindest meins) und befindet
sich mit auf der Maskerade-Diskette.

Der Aufbau der SCRAP.CSV Datei

Für den Import in Datenbanken oder Tabellenkalkulationen:

Bezeichnung   Datentyp    max.Größe (Zeichen)
Diskette      CHAR        1
Nummer        UWORD       5
Info          STRING      79
Freier Platz  ULONG       10
Pfad          STRING      127
Dateiname     STRING      12
Länge         ULONG       10
Zeit          WORD        6
Zeit          STRING      8
Datum         WORD        6
Datum         STRING      10
Attribut      UBYTE       3
Attribut      STRING      6
Startcluster  UWORD       5

Die Selektion von Zeilen

Mit Hilfe der Maus oder speziellen Tastenkombinationen lassen sich komforta-
bel Objekte im Arbeitsfenster anwählen. Sie können mit der linken Maustaste
Objekte so ähnlich, wie Sie es vom GEM Desktop gewohnt sind, selektieren.
Ein einfacher Mausklick selektiert das Objekt. Halten sie die Maustaste ge-
drückt, können Sie mit dem Gummiband mehrere zusammenhängende Objekte
selektieren. Halten Sie die SHIFT-Taste gedrückt dann gehen bereits selek-
tierte Objekte nicht verloren. Das Drücken der CONTROL-Taste bewirkt, das
nur Objekte selektiert werden, die Dateien darstellen, also keine Laufwerks-,
Ordner- oder Textzeilen sind. Das Drücken der ALTERNATE-taste bewirkt,
das die angewählten Objekte gefaltet werden. Das bedeutet im einzelnen:
Laufwerkszeile - Alle Ordner-, Datei- und Textzeilen dieses Laufwerkes ver-
schwinden in der Anzeige.
Ordnerzeile - Alle Dateien- und Textzeilen die sich in dem Ordner befinden
verschwinden.
Dateizeile oder Textzeile - Alle Textzeilen dieser Datei verschwinden.
Gefaltete Zeilen werden fett dargestellt und können mit einem nochmaligen
Mausklick bei gedrückter ALTERNATE-Taste wieder entfaltet werden. Die
Tasten SHIFT, CONTROL und ALTERNATE können auch kombiniert ange-
wendet werden. Zwei Tasten haben eine spezielle Bedeutung: ESC - deselek-
tiert alle Objekte, und 'A' selektiert alle Objekte (CONTROL A bedeutet also
- selektiere alle Dateien). Wenn sie mit der Maus klicken, müssen Sie unter-
scheiden, ob Sie auf den Text in der Zeile oder auf den Verzeichnisbaum klik-
ken. Ein Klick auf die Zweige des Baumes selektiert alle Objekte, die an dem
Ast dieses Zweiges hängen. Ein Klick auf einen Ast selektiert alle Objekte,
die zu diesem Ast gehören. Auch dabei bleibt die Bedeutung der Tasten
SHIFT, CONTROL und ALTERNATE bestehen. Klicken Sie mit der Maus auf
eine selektierte Zeile und ist dies die einzige selektierte Zeile, dann Öffnen
sie die Datei, wenn es sich um eine Dateizeile gehandelt hat, bzw. starten das
Editorprogramm, wenn es sich um eine Textzeile gehandelt hat. Das Öffnen
einer Datei erfolgt dabei so, wie Sie es im GEM Desktop angemeldet haben,
bzw. es startet das Editorprogramm mit dieser Datei als Anwendung, wenn Sie
dabei die SHIFT-Taste gedrückt halten.. Beim Starten des Editors kann zu-
sätzlich noch die Zeilennummer, und wenn sich in der Textzeile ein fett dar-
gestellter Suchausdruck befindet, die Spaltennummer, so wie Sie es im SE-
TUP-Dialog eingestellt haben, übergeben werden. Die Zählung der Zeilen be-
ginnt dabei bei 1, die der Spalten bei 0.



Hier nochmal meine Anschrift:
Gerald Fiedler
Pappelstraße 13
O-8270 Coswig

Coswig, den 21.04.93