Madness Mailbox-System Programm-Index-Check V3.13         (c)  14.04.1994
=================================================         by Jrgen Meyer


Update von V3.10 auf V3.11/V3.12/V3.13

- Bei der Angabe "Index <nr.> von <gesamt> --->" wird nun auch der File-
  name der betreffenden Datei angezeigt, so da man bei defekten Dateien
  diese dann auch per PED ggf. nachbearbeiten kann, weil man anhand der
  internen Index-Nummer ja nicht mehr wei, um welches Programm es sich
  handelt, seitdem das Nummern-System nicht mehr verwendet wird...

- Beim einfachen Test ("nur Konsistenz testen") wurden nicht gefundene
  Dateien irrtmlicherweise als "Dupe"-Fehler gemeldet. Generell sollte
  man aber IMMER den genauen, vollen Test laufen lassen, wenn die Test-
  modi 2 und 3 irgendetwas zu beanstanden haben!


Update von V3.08 auf V3.10:

- PRGIDXCH kann nun auch als External gestartet werden. Es kann via
  "X PRGIDXCH.PRG" in MENUE.DAT installiert werden oder mit "ERUN" in
  der eingebauten Shell ('csh') geladen werden. Ein Start als Zeitexternal
  ist nicht mglich!

  ACHTUNG !!!

  Wird PRGIDXCH als External gestartet, so darf nach dem Start kein Zugriff
  mehr auf die Programmecke stattfinden, da evtl. eine Inkonsistenz zwischen
  der im Cache befindlichen Indexdatei und der reparierten Datei auf Platte
  befindet.

  PRGIDXCH lst daher, sofern als External gestartet, einen sofortigen
  Logout aus, sowie es beendet wird.

- Tritt whrend der Bearbeitung als External ein NO CARRIER auf, so werden
  alle weiteren Ausgaben auf Console ausgegeben und das External NICHT been-
  det, damit keine zerstrten Dateien zurckgelassen werden. Nach Ende des
  Externals (es wird dann natrlich nirgendwo mehr auf einen Tastendruck
  etc. gewartet) wird mit dem NC-Logout fortgefahren.


Update von V3.07 auf V3.08:

- Ungenutzte Bytes in den einzelnen Indizes werden nun nicht mehr
  auf Null zurckgesetzt (wichtig u.A. fr Markus Fritze's neue
  "ProgrammEcke V1.0")


Update von V3.06 auf V3.07:

- Fehler beim Dupe-Test beseitigt


Update von V3.05 auf V3.06:

- PRGIDXCH erkennt nun auch sogenanntes Dupes - doppelte Indexeintrge.
  Dies kann z.B. passieren, wenn die Filenamen gendert werden & ein Neu-
  Upload mit gleichem Filenamen passiert. PRGIDXCH hat vorher immer kein
  Fehler gemeldet, weil in beiden Abfragen (Index #1 und #2) ja immer
  der Test auf "File vorhanden" positiv ausfiel - obwohl es sich um das-
  gleiche File gehandelt hat. Solche Fehler, die eigentlich nur bei
  den Betatestern aufgetreten sind, werden nun erkannt und entsprechende
  Eintrge gelscht (nur bei Testmethode #1).


Update von V3.04 auf V3.05:

- Bei berflssigen Files wird nun nicht mehr kommentarlos gelscht,
  sondern nachgefragt, ob das/die File(s) gelscht werden sollen.


Update von V3.03 auf V3.04:

- Fehlermeldung, wenn Lnge eines Programmes = 0 Bytes (theoretisch machbar,
  weil 0-Byte Files beim Upload keinen Fehler erzeugen)
- Einbau von drei Testmodi:

  1. Volltest (so, wie bisher - alles wird geprft, Dateien werden einge-
     lesen, Position geprft und korrigiert)
  2. Positionstest (es wird ebenfalls alles geprft, jedoch werden nicht
     die ersten 128 Bytes erneut eingelesen (und Mode "FBytes" wird demzu-
     folge nicht geprft)), etwas schneller als der Volltest
  3. Quick-Scan (prft nur die Indexdatei auf Konsistenz, d.h. CRC korrekt
     und weitere, prfbare Eintrge, ohne die entsprechende Datei lesen
     zu mssen) - Ultraschnell

  Sollte beim Prfvorgang 2.) oder 3.) ein Fehler angezeigt werden, so
  sollte man zur Sicherheit immer nochmal den Volltest laufen lassen.


Update von V3.02 auf V3.03:

- Prfe Dateilnge, bei nicht-teilbar durch 512 ggf. Krzung
- Falsche Anzeige bei genullten Indexeintrgen behoben
- Hinzufgung der Prfart "Dl-Date"


Update von V3.00 auf V3.02:

- Bug entfernt: Beim Lschen von berflssigen Dateien geriet PRGIDXCH
  in eine Endlosschleife, wenn die zu lschende Datei keinen Extender
  besa


Mit diesem Utility kann die Integritt der ffentlichen Programmecke
bzw. der zugehrigen Indexdatei getestet werden. Beim Programmstart
fragt das Programm Dich nach der MB.INF Datei, die Du in der erschei-
nenden Fileselectorbox anklicken musst. Den Rest macht das Programm
dann automatisch.

Es werden die ausgewerteten Daten aus der Indexdatei sowie die tatschlich
vorhandenen Daten angezeigt. Unstimmigkeiten werden vorerst ignoriert.

Vor dem Prfen wird getestet, ob das Programm das aktuelle Format der
IDX_PRG.DAT berhaupt bearbeiten kann. Zu jeder nderung der Datei
gibt es natrlich ein neues PRGIDXCH, aber um Fehler zu vermeiden, wird
diese Sicherheitsabfrage gemacht.

PRGIDXCH bearbeitet nach Mglichkeit alle Dateien im Speicher, um hchst-
machbare Verarbeitungsgeschwindigkeit zu erreichen. Man mge bedenken,
da der Grund fr das rapide Langsamwerden bei vielen Programmen nicht an
PRGIDXCH liegt, sondern am GEMDOS, welches recht lahm wird, je mehr Da-
teien sich in einem Ordner befinden. Kann PRGIDXCH die zu bearbeitenden
Dateien nicht im Speicher halten, wird nur mit Dateizugriffen gearbeitet.
Deshalb darf PRGIDXCH auch *NIEMALS* mittels RESET oder hnlich brutal
"abgewrgt" werden, da dann offene Dateien auf der Platte verbleiben und
dies zur Zerstrung der Partitionsinformationen fhren kann!


Der Prfvorgang kann etwas dauern, dies hngt davon ab, wieviele Fehler
gefunden werden (wenn berhaupt). Es werden folgende Dinge abgetestet:

1.) CRC
    Ist die gesicherte CRC nicht identisch mit der errechneten, so wurden
    vermutlich Daten beschdigt. Hierbei wird eine CRC-Nichtbereinstimmung
    angezeigt, die Daten aber weiter geprft.

2.) Partitions-Nummer
    Liegt das File zum aktuell getesteten Programm nicht auf der Daten-
    partition, wie es in der Indexdatei eingetragen ist, so wird dies
    angezeigt und korrigiert (ist durch Umkopieren z.B. der Fall).

3.) File-Existenz
    Existiert das in der Indexdatei zu einem Programm zugehrige File
    nicht, so wird der Eintrag komplett gelscht, da ohne File der Eintrag
    wertlos ist.

4.) Lnge des Files
    Stimmt die Lnge des Files zum aktuell getesteten Programm nicht, so
    wird diese im Indexeintrag korrigiert.

5.) Ersten 128 Bytes des Files
    Es wird geprft, ob die in der Indexdatei aufgenommenen ersten 128
    Bytes der Datei noch identisch mit den Fileinhalt sind. Wenn nicht,
    werden die aktuellen, ersten 128 Bytes des File eingelesen.

6.) Datum
    Das Datum des Uploads wird geprft. Ist das Datum ungltig, so wird
    das heutige Datum eingesetzt.

7.) Zeit
    Der Zeitpunkt des Uploads wird geprft. Ist die Zeitangabe ungltig,
    so wird die aktuelle Zeit eingesetzt.

8.) Stichwort
    Ist das Stichwort bzw. die reprsentierende Nummer gleich 0 oder
    grer als 9, wird "1" eingetragen, also das erste Stichwort ver-
    wendet.

9.) Rechner
    Ist der Rechner bzw. die reprsentierende Nummer gleich 0 oder
    grer als 9, wird "1" eingetragen, also der erste Rechner ver-
    wendet.

10.) Status des Programmes
     Ist der Status des Programmes gleich 0 oder grer als 9, wird aus
     Sicherheitsgrnden der Status des Programmes auf 9 gesetzt, so da
     nur die Betreiber dieses Programm noch sehen oder editieren knnen.

11.) Datum des letzten Downloads
     Das Datum des letzten Downloads wird geprft. Ist das Datum ungltig,
     so wird das heutige Datum eingesetzt.


Whrend des Prfens wird angezeigt, welcher Index bearbeitet wird. Die
Ausgabe sieht so aus:

"Index xxxxx/xxxxx --> "

Links vom / ist die aktuell bearbeitende Index-Nummer zu lesen, rechts
die Maximalanzahl. Wird kein Fehler gefunden, verbleibt die Ausgabe in
einer Zeile. Bei gefundenen Fehlern werden diese nach "-->" angezeigt
und der Cursor eine Zeile nach unten bewegt.

Folgende Krzel knnen hinter "-->" auftauchen:

O.K.          Kein Fehler gefunden
CRC-Err       CRC stimmt nicht
PartNo        Nummer der Daten-Partition stimmt nicht
FileNotFound  File zum Programm wurde nicht gefunden
Length        Lnge des Files stimmt nicht
Length=0      Lnge des Files ist Null Bytes (wird gelscht)
FBytes        Die ersten 128 Bytes des Files stimmen nicht
Date          Datum nicht korrekt
Time          Zeit nicht korrekt
Spec          Stichwort bzw. Nummer des Stichwortes ungltig
Comp          Rechner bzw. Nummer des Rechners ungltig
Stat          Status des Programmes ungltig
Dl-Date       Datum des letzten Downloads ungltig
Dupe          Indexeintrag doppelt vorhanden


Nach beendetem Prfvorgang lscht PRGIDXCH alle Files, die sich in den
Daten-Partitionen befinden, aber nicht in der Indexdatei eingetragen sind.


MfG. Jrgen Meyer

