Niederkassel, den 1.11.93 CatPutz V 2.20 (c) 1991, 1992, 1993 Dirk Steins 0. VORWORT ========== CatPutz ist Bestandteil des CAT-Maustausch-Paketes fr den Atari ST/TT. Diese Anleitung ist nur eine kurze Zusammenfassung, die richtige Anleitung befindet sich bei der Anleitung zu CAT 2.0 bzw. CAT 2.5. Da dieses Dokument nur eine leicht ge„nderte Fassung der Anleitung zu CatPutz 1.1 ist, kann es sein, daž noch Hinweise auf alte Versionen in dieser Anleitung sind. In dem Fall sollten diese Sachen ignoriert werden, und in der richtigen Anleitung nachgeschlagen werden. Die Anleitung zu CAT 2.0x und CatPutz gibt es brigens inzwischen auch in gedruckter Form zu kaufen (fr nur 10,- DM). Diese kann man bei Johannes Goettker-Schnetmann @ MS bestellen. CatPutz l„uft nur mit CAT-Versionen > 2.0, da alte Versionen ein anderes Format in der Messagebase haben. Wer CatPutz mit einer CAT-Version < 2.0 benutzt,ist selber schuld, wenn danach seine Daten zerst”rt sind! Es gibt keine M”glichkeit fr mich, festzustellen, von welcher Version die Database ist. Und jetzt nochmal in aller Deutlichkeit: WER CATPUTZ 2.20 MIT CAT 1.21 BENUTZT, VERLIERT SEINE KOMPLETTE MESSAGEBASE! DIESE IST DANACH IRREPARABEL BESCHŽDIGT! CatPutz 2.20 l„uft auch mit CAT-Versionen < 2.5, aber da CatPutz dann Dateien anlegt, die eigentlich von CAT 2.5 angelegt und gepflegt werden sollen, sollte man nach dem L”schen zwei Dateien im Database-Ordner l”schen, da man sonst eventuell Dateninkonsistenzen erh„lt. Diese Dateien sind CATGROUP.INF und CATGROUP.DAT. Besser ist es aber, CatPutz 2.20 nur mit CAT 2.5 zu verwenden. Ich, Dirk Steins, kann keine Haftung fr irgendwelche direkten oder indirekten Sch„den (einschliežlich aber nicht beschr„nkt auf materielle oder finanzielle Sch„den) bernehmen, die durch die Benutzung von CatPutz oder die Untauglichkeit von CatPutz fr einen bestimmten Zweck entstehen. Es ist leider nicht m”glich, fehlerfreie Programme zu schreiben, aber ich hoffe, daž in CatPutz keine schwerwiegenden Fehler mehr enthalten sind. Falls doch noch Fehler enthalten sind, bitte ich darum, diese per E-Mail an mich zu schicken. Die Adresse steht am Ende dieses Manuals. 1. EINLEITUNG ============= CatPutz ist das externe L”schprogramm fr CAT. Ab CAT 2.0 gibt es in CAT selber gar keine M”glichkeit mehr, Nachrichten zu l”schen. Dafr ist CatPutz erstellt worden. CAT kann fr jede Message einen Haufen Flags setzen, was mit der Message geschehen soll, und diese Flags werden von CatPutz ausgewertet. Genaugenommen kann CatPutz 6 von den vorhandenen 9 Flags beachten. Dies ist teilweise einstellbar, welche Flags beachtet werden sollen. Eine weitere Erl„uterung der Flags finden Sie unter 4. Flags. Dieses Kapitel ber die Flags ist sehr wichtig, bitte lesen sie es sich deshalb ausfhrlich durch! 2. INSTALLATION =============== Die Installation von CatPutz ist sehr einfach und fr einen erfahrenen CAT- Benutzer berhaupt kein Problem. Kopieren Sie einfach die Dateien CATPUTZ.PRG und CATPUTZ.RSC in das Verzeichnis, in dem sich auch CAT und die Datei CAT.INF befinden. CatPutz braucht davon nur die Datei CAT.INF, aber CAT steht meistens in dem gleichen Verzeichnis. Ohne die Datei CAT.INF kann CatPutz nicht laufen. Alternativ kann man auch eine CAT.INF Datei als Parameter an CatPutz bergeben. 3. BEDIENUNG ============ CatPutz ist ein ganz normales GEM-Programm. Die Bedienung erfolgt mit der Maus ber die Menuleiste und Dialoge oder ber die Tastatur. Die Dialoge sind alle (fast) komplett tastaturbedienbar (an dieser Stelle sei Peter Hellinger ein Dank ausgesprochen fr seine MagicDials). Es existieren 3 Menus: CatPutz, Datei, Optionen. Im folgenden werden jetzt die Menupunkte erl„utert, die unter den einzelnen Menus stehen (keine Angst, es sind nicht viele :-) CatPutz: Unter diesem Menu steht das bliche 'šber Catputz...' und die Desk-Accessories. Bei Anwahl des Punktes 'ber CatPutz...' erscheint eine Dialogbox, in der Sie das Copyright von CatPutz sehen. šber den 'Info'-Button in diesem Dialog kommen Sie zu einer weiteren Dialogbox mit weiteren Informationen, ber den 'Ok'-Button verlassen Sie den Dialog. Datei: In diesem Menu finden Sie sechs Menueintr„ge - L”schen: Wenn Sie diesen Menupunkt anw„hlen, kommen Sie in den wichtigsten Teil von CatPutz, den Dialog zum L”schen von Nachrichten. In diesem Dialog w„hlen Sie die Gruppen aus, in denen Sie Nachrichten l”schen wollen. Eine Gruppe, in der Sie Nachrichten l”schen wollen, selektieren Sie durch einen einfachen Klick auf den Namen der Gruppe in der Gruppenliste. Wenn Sie die Gruppe wieder deselektieren wollen, dann klicken Sie einfach noch einmal auf die Gruppe. Selektierte Gruppen werden invertiert dargestellt. In der Liste bewegen Sie sich ber den seitlichen Scrollbalken oder die Scrollpfeile. Es ist auch m”glich, sich ber die Cursortasten in der Liste zu bewegen und auch Gruppen zu selektieren. Mit Cursor hoch bzw. runter bewegen Sie einen Cursor in der Liste auf und ab und k”nnen damit Gruppen selektieren bzw. deselektieren. Mit Shift-Cursor k”nnen sie seitenweise bl„ttern. Mit Ctrl-Cursor wird die Liste gescrollt (entspricht einem Klick auf die Pfeil-Buttons). Mit Home gehen Sie an den Anfang der Liste, mit Shift-Home an das Ende der Liste. Die Gruppen werden sortiert angezeigt. Fr die pers”nliche Gruppe ist ein Schalter unterhalb der Liste vorhanden, damit nicht versehentlich auch in dieser gel”scht wird. Weiterhin sind noch 4 Buttons in diesem Dialog enthalten: Alle Gruppen, Keine Gruppe, Abbruch, L”schen. šber 'Alle Gruppen' werden alle Gruppen selektiert, ber 'keine Gruppe' werden alle Gruppen deselektiert. Dies betrifft nicht mehr die Gruppe mit den pers”nlichen Nachrichten, diese wird jetzt unter der Liste separat dargestellt und muž explizit ein- oder ausgeschaltet werden. šber 'Abbruch' wird der Dialog verlassen, ohne daž irgendetwas gel”scht wird, ber 'L”schen' wird der L”schvorgang gestartet. W„hrend des L”schens erscheint eine Dialogbox auf dem Bildschirm, die den aktuellen L”schstatus anzeigt (Gruppe und wieweit man in der Gruppe ist). Sie k”nnen das L”schen dort jederzeit durch das Drcken von ESC abbrechen. - Gruppe l”schen: Sie k”nnen hier eine Gruppe ausw„hlen, die komplett gel”scht werden soll. Vor dem L”schen erscheint noch eine Sicherheits- abfrage, ob sie die Gruppe wirklich l”schen wollen. - Statistik zeigen: Es wird ein Fenster ge”ffnet, in dem eine Statistik ber die vorhandenen Daten in der Datenbasis von CAT erscheint. Wenn in einer Gruppe Daten gel”scht wurden, so wird auch angezeigt, wieviel gel”scht wurde und wieviele Nachrichten und kB jetzt noch in der Gruppe sind. - Fenster schliežen: Wenn das Statistikfenster ge”ffnet ist, k”nnen Sie auch ber diesen Menupunkt das Fenster wieder schliežen. - Sichern als: Die angezeigte Statistik kann in eine Textdatei geschrieben werden. Sie w„hlen dann ber die Fileselect-Box eine Datei aus, in die die Daten geschrieben werden sollen. Im Anschluž daran steht dann in dieser Datei die L”schstatistik so, wie sie auch im Fenster erscheint (bis auf den Zeichensatz). - Auf Clipboard: Die angezeigte Statistik wird als SCRAP.TXT und SCRAP.CSV auf das GEM-Clipboard geschrieben. - CAT.INF laden: Mit diesem Menupunkt k”nnen Sie nachtr„glich eine andere CAT.INF-Datei laden, um zum Beispiel in einer anderen Datenbank zu l”schen. - Einstellungen sichern: Die unter 'Einstellungen' (im Optionen-Menu) vor- genommenen Einstellungen und die Fensterdaten (Gr”že und Zeichensatz) werden in die Datei 'CATPUTZ.INF' gesichert. Beim n„chsten Start von CatPutz wird diese Datei automatisch eingelesen und die gesicherten Einstellungen werden bernommen. - Beenden: Bei Anwahl dieses Menupunktes wird CatPutz beendet. Es erfolgt keine Sicherheitsabfrage, ob Sie sich auch wirklich sicher sind,daž Sie CatPutz verlassen wollen (Sind Sie sicher, daž Sie CatPutz beenden wollen? Ja! Sind sie sich wirklich sicher, daž Sie nichts mehr l”schen wollen? JAAA!!!! ...ich hasse diese dummen Sicherheitsabfragen!) Optionen: Unter diesem Menu finden Sie drei Eintr„ge, n„mlich 'Flags...', 'Einstellungen...' und 'Zeichensatz...'. - Flags: Wenn Sie diesen Punkt anw„hlen, erscheint ein Dialog, in dem Sie ein paar zus„tzliche Einstellungen fr das L”schen vornehmen k”nnen. Sie k”nnen dort fr drei Flags und ein 'Pseudo-Flag' einstellen, wie Nachrichten mit diesen Flags behandelt werden sollen. Das ist alles recht flexibel und daher auch kompliziert, deshalb verweise ich an dieser Stelle auf das nachfolgende Kapitel 4., in dem die Flags ausfhrlich besprochen werden. Zus„tzlich k”nnen Sie auch noch ein Datum eingeben, bis zu dem maximal gel”scht werden soll und ob dieses Datum beachtet werden soll. Das Datum kann ein relativ beliebiger String sein, die Datumseingabe ist die gleiche wie in CAT oder auch der Maus. Dieses Datum beschr„nkt das L”schen nur auf die in CatPutz besonders behandelbaren Flags, aber nicht beim L”schen mit den Flags 'Totall”schung' und 'Teill”schung'. Nachrichten, die eines dieser Flags gesetzt haben, werden immer gel”scht, unabh„ngig von der Einstellung des Datums. WICHTIG: Auch ist es nicht m”glich, nur durch Eingabe eines Datums etwas zu l”schen, das Datum wirkt nur als Begrenzung fr die einstellbaren Flags, aber nicht als Begrenzung fr die in CAT vergebenen Flags Totall”schung und Teill”schung. Am besten bringe ich mal ein Beispiel fr gltige Daten: Nehmen wir mal an, heute ist der 8.4.1991. Dann sind z.B. folgende Eingaben gltig: Nur Tagesangabe: 1 oder 1. - dies bedeutet den ersten des aktuellen Monats, also den 1.4.91. Statt der 1 darf natrlich eine beliebige andere Zahl verwendet werden (also auch die 2). Tages- und Monatsangabe: 1.3 oder 1.3. - dies bedeutet den halt den 1.3. dieses Jahres,also den 1.3.91. Ansonsten gilt das gleiche wie vorher, also es sind auch andere Zahlen als 1 oder 3 m”glich. komplette Datumsangabe: 1.3.90 - Naja, das ist halt der 1.3.1990. Fhrende Nullen mssen nicht eingegeben werden (ddrfen aber), ebenso ist der Trenner relativ egal, es k”nnte dort auch 1:3:90 stehen, das Datum w„re das gleiche. Auch ein Datum der Form 010390 ist gltig, da nicht mehr als 2 Stellen fr einen Tag oder Monat ausgewertet werden. negative Tagesangabe: -4 - Dies ist eine relative Datumsangabe bezogen auf das aktuelle Tagesdatum. Es werden vom Tagesdatum 4 Tage abgezogen, also g„be das heute den 4.4.91. Natrlich funktioniert diese Zurckberechnung auch ber Monats- und Jahresgrenzen hinweg. Auch Schaltjahre werden korrekt behandelt, also ergibt in Schaltjahren ein -1 am 1.3. den 29.2, in normalen Jahren aber den 28.2. Sie sehen also, die Datumseingabe ist sehr flexibel, da sollte eigentlich fr jeden ein brauchbares Format bei sein (Nein, ich baue kein engliches Datum ein). Ungltige Daten werden ber eine Alarmbox bekanntgegeben, also wenn z.B. jemand irgendwas mit dem 13. Monat oder so eingibt, dann gibt es einen auf den Deckel. Auch den 29.2.91 gibt es nicht, braucht ihr gar nicht erst versuchen. Wenn Sie den L”schvorgang mit 'L”schen' gestartet haben und auch 'L”schen bis Datum' aktiviert haben, dann erscheint vor dem Start des L”schvorganges noch eine Dialogbox, in der das Datum, bis zu dem gel”scht werden soll, nochmal angezeigt wird. Falls dieses Datum nicht Ihren Erwartungen nach der Eingabe entspricht, so k”nnen Sie dort nochmal das L”schen abbrechen. - Einstellungen: Hier k”nnen einige weitere Einstellungen fr CatPutz gemacht werden, die jedoch nicht unbedingt mit den Flags zusammenh„ngen, so daž sie in eine andere Box gewandert sind. Man kann einstellen, ob fr die tempor„ren Dateien ein anderes Directory benutzt werden soll oder nicht. In dem Textfeld wird das gerade eingestellte tempor„re Directory angezeigt. Durch einen Klick auf diesen Namen k”nnen sie das auch auf ein anderes Directory einstellen. Dafr erscheint dann die Fileselector-Box, in der sie einen Pfad ausw„hlen k”nnen. Fr diesen Pfad wird auch das Environment ausgewertet. Wenn eine Environmentvariable TMP existiert, so wird der tempor„re Pfad auf den in dieser Variablen enthaltenen Pfad gesetzt. Alternativ wird auch die Variable TMPDIR ausgewertet. Falls der Schalter 'Pfad aus INF-Datei' gesetzt ist, so wird immer der abgespeicherte TMP-Pfad genommen und nicht im Environment danach gesucht. Damit kann man auch einen TMP-Pfad dauerhaft einstellen, auch wenn im Environment kein entsprechender Eintrag vorhanden ist. Zus„tzlich kann man hier auch noch einstellen, ob Nachrichten, die teilgel”scht werden sollen und die keinen Kommentar haben, komplett gel”scht werden sollen oder nicht. Standardm„žig ist dieser Schalter angestellt. - Zeichensatz: Hier k”nnen Sie den Zeichensatz fr das Statistik-Fenster einstellen. Es werden alle nichtproportionalen GDOS-Zeichens„tze untersttzt. Mit proportionalen Zeichens„tzen sieht die Tabelle berhaupt nicht gut aus, deshalb werden diese nicht untersttzt. 4. FLAGS ======== In CAT ist es ja bekanntermažen inzwischen m”glich, fr jede Message einen Haufen Flags einzustellen. Davon werde einige in CatPutz zum selektiven L”schen benutzt. Dies sind folgende: - Teill”schung - Totall”schung - Interessant - Echt Gut (einstellbar, in CatPutz als Userflag 1 bezeichnet) - Echt Mist (einstellbar, in CatPutz als Userflag 2 bezeichnet) - Gelesen - Gefiltert Zus„tzlich gibt es in CatPutz noch ein 'Pseudo-Flag': - Nicht gelesen Dieses Flag steht fr Nachrichten, bei denen das 'Gelesen'-Flag nicht gesetzt ist. Wenn jemand in CAT das automatische Setzen des 'Gelesen-Flags' nicht eingestellt hat, so kann er mit diesem Flag nicht viel anfangen. Ansonsten kann man es aber gut benutzen, deshalb wurde es implementiert. Die genaue Benutzung wird auch in einem Beispiel aufgezeigt. Wie man auch an der Darstellung sehen kann, gibt es also ein paar Gruppen von Flags, die in CatPutz unterschiedlich behandelt werden. Dabei besteht zwischen dem Pseudo-Flag 'Nicht gelesen' und der Fnfer-Bande vorher in der Behandlung in CatPutz kein Unterschied, die Trennung ist nur dazu da, damit niemand auf die Idee kommt, in CAT zu versuchen, das Flag 'Nicht gelesen' zu suchen. Die ersten beiden Flags haben eine feste Bedeutung und werden in CatPutz auch so behandelt: - Teill”schung: Der Nachrichtentext wird gel”scht, stattdessen kommt nur ein kurzer Text, daž diese Nachricht gel”scht wurde. Dies ist wichtig, falls man bei einigen Nachrichten die Kommentarverkettung zu einer frheren Nachricht beibehalten will, denn die Kommentarverkettung bleibt bei einer Teill”schung erhalten. - Totall”schung: Die Nachricht wird komplett gel”scht und auch aus der Kommentarverkettung entfernt. Fr diese beiden Flags gilt auch die Beschr„nkung durch 'L”schen bis Datum' NICHT! Messages, die eines dieser beiden Flags haben, werden immer behandelt! Fr die brigen sechs Flags (das Pseudo-Flag wird jetzt nicht mehr genauer differenziert behandelt) kann man einzeln ber Popup-Menus einstellen, wie diese Flags behandelt werden sollen. Dabei gibt es fr jedes Flag vier M”glichkeiten der Behandlung: - Flag ignorieren: W„hrend des L”schens wird dieses Flag nicht beachtet. - Nicht l”schen: Eine Nachricht mit diesem Flag wird nicht gel”scht. - Totall”schung: Die Nachricht wird so behandelt, als ob das Flag 'Totall”schung' gesetzt w„re. - Teill”schung: Die Nachricht wird so behandelt, als ob das Flag 'Teill”schung' gesetzt w„re. In der Art der Behandlung dieser Flags gibt es natrlich auch eine Hierarchie, die folgendermažen aussieht: Nicht l”schen => Totall”schung => Teill”schung Das heižt folgendes: Wenn fr eine Message gleichzeitig verschiedene Flags gesetzt sind und eines davon auf 'Nicht l”schen' gestellt w„re, so wrde die Nachricht nicht gel”scht, auch wenn die anderen auf 'Teill”schung' oder 'Totall”schung' st„nden. Ebenfalls wird eine Nachricht total gel”scht, wenn sowohl die Flags 'Totall”schung' als auch 'Teill”schung' gesetzt sind. Aber keine Regel ohne Ausnahme: Das 'Pseudo'-Flag 'Nicht gelesen' ist von dieser Hierarchie ausgenommen! Dieses 'Pseudo'-Flag wird nur dann beachtet, falls von allen anderen Flags vorher keine Entscheidung ber die Behandlung der Nachricht getroffen wurde. WICHTIG: Wenn Sie unter 'Flags' die Standardeinstellung 'Flag ignorieren' nicht ver„ndert haben, dann werden beim L”schen nur die Nachrichten gel”scht, die schon in CAT mit einem der beiden L”schflags versehen wurden! Das dabei eingegebene Datum wird nur fr die anderen Flags beachtet! So, das ganze ist ja nun doch nicht so einfach, deshalb folgen jetzt noch ein paar wenige Beispiele aus der Praxis: Fall 1: Man liest ganz normal seine Messages und markiert nur die zu l”schenden mit den Flags in CAT. In diesem Fall kann man in CatPutz ohne weitere Vorkehrungen l”schen, also alle Flags auf 'Flag ignorieren' stellen. Fall 2: Man will immer eine Messagebase ber 2 Wochen haben und ist zu faul, jede Message, die man nicht behalten will, einzeln zu markieren. Dann stellt man in CatPutz das Datum auf -14 (sind ja Tage, also zwei Wochen), setzt das Gelesen-Flag auf 'Totall”schung' und l„žt seinen Putz laufen. Falls man noch besondere Messages darin hat, kann man diese ja noch mit dem Interessant-Flag oder einem der User-Flags versehen und fr diese dann noch 'Nicht l”schen' einstellen. Damit auch die Nachrichten mit dem 'Gelesen'-Flag gel”scht werden, mssen diese von CAT schon mit dem 'Gelesen'-Flag versehen werden. Dafr stellt man am besten in CAT ein, daž das 'Gelesen'-Flag nach dem Lesen einer Nachricht gesetzt werden soll. Man kann auch noch das 'Nicht gelesen'-Flag auf 'Totall”schung stellen', dann werden auch die Nachrichten gel”scht, die man noch nicht gelesen hat. Fall 3: Man liest gezielt Messages ber die Stichwortliste und will die nicht gelesenen direkt vernichten. Dazu stellt man das Datum aus, stellt das Pseudo-Flag 'Nicht gelesen' auf Totall”schung und l„žt den Putz laufen. Dabei werden allerdings auch die Nachrichten mit den normalen L”schflags gel”scht. 5. START šBER DIE KOMMONDOZEILE =============================== Ab der Version 2.20 ist CatPutz auch ber die Kommandozeile startbar, d.h. Kommandos in der Kommandozeile werden ausgewertet. Dabei kann man verschiedene L”schparameter angeben. Man kann auch weiterhin eine CAT.INF Datei als Parameter an CatPutz bergeben, diese *muž* aber dann der erste Parameter in der Kommandozeile sein. Es gibt vier verschiedene Schalter in der Kommandozeile, und zwar folgende: -m: Setzt die maximale Anzahl der Nachrichten, die in einer Gruppe brig bleiben sollen. -d: Setzt ein Datum, bis zu dem alle Nachrichten gel”scht werden sollen. -g: Spezifiziert eine Gruppe -q: Beendet CatPutz Sehr aussagekr„ftig ist das ja nicht, deshalb erkl„re ich jetzt etwas genauer, wie das ganze abl„uft. CatPutz kennt beim L”schen ber die Kommandozeile vier verschiedene Modi (wie das, sind doch nur zwei Schalter dafr da?). Diese sind: - L”schen aller Nachrichten bis zu einem Datum. Dies wird dann durchgefhrt, wenn vor einer Gruppenangabe nur der Schalter -d mit einem gltigen Datum angegeben wird. Beispiele: -d-10 setzt das L”schdatum auf heute vor 10 Tagen, -d1.5. setzt das L”schdatum auf den 1.5. des aktuellen Jahres. - L”schen aller Nachrichten, so daž nur eine bestimmte Anzahl brig bleibt. Dies wird dann durchgefhrt, wenn vor einer Gruppenangabe nur der Schalter -m angegeben wird. Beispiel: -m2000 l„žt in einer Gruppe nur 2000 Nachrichten brig. Gltige Werte gehen von 1 bis 65535. *Wichtig:* Es gibt dabei einen Sonderfall: Bei einer Angabe von -m0 wird eine Gruppe *komplett* gel”scht! - L”schen aller Nachrichten, die vor einem Datum kommen, und es drfen maximal n Nachrichten brigbleiben. Dieser Modus wird dann gew„hlt, wenn vor einer Gruppenangabe sowohl -d als auch -m angegeben wurden. Es wird dann so gel”scht, daž garantiert nicht mehr als n Nachrichten brigbleiben, und daž auch keine Nachrichten mit einem Datum vor dem Angegebenen mehr in der Datenbank sind. Es k”nnen also danach auch weniger als n Nachrichten in der Datenbank sein. - L”schen nach den fr diese Gruppe in CatPutz eingestellten Flags und Einstellungen. Dies wird genau dann durchgefhrt, wenn vor einer Gruppenangabe keiner der Schalter -d und -m auftaucht. Um das ganze mal zu konkretisieren, hier ein paar Beispiele. Beispiel 1: catputz -d1.10. -gAtari.Soft -gAtari.Talk -gSysops Dieser Aufruf l”scht in den Gruppen Atari.Soft, Atari.Talk und Sysops alle Nachrichten, die vor dem 1.10. liegen. Beispiel 2: catputz -m4000 -gkoeln -d1.1. -gPers”nliche Bei diesem Aufruf werden alle Mails bis auf 4000 in der Gruppe KOELN gel”scht, und danach werden alle Mails vor dem 1.1. in der Gruppe Pers”nliche gel”scht. Beispiel 3: catputz -gAtari.Soft -gMaus -m2000 -d1.9. -gMausTausch -gMusik -q Bei diesem Aufruf wird in den Gruppen Atari.Soft und Maus so gel”scht, wie man es in CatPutz fr diese Gruppen eingestellt hat (oder es wird halt die Defaultkonfiguration genommen, falls keine gruppenspezifische existiert). Danach werden in den Gruppen MausTausch und Musik alle Nachrichten gel”scht, die vor dem 1.9. kamen, und zus„tzlich wird so gel”scht, daž maximal 2000 Nachrichten in den Gruppen brigbleiben. Danach wird CatPutz beendet. Beispiel 4: catputz -d1.10. -m100 -gMaus -d1.1. -gcat -m42 -gKoeln Diese Zeile l”scht in der Gruppe Maus alle Nachrichten vor dem 1.10. und l„žt maximal 100 Nachrichten in der Gruppe drin, danach werden in der Gruppen CAT alle Nachrichten vor dem 1.1. gel”scht, und danach wird die Gruppe Koeln auf 42 Nachrichten reduziert. Die pers”nliche Gruppe wird ber den Namen 'Pers”nliche' angesprochen, wie auch in den Beispielen zu sehen war. Man kann beliebig viele Parameter angeben, diese werden in der Reihe ihres Auftretens in der Kommandozeile abgearbeitet. Die Einstellungen mit -d und -m gelten fr alle folgenden Gruppenangaben, und zwar solange, bis wieder eine -d oder -m Angabe erfolgt. Die Kommandozeilen k”nnen natrlich ziemlich lang werden. Das sollte aber kein Problem sein, da CatPutz das ArgV-Verfahren untersttzt. Also: Eine vernnftige Shell nehmen, und es gibt keine Probleme. Und jetzt noch ein paar vorhersehbare Fragen zur Bedienung mit der Kommandozeile und die Antworten dazu: F: Kann man die L”schmodi mit Anzahl und Datum auch normal in CatPutz benutzen? A: Nein. Diese L”schmethoden gibt es nur ber die Kommandozeile. Das liegt einfach daran, daž ich keine Lust habe, die Konfiguration nochmal zu verkomplifizieren. Aužerdem ist CatPutz schon fett genug. F: Und wenn ich ganz lieb bitte, kannst Du die nicht doch in CatPutz so einbauen? A: Nein, auch das hilft nicht. F: Gibt es einen speziellen Gruppennamen oder ein Kommando, um in allen Gruppen ber die Kommandozeile zu l”schen? A: Nein. Da CatPutz ber ArgV auch lange Kommandozeilen versteht, ist das nicht n”tig. 6. WAS TUN, WENN... =================== Dieses Kapitel widme ich all denen, die trotz der einfachen Bedienung immer noch Probleme mit CatPutz haben. Aužerdem werden auch noch ein paar Fehler- f„lle besprochen. - CatPutz ist elendig langsam: Das kann mehrere Grnde haben. Gehen wir diese mal der Reihe nach durch: Wahrscheinlich arbeiten Sie mit einer uralten TOS-Version (fr Festplatten- betrieb sollte man ein TOS >= 1.04 benutzen). Wenn das nicht der Fall ist, so haben sie keinen Cache installiert. Dazu gibt es von Atari das Programm CacheXXX, welches die internen Pufferlisten des GEMDOS sehr effektiv erweitert. Fr ein TOS < 1.04 empfehle ich den HaBoo von J.Reschke, ein externes Cache-Programm, welches fr diese TOS-Versionen ebenfalls sehr effektiv arbeitet. Da CatPutz sehr intensiv mit Dateien arbeitet, ist ein Cache immer sehr sinnvoll. Auch zu empfehlen ist TCache 6.0 von Ralf Biedermann (@ HB), ein sehr schneller und effektiver Plattencache. Sollte keiner dieser Punkte zutreffen, so liegt es wahrscheinlich an Speicherplatzmangel. CatPutz versucht, so viele Dateien wie m”glich im Speicher zu halten. Dies wird auch in der Statusbox angezeigt, die Sie ber den Fortschritt des L”schens informiert. Wenn dort in der untersten Zeile (unter dem Balken) immer nur 'Nichts gepuffert' erscheint, dann haben Sie effektiv zu wenig freien Speicher. Abhilfe: Entfernen Sie RAM-Disks, Accessorys und andere residente Programme, soweit m”glich. Sollte das dann immer noch nicht reichen, so empfehle ich den Kauf einer Speichererweiterung. Diese sind heutzutage sehr preisgnstig und lohnen sich auch fr die Arbeit mit anderen Programmen (nein, ich bekomme keine Provisionen von den Herstellern von Speichererweiterungen). -W„hrend des L”schens erscheint die Fehlermeldung: Disk ist voll! In diesem Fall haben Sie zu wenig freien Platz fr die tempor„ren Dateien auf Ihrer Partition gehabt. Dazu eine kurze Erl„uterung, wie CatPutz beim L”schen vorgeht. CatPutz kopiert alle Nachrichten und Parameter, die nicht gel”scht werden, in tempor„re Dateien. Diese tempor„ren Dateien werden normalerweise auch im Database-Pfad von CAT angelegt. Wenn nun die Partition sehr voll ist, kann es vorkommen, daž fr die Kopien der Dateien nicht mehr genug Platz vorhanden ist. Normalerweise k”nnten Sie dann nicht mehr l”schen oder mžten mehr l”schen als sie wollen, damit die neuen Dateien noch auf die Partition passen. Aber es geht auch anders: Sie k”nnen ber eine Environmentvariable CatPutz dazu berreden, die tempor„ren Dateien auf einem anderen Pfad anzulegen. CatPutz wertet beim Start das Environment aus und setzt seinen tempor„ren Pfad entsprechend dem Inhalt der Environmentvariablen 'TMP'. Falls diese nicht vorhanden ist, wird alternativ nach der Variablen 'TMPDIR' gesucht und diese genommen. Selbstverst„ndlich muž in der Variablen ein gltiger Pfad stehen, andernfalls wird diese Variable nicht beachtet. Sie k”nnen das auch dazu benutzen, die tempor„ren Dateien auf einer RAM-Disk anzulegen. Dadurch wird dann das Schreiben der neuen Dateien beschleunigt. Als Beispiel: Ihre RAM-Disk ist das Laufwerk M:, und sie wollen die tempor„ren Dateien auf dieser RAM-Disk haben. In diesem Fall sollten Sie in das Environment "TMP=M:\" eintragen, z.B. in dem Sie in Gemini im Console-Fenster (der Mupfel) 'setenv TMP=M:\' eingeben. Natrlich geht das auch ber jedes andere Programm, welches das Environment setzen kann, z.B. diverse Auto-Ordner-Programme. Falls im Environment sowohl die Variable TMP als auch TMPDIR vorhanden sind, so wird die Variable TMP vorgezogen. -CatPutz l”scht nicht, obwohl Sie dachten, es sollte l”schen: Sie haben keines der Flags zum L”schen eingestellt und auch in CAT fr keine Nachricht eines der Flags 'Totall”schung' oder 'Teill”schung' gesetzt. Lesen Sie doch einfach noch mal das Kapitel ber die Flags grndlich durch. Dazu direkt noch ein Hinweis: Nur mit der Einstellung 'L”schen bis Datum' wird gar nichts gel”scht, da das Datum nur eine Einschr„nkung fr die L”schflags darstellt. -(wird fortgesetzt) 7. SCHLUSSWORT ============== Wie jedes andere vernnftige Buch auch, hat dieses Manual ein Schlužwort. Das wird aber nicht so lang werden, da ich gar keine Lust mehr habe, viel zu schreiben. CatPutz ist ein Bestandteil von CAT, auch wenn es ein externes Programm ist. CAT und CatPutz sind Shareware! Das heižt, daž man bei regelm„žiger Benutzung von CAT oder CatPutz die Sharewaregebhr von DM 50,-- zu zahlen hat, ansonsten arbeitet man mit einer Raubkopie. Man darf brigens auch gerne mehr zahlen als 50,- DM. Wer also der Meinung ist, Cat und CatPutz seien mehr als DM 50,- Wert (ich bin dieser Meinung!): Spenden sind bei uns immer willkommen :-) Ich nehme gerne Verbesserungsvorschl„ge oder Erweiterungswnsche entgegen, wenn sinnvoll und m”glich, werden diese auch beachtet. CatPutz ist vollst„ndig mit dem Megamax Modula-2 Entwicklungssystem von Thomas Tempelmann und Manuel Chakravarty, im Vertrieb von Application Systems Heidelberg, entwickelt worden. Dies geschah unter Benutzung der MagicLib und der MagicTools von Peter Hellinger. So, jetzt noch meine Adresse (fr die Fehlermeldungen, hoffentlich keine). Achja, wer mir einen echten(!!) Fehler meldet und mir eine Diskette mit Rckporto zuschickt, der erh„lt von mir dann eine Version, in der dieser Fehler dann (hoffentlich) beseitigt ist, soweit m”glich. Adresse: Dirk Steins Auf dem Feldchen 48 D-53859 Niederkassel E-Mail: Mausnetz: Dirk Steins @ K2 Maus K”ln 2: 02203/12400 USENET: Dirk_Steins@k2.maus.de Konto (fr Spenden): Kreissparkasse Siegburg BLZ 38650000 Kontonr. 104020516 8. CREDITS ========== Ich habe mich entschlossen, noch ein paar Leuten zu danken, wie das so allgemein blich ist. Mein erster Dank geht an Johannes G”ttker-Schnetmann fr CAT. Auch wenn ich inzwischen daran mitschreibe, wenn er nicht angefangen h„tte, dann g„be es dieses hervorragende MausTausch-Frontend wohl nicht! Weiterhin danke ich dann noch allen Mausprogrammierern (heute noch t„tigen und ehemaligen) fr die Maus, das beste Mailbox-System, das ich kenne, s„mtlichen Betatestern, dabei besonders Lars-Iver fr seine netten Stories, und auch noch Thomas Tempelmann fr das MM2 (auch wenn die Speicherverwaltung immer noch 'verbesserungswrdig' ist) und Peter Hellinger fr die MagicLib und die MagicTools. Erw„hnen m”chte ich auch noch Stefan Radermacher und Oliver Scheel, ohne die es Selectric¿ nicht g„be (der einzig wahre Fileselektor). Und zuletzt danke ich auch noch der Firma Atari fr den ST, auch wenn er inzwischen schon etwas alt ist. All denen, die meinen, das sie hierhin geh”ren, aber doch nicht hier stehen, danke ich dann auch noch. Diese sollen sich dann einfach denken, das sie hier stehen. HISTORY ======= (erst ab Version 1.25) 24.05.92 1.26 Version fr ge„ndertes GRUPPEN.POS in neuer Beta von CAT. 19.10.92 1.27 Angepažt an Datenbank von CAT 2.0 1.11.92 1.28 Auch šberprfung des Message- und Statusdatums eingebaut, so daž auch dabei danach keine Fehler mehr in der Datenbank sein drfen. Die durch den Messagecheck gel”schten Nachrichten werden jetzt mit bei den totalgel”schten Nachrichten angezeigt! 2.11.92 1.28 Anzeige der Differenz-Kilobytes eingebaut (fr Peter Veith @ BN). 9.11.92 1.29 ž L”schen von einzelnen Gruppen ber CatPutz eingebaut. 28.12.92 1.30 ž Ausgabe von Statistik als Textfile und als CSV auf Clipboard eingebaut, nachladen von CAT.INFs eingebaut. Dialogbox bei Gruppenl”schen verbessert und es wird mit Gruppennamen abgefragt, ob die Gruppe gel”scht werden soll. Scannen der Gruppeninformationen beschleunigt. 21.01.93 1.31 ž CatPutz strzt nicht mehr ab, wenn kein GRUPPEN.POS vorhanden ist. Das wird dann einfach ignoriert, da es fr CatPutz nicht so wichtig ist. 07.02.93 1.32 ž Nach dem Neuladen einer CAT.INF Datei wurde die Liste im Fenster nicht neu dargestellt, es wurde nur die Summe richtig angezeigt. 25.3.93 2.0 Versionsnummer ge„ndert fr endgltige Distribution 12.4.93 2.01 ž Bug mit langen Gruppennamen behoben. CatPutz beachtet jetzt die Dialog- einstellungen aus dem CPX richtig 7.6.93 2.09 ž Gruppenweise Konfiguration eingebaut 2.7.93 2.10 Diese Version freigegeben 26.9.93 2.11 Anfang der Umstellung auf weitere CAT-Module 30.9.93 2.15 CatPutz l„uft mit CATGROUP.*, l”scht jetzt richtig, L”schanzeige im Fenster und parallel unter MTOS und Mag!X 2.10.93 2.15 CatPutz prft, ob CAT oder CatPutz schon aktiv sind und verweigert dann den Start 4.10.93 2.16 Einbau der Kommandozeilensteuerung 7.10.93 2.16 Beim L”schen ber die Kommandozeile wurden auch Nachrichten mit dem Interessant-Flag gl”scht. Das sollte nicht der Fall sein, deshalb wurde das ge„ndert. Allerdings kann es dadurch passieren, daž beim L”schen mit Mengenangabe die Zielmenge berschritten wird 14.10.93 2.17 Auswertung der Fehlercodes nach Fread/Fwrite war falsch 21.10.93 2.17 Gruppennamen sind wieder Case-Insensitiv in der CFG-Datei. Das Datum in der Konfigurationsbox ist nicht mehr ab und zu uninitialisiert. 29.10.93 2.18 Mauszeiger ist nur noch dann ein Ball, wenn ein eigenes Fenster das Topwindow ist. 1.11.93 2.20 Diese Version freigegeben