home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_07 / MAG_SL84.ZIP / MAGICBOX / TEXTE / CRUNCHER.TXT < prev    next >
Text File  |  1993-01-31  |  15KB  |  346 lines
  1. CRUNCHER für MagicBox SL
  2. ========================
  3.  
  4.  Änderungen gegenüber der letzten Beschreibung sind mit dem Änderungs      #
  5.  Kennzeichen "#" in der Spalte 75 jeder Zeile markiert!                    #
  6.  
  7. Version 2.08 (31.01.1993)                                                  #
  8.  
  9.  
  10.  
  11. Inhalt
  12. ------
  13.  
  14. I  Einführung
  15. 1.1  Konzept des Crunchens
  16. 1.2  Begriffe
  17. 1.3  Installation
  18.  
  19. II  Benutzung
  20. 2.1  Möglichkeiten des Crunchers
  21. 2.2  Programmparameter des Crunchers
  22. 2.3  Arbeitsweise des Crunchers
  23.  
  24. III  Dateien
  25.  
  26. IV  Haftungsausschlu₧ und Warnung
  27.  
  28. V  Autor
  29.  
  30.  
  31. I  Einführung
  32. -------------
  33.  
  34. 1.1  Konzept des Crunchens
  35.  
  36.   In einer Mailbox sammeln sich mit der Zeit immer mehr Nachrichten an.
  37.   Ein SYSOP mu₧ nun dafür sorgen, da₧ die Nachrichten, die sich in der
  38.   Mailbox befinden nicht zu alt, und somit zu langweilig werden. Ältere
  39.   Nachrichten sollten daher regelmä₧ig gelöscht werden.
  40.   
  41.   Des weiteren wird eine Mailbox unübersichtlich, wenn in einem Brett
  42.   zuviel Nachrichten aufgehoben werden. Man hat dann zwar die Möglich-
  43.   keit alte Informationen immer wieder zu finden, aber aufgrund der
  44.   gro₧en Datenmenge, die weiterhin verwaltet werden mu₧, wird das Programm
  45.   zwangsweise langsamer.
  46.   
  47.   Der Befehl LÖSCHEN oder KILL entfernt aus der Mailbox eine Nachricht
  48.   nicht wirklich, sondern markiert diese nur als gelöscht. Dadurch werden
  49.   diese Befehle viel schneller, als wenn beim Löschen die Nachricht auch
  50.   physikalisch entfernt werden mu₧. 
  51.   
  52.   Aus diesen Gründen gibt es Programme, die einen Teil, oder eine ganze
  53.   Mailbox durchsuchen und alte, doppelte oder zuviel Nachrichten auch
  54.   physikalisch aus den Dateien entfernen und somit dem Sysop die
  55.   Möglichkeit geben, auch mal die Mailbox längere Zeit alleine zu lassen,
  56.   ohne gleich zu Befürchten müssen, da₧ die Festplatte in Kürze
  57.   überfüllt ist.
  58.   
  59.   Ein solcher Cruncher ist ebenfalls in MagicBox SL enthalten.
  60.  
  61. 1.2  Begriffe
  62.  
  63.   Nachfolgend werden die einzelnen Begriffe beschrieben, die im Kapitel
  64.   1.3 Installation wieder verwendet werden.
  65.   
  66.   - BINÄR (Bin-Bretter)
  67.     In BIN-Bretter werden Programme gespeichert, die andere User downladen
  68.     können. Da es meistens unerwünscht ist, da₧ alte Programme gelöscht
  69.     werden, kann der Cruncher diese Bretter überspringen
  70.     
  71.   - Cruncheintrag:
  72.     Im Bretteditor kann unter CRUNCHEN AB: ein Wert eingetragen werden,
  73.     der vom Cruncher ausgewertet wird. Dieser Wert bestimmt die maximale
  74.     Anzahl von Nachrichten, die in diesem Brett verbleiben dürfen.
  75.     Als Besonderheit dient der Eintrag "0", der dem Cruncher andeutet,     #
  76.     da₧ das Brett beim Crunchen übergangen werden soll.                    #
  77.  
  78.   - DUPE's:
  79.     Diese Dinger sind identische Nachrichten, die durch Fehlfunktionen im
  80.     Netz erzeugt wurden. In einem Brett steht somit die gleiche Mail
  81.     mehrfach. Da es nur Speicherplatz und Nerven der User kostet, ist es
  82.     natürlich uninteressant solche Dupes in der Mailbox zu belassen.
  83.     
  84.   - Ereignis:
  85.     Ein Ereignis ist ein täglich wiederkehrender Prozess. Zu einer
  86.     bestimmten Uhrzeit kann ein Programm automatisch gestartet werden.
  87.  
  88.   - Parameter:
  89.     Jedem Programm können Parameter beim Aufruf übergeben werden. Das
  90.     bedeutet, da₧ man so einem Programm mitteilen kann, was es denn
  91.     eigentlich tun soll. Diese Parameter sind je Programm verschieden
  92.     und für den Cruncher im Abschnitt 2.2 erklärt!
  93.     
  94.   - PM: (Private Mails)
  95.     PM's werden getrennt verwaltet. Der Cruncher hat aber auch eine
  96.     Routine um die PM's crunchen zu können.
  97.     
  98.   - Verfalltage:
  99.     Um Nachrichten nicht zu alt werden zu lassen kann man die Anzahl der
  100.     Verfalltage angeben. Das hei₧t, da₧ eine Nachricht nach einer Anzahl
  101.     von Tagen für den User uninteressant ist und daher gelöscht werden
  102.     soll.
  103.  
  104. 1.3  Installation
  105.  
  106.    Kopieren Sie das Programm CRUNCHER.GTP in den PROGRAMM-Ordner, oder
  107.    in einen beliebigen Ordner auf dem gleichen Laufwerk, auf dem auch
  108.    MagicBox SL installiert ist.
  109.    
  110.    Es gibt dann zwei Möglichkeiten das Programm einzubinden:
  111.  
  112.    1. Als Ereignis. Dazu sind beispielsweise folgende Schritte notwendig:
  113.  
  114.       - Einloggen
  115.       - EDIT EREIGNIS
  116.       - Angabe der Uhrzeit, Art = PROGRAMM,
  117.         Parameter = \MAGICBOX\PROGRAMM\CRUNCHER.TTP -P -%80 -Z -B -D
  118.  
  119.       Die Parameter sind also mit einem Leerzeichen hinter den Programmnamen
  120.       anzugeben (Beschreibung der Parameter im Abschnitt 2.2)!
  121.  
  122.       In diesem Falle wird IMMER die KOMPLETTE Box gecruncht!!!!!
  123.    
  124.    2. Als eigener Befehl! (siehe auch Beschreibung der BEFEHLE.CNF!)
  125.       Nachfolgend ein Beispiel
  126.  
  127.       - In die Datei BEFEHLE.CNF folgende Zeilen eintragen:
  128.         ; ---------------------------------------------------
  129.         PROGRAMM
  130.         QUick-crunch
  131.         8
  132.         \MAGICBOX\PROGRAMM\CRUNCHER.TTP -a
  133.         ; ---------------------------------------------------
  134.       - Auch hier die Parameter mit einem Leerzeichen getrennt vom Programm-
  135.         namen angeben!
  136.       - Nun kann mit 'QU' der Cruncher gestartet werden, wobei er lediglich
  137.         das Brett bearbeitet, in dem sich der User befindet!
  138.       - Mit 'QU -B -P -K' würde der Cruncher mit PM und BIN-Crunch über
  139.         die komplette Box gestartet!
  140.         Beschreibung der Parameter im Abschnitt 2.2!
  141.  
  142. II  Benutzung
  143. -------------
  144.  
  145. 2.1  Möglichkeiten des Crunchers
  146.  
  147.   Es wurde Wert darauf gelegt, da₧ der Cruncher möglichst schnell arbeitet.
  148.   Das wurde dadurch realisiert, da₧ die meisten Aktionen im Ramspeicher
  149.   des Computers ablaufen. Achtung es wird KEIN TT-Ram unterstützt!
  150.   
  151.   Was kann man nun alles mit den Nachrichten der Box anstellen?
  152.   
  153.   - Auswahlmöglichkeit, ob PM's gecruncht werden sollen oder nicht
  154.   - Auswahlmöglichkeit, ob BIN-Bretter gecruncht werden sollen oder nicht
  155.   - Einstellmöglichkeit, wieviel Mails aus den Brettern entfernt werden
  156.   - Einstellmöglichkeit, auf wieviel % ein Brett gecruncht werden soll.
  157.   - Einstellmöglichkeit, ob nur bereits gelöschte Mails entfernt werden.
  158.   - Einstellmöglichkeit eines Verfalldatums
  159.   - Auswahlmöglichkeit, ob DUPES gesucht und gelöscht werden sollen.
  160.   - Übersprungmöglichkeit einzelner Bretter!
  161.  
  162. 2.2  Programmparameter des Crunchers.
  163.  
  164.   Wenn der Cruncher installiert wird (siehe Kapitel 1.3) sind die
  165.   gewünschten Programmparameter anzugeben. Der Cruncher hat davon jede
  166.   Menge.
  167.   
  168.   Jeder Parameter beginnt mit einem - und einem Buchstaben! Manche
  169.   Parameter erfordern auch noch Zahlenwerte DIREKT IM ANSCHLU₧, also
  170.   OHNE LEERZEICHEN!
  171.   
  172.   Werden mehrere Parameter angegeben, so ist jeweils zwischen den Programm-
  173.   parametern ein Leerzeichen einzufügen.
  174.   
  175.   Nun der Aufruf des Programms mit der Beschreibung der Parameter:
  176.   
  177.    CRUNCHER.GTP {[{-%[nn]}{-M[nn]}] [-p[m]] [-b[inär] [-u[pdate]]]
  178.                 [-a[nzeigen]] [-z[wingend]] [-k[omplett]]
  179.         [-g[elöscht] [-d[upekiller]] [-v[nn]] }{[-?]}
  180.  
  181.    -%nn   = Mu₧ ein Brett gecruncht werden, so enthällt es hinterher noch
  182.             nn % der Nachrichten die bei 'Crunchen ab' eingestellt sind.
  183.             Wird nn nicht angegeben, wird der Standardwert übernommen.
  184.             (Standardwert = 90%     Bei Eintrag 200 -> bleiben 180 Mails)
  185.             (MIN-MAX = 50 - 100)
  186.  
  187.    -Mnn   = Mu₧ ein Brett gecruncht werden, so enthällt es hinterher noch
  188.             die Anzahl der Nachrichten, die bei 'Crunchen ab' eingestellt
  189.             sind, minus nn. Wird nn nicht eingegeben, so wird der Standard-
  190.             wert übernommen.
  191.             (Standardwert = 10, MIN-MAX = 1 - 50)
  192.  
  193.    Die Parameter -% und  -M schlie₧en sich gegenseitig aus! Werden beide
  194.    Angegeben, so wird der übernommen, der zuletzt angegeben wurde.
  195.  
  196.    -PM    = Das Persönliche Fach wird auch durchsucht, wobei hier lediglich
  197.    -P       die Nachrichten gecruncht werden, die auch gelöscht wurden.
  198.  
  199.    -BINÄR = Die Binär-bretter werden durchsucht, wobei auch hier lediglich
  200.    -B       die Nachrichten gecruncht werden, die auch gelöscht wurden.
  201.             ACHTUNG wenn dieser Parameter angegeben ist, dann wird der
  202.             Eintrag in der Brettdatei bei 'Crunchen ab' ignoriert! Es
  203.             werden die BIN-Bretter IMMER gecruncht, auch wenn der Eintrag
  204.             '0' wäre! Wobei BIN-Bretter nur von gelöschten Mails           #
  205.             befreit werden. Ein automatisches entfernen von ungelöschten   #
  206.             Mails wird NICHT durchgeführt!                                 #
  207.  
  208.    -UPDATE
  209.    -U     = Upgedatete Programme werden mit neuem Betreff aufgenommen.
  210.             (geht nur als Befehlsparameter)
  211.  
  212.    -ANZEIGEN
  213.    -A     = Wird ein Brett gecruncht, werden normalerweise nur '*'chen
  214.             ausgegeben. Wurde aber der Parameter -A oder -ANZEIGEN über-
  215.             geben, so wird pro Mail eine Zeile ausgegeben, die folgenden
  216.             Inhalt hat:
  217.                                Absender,Empfänger,Gelesen,Datum,Betreff
  218.             Angezeigte Länge:    19        19        2      6     28
  219.             
  220.             Bei BIN-Bretters sieht die Ausgabe genauso aus, nur da₧ im
  221.             Betreff der Programmname steht!
  222.             (geht nur über serielle Schnittstelle!)
  223.  
  224.    -GELÖSCHT
  225.    -G     = Von jedem Brett wird die BRETT.IND eingelesen und geprüft, ob
  226.             eine Mail gelöscht wurde. Ist dies der Fall, dann wird das
  227.             Brett gecruncht.
  228.             Das bedeutet allerding einen Zeitverlust von ca. 250 % !
  229.             Ohne -G werden 100 Bretter in ca. 10 Sekunden überprüft, mit
  230.             -G und ca. 40 Mails pro Brett werden 25 Sekunden benötigt.
  231.  
  232.    -Vnn   = Verfalltage für die GANZE(!!!!) Mailbox. Bei nn kann die
  233.             Anzahl der Tage angegeben werden, wie lange die Nachrichten
  234.             maximal in den Brettern bleiben dürfen! Wird V angegeben, so
  235.             ist G automatisch aktiv! Gültige Werte gehen von 2 Jahre bis
  236.             28 Tage. Wird für nn ein falscher Wert angegeben, so werden
  237.             366 Tage angenommen.
  238.             Bretter mit dem Cruncheintrag '0' werden NICHT gecruncht!
  239.  
  240.    -DUPEKILLER
  241.    -D     = Es werden alle Mails auf doppeltes Vorkommen überprüft.
  242.             Doppelte Mails werden aus der Box entfernt.
  243.  
  244.    -ZWINGEND
  245.    -Z     = Die Datei MAGICBOX.FIL wird zwingend nach dem Programmlauf
  246.             abgespeichert. In dieser Datei sind die Informationen über
  247.             die Anzahl der Mails in den Brettern enthalten. Normalerweise
  248.             wird die Datei nur abgespeichert, wenn ein Brett gecruncht
  249.             wurde! Um den Wartebildschirm mit den richtigen Mailzahlen     #
  250.             zu versorgen, sollte bei einer Erstinstallation der Cruncher   #
  251.             einmal mit dem Parameter -Z gestartet werden.                  #
  252.  
  253.    -KOMPLETT
  254.    -K     = Wird das Programm als Befehl aufgerufen, wird nur das Brett
  255.             gecruncht, in dem man sich gerade befindet. Wird dieser
  256.             Parameter allerdings mit übergeben, so wird die komplette
  257.             Box gecruncht!
  258.  
  259.    -?     = Gibt einen Hilfstext auf dem Bildschirm aus
  260.    
  261.    Wird kein Parameter übergeben, so ist folgende Einstellung aktiv:
  262.  
  263.    Crunchen auf 90 %, PM nicht crunchen, BIN-Bretter nicht crunchen,
  264.    Kein Dupekiller, kein Verfalldatum!                                     #
  265.  
  266. 2.3  Arbeitsweise des Crunchers
  267.  
  268.    Das Programm überprüft, ob die Länge der BRETT.IND-Datei grö₧er ist,
  269.    als der in der MAGICBOX.FIL angegebene Crunchwert * 520. Ist dies der
  270.    Fall, so wird das Brett gecruncht.
  271.    
  272.    Eine Ausnahme gibt es natürlich: Ist der Crunch-Eintrag in der
  273.    MAGICBOX.FIL = 0, so wird das Brett übersprungen! Nun die Ausnahme
  274.    der Ausnahme: wenn das Brett ein BIN-Brett ist und der Parameter -B
  275.    übergeben wurde wird trotzdem gecruncht!
  276.    
  277.    Wird das Programm online gestartet, dann wird nur das Brett bearbeitet, #
  278.    in dem man sich gerade befindet. Dieses Brett wird nun auf alle Fälle   #
  279.    gecruncht. Bei einem Cruncheintrag von 0, werden nur evtl. gelöschte    #
  280.    Nachrichten entfernt!                                                   #
  281.  
  282.    Wird der Parameter -G übergeben, so wird das Brett gecruncht, wenn
  283.    eine Mail darin gelöscht wurde.
  284.  
  285.    Die Dateien MAGICBOX.FIL und die jeweilige Indexdatei wird KOMPLETT in
  286.    den Speicher geladen, damit die entsprechende Geschwindigkeit erzielt
  287.    werden kann. 
  288.  
  289.    Des weiteren wird versucht die neue Datendatei ebenfalls komplett im
  290.    Speicher zu erzeugen. Hier ist aber auch ein schrittweises Crunchen
  291.    realisiert. Als minimaler Speicher für die Datendatei sind 4000 Byte
  292.    reserviert!
  293.  
  294. III  Dateien
  295. ------------
  296.  
  297.   Das Programm greift auf folgende Dateien von MagicBox SL zu. Daraus
  298.   ergibt sich, da₧ wenn eine dieser Dateien durch einen Update von
  299.   MagicBox SL in der Struktur verändert wird, kann für die korrekte
  300.   Funktion des Programms nicht garantiert werden.
  301.   
  302.    \MAGICBOX\SYSTEM\MAGICBOX.FIL               -> Brettdatei
  303.  
  304.    \MAGICBOX\SYSTEM\MAGICBOX.PMD               -> PM-Daten
  305.                              PMI               -> PM-Index
  306.  
  307.    <laufw>:\MAGICBOX\BRETTER\<brett>\BRETT.DAT -> Brett-Daten
  308.                                            IND -> Brett-Index
  309.  
  310.    \MAGICBOX\SYSTEM\CRNCH.PMD                  -> Zwischendatei: PM-Daten
  311.                           PMI                  -> Zwischendatei: PM-Index
  312.    <laufw>:\MAGICBOX\BRETTER\<brett>\CRNCH.DAT -> Zwischendatei: Brett-Daten
  313.                                            IND -> Zwischendatei: Brett-Index
  314.  
  315.    Daraus folgert, da₧ das Programm auf dem gleichen Laufwerk installiert
  316.    sein mu₧, wie der SYSTEM-Ordner!
  317.  
  318. IV  Haftungsausschlu₧ und Warnung
  319. ---------------------------------
  320.  
  321.   Das Programm wurde längere Zeit auf Herz und Nieren getestet. Dennoch
  322.   kann ich keine Haftung für evtl. durch dieses Programm verursachte
  323.   Schäden übernehmen.
  324.   
  325.   Gelöschte Nachrichten sind nach einem Durchlauf unwiederbringlich
  326.   verloren, durch unüberlegte Parameterauswahl, die mit einem verkehrten
  327.   Systemdatum zusammentrifft, kann die komplette Box gelöscht werden!
  328.   
  329. V  Autor
  330. --------
  331.  
  332.   Geschrieben wurde der Quick-Crunch von Michael Pieper in Pure-C 1.0
  333.                      ab Version 2.06 von Michael Pieper in Pure-C 1.1
  334.  
  335.   Dokumentation von Michael Pieper, 12. Dezember 1992
  336.          Update von Michael Pieper, 31. Januar   1993
  337.  
  338.   Anschrift: Michael Pieper      Mailadresse: MagicNET:ALADIN@STARBOX
  339.              Flurstra₧e 5                     LightNET:ALADIN@COLUMBIA
  340.              8906 Gersthofen
  341.  (ab 1.7.93) 86368 Gersthofen
  342.  
  343.        Tel.: 0821 495633
  344.  
  345.  
  346.