================================== ANMERKUNG ============================

Diese Anleitung ist für die Beta-Version von PMBSList und keinesfalls
vollständig!

Ebenso ist das Programm noch nicht bis in alle Einzelheiten ausgetestet,
es kann also noch zu Fehlern führen, obwohl ich mich bemüht habe, alle
nur denkbaren Fehlerquellen zu beseitigen!

=========================================================================

Versionsgeschichte:

  V0.222 - 28-May-95

         - Bugfix: Meldung 'Keine (Binär-)Uploads' in ASCII/BIN-Brettern

           Bei Brettern, die gleichzeitig das ASC und das BIN-Flag
           gesetzt hatten, kam die o.a. Meldung allerdings ohne daß der
           Brettname vorher ausgedruckt wurde
           Dieser Fehler wurde entfernt

         - neue Option: BildschirmLöschen=ja/nein [alle Modi]

           Mit dieser Option kann angegeben werden, ob am Anfang der
           Liste ein Bildschirm-Löschcode (\f) eingefügt werden soll
           (für TMS@DAME.shnet.org :-)

         - neue Option: TageKorrigieren=ja/nein [MODUS=neu]

           "mißbraucht" man den Neu-Modus zum Erstellen einer kompletten
           Fileliste in dem man den Tage= Parameter auf einen Wert setzt,
           der größer als das Alter der Box ist, so wurde für die Zeile
           xxx Uploads ( yyy Uploads pro Tag) dieser Tage= Parameter
           für die Berechnung des yyy herangezogen.
           Mit TageKorrigieren=ja wird jetzt zur Berechnung des yyy die
           Zeitspanne zwischen dem ältesten Upload und dem Erstellungs-
           Datum (jetzt) der Liste herangezogen, was der Wahrheit in
           diesem Fall sehr viel näher kommt.

           Für eine "richtige" Neue-Uploads-Liste (z.B. der letzten 4
           Tage), sollte TageKorrigieren=nein sein, denn wenn am ersten
           dieser 4 Tage nichts geuppt wurde, muß das natürlich dennoch
           in die Berechnung einfliessen.

           Alles verstanden ? :-)


  V0.217 - 20-May-95

         - neue Option: Text=links/rechts
           In der Top-Download-Liste kann der Brettname jetzt links oder
           rechts-"endig" angezeigt werden, also wahlweise die ersten
           oder die letzten 33 Zeichen des Brettnamens, reichen diese 33
           Zeichen nicht aus, so wird mit drei Punkten (...) angedeutet,
           daß der Brettname länger ist, als in diesem Feld angezeigt.

         - Fehler in der SupportLib behoben, in der Brettliste
           können nun auch Leerzeilen auftauchen

         - neue Option: Leermeldung=ja/nein
           Bei 'Leermeldung=ja' werden Bretter nur noch in die
           Neue-Upload-Liste eingetragen, wenn es dort mindestens
           einen Upload gegeben hat

         - neue Option: Sortierung=neu/alt
           Neue-Uploads-Liste kann jetzt wahlweise neu->alt oder alt->neu
           sortiert werden


  V0.208 - 15-May-95

         - Bei der Top-Download-Liste wird jetzt die Anzahl der Zugriffe
           beim vorigen Aufruf von PMBSList angezeigt, d.h. man kann die
           Veränderungen der Zugriffszahl erkennen.
           Diese Werte werden in der Datei, die im Ini-File unter "Daten="
           gespeichert, fehlt dieser Parameter wird automatisch die Datei
           "prometheus:Daten/toplist.dat" erzeugt

         - zusätzliche Meldungen im Meldungsfenster, so daß man besser
           erkennen kann, woran das Programm gerade arbeitet

         - am Anfang der Neue-Upload-Liste wird jetzt ein ClearScreen-
           Code (\f) eingesetzt


  V0.184 - 14-May-95

           Zwei Compiler(?)-Bugs umgangen, beim "Tage"-Parameter wurden
           größere Zahlen (>= 600 oder so...) nicht richtig in einen
           Long-Wert konvertiert, daher lieferte der Neu-Modus da
           unvollständige Listen (Danke an SYSOP@DAME.shnet.org für
           die Feststellung)

           neue Option "Farbe=ja/nein" - Liste mit oder ohne Farben
           erzeugen


  V0.181 - 04-May-95

           erste veröffentlichte Version

=========================================================================

Anleitung für PMBSList V0.222 vom 28.05.95:

PMBSList soll ein universelles List-Tool für Prometheus werden.

Zwei Funktionen sind bis jetzt realisiert:

  1) Erzeugen einer Top-Download-Liste, d.h. es können die beliebtesten
     Files einer Box angezeigt werden

  2) Erzeugen einer Neuen-Upload-Liste, d.h. es können die neuen Files
     in einer Box angezeigt werden

     (durch geschicktes Angeben des Tage= Parameters und der anderen
     Optionen, kann man diesen Modus nutzen um eine komplette File-
     Liste der Box zu erstellen!)

Alle Funktionen sind in einem Programm, nämlich PMBSList (ach was :-)
realisert und können über eine Konfigurations- (Ini-) Datei gesteuert
werden, die vielfältig konfiguriert werden kann.

PMBSList läuft mit einer Taskpriorität von -1, d.h. während der
Erzeugung einer Liste kann in der Box normal weitergearbeitet werden!


Installation:

  PMBSList sollte unter dem Namen PList in ein Verzeichnis im Suchpfad
  kopiert werden (am besten nach C:).

  Der kurze Name und der Suchpfad sind von entscheidender Bedeutung,
  wenn es darum geht, PMBSList im Prometheus-Zeitplan aufzurufen, wo
  Martin Brückner, der Programmierer von Prometheus gerade einmal
  35 Zeichen für das Kommando samt seiner Parameter vorgesehen hat :-(((

  Im Prometheus-Verzeichnis sollten dann die Ini-Dateien installiert
  werden, je nachdem, welchen Modus man benutzen will, die TopList.ini
  oder die NeuList.ini oder beide.

  Mit Hilfe des mitgelieferten Tools ListProBretter muß dann eine
  ASCII-Text-Liste (!) der Brettliste erzeugt werden. Danach löscht
  man mit einem Editor die für die Liste unerwünschten Bretter aus
  dem Text und speichert ihn unter Prometheus:pmbslist.lst ab.
  Oberbretter, also Bretter, die selbst keine Files enthalten, sollte
  man löschen, damit spart sich das Programm, in diesen Verzeichnissen
  nach Indexfiles zu suchen!

  ListProBretter schreibt auf die Standardausgabe, mit > kann die
  Brettliste in eine Datei geschrieben werden, am besten man gibt
  hier gleich an: ListProBretter BIN >prometheus:pmbslist.lst

  ListProBretter versucht, die Datei prometheus:daten/brett.dat zu
  lesen, hat man eine andere Brettliste, so kann man den Namen
  wie folgt an ListProBretter mitgeben: ListProBretter FILE=filename


  Aufgerufen wird PMBSList (oder PList, wenn man es so genannt hat)
  am Besten im Zeitplan, und zwar sieht das dann in etwa so aus:

    00:05 DOSC plist config=prometheus:top.ini
    00:10 DOSC plist config=prometheus:neu.ini

  (nicht vergessen, die 1. Zahl im Zeitplan entsprechend der
  angefügten Zeilen zu vergößern!!)

  Zu den angegebenen Zeiten wird nun eine Liste erzeugt und zwar
  um 00:05 die Top-Download-Liste und um 00:10 die Neue-Upload-Liste!

  Lt. eigener Aussage von M. Brückner, dem Programmierer von Prometheus
  sollte man keine Zeiten unter 00:05h eingeben, den Grund hat er
  allerdings nicht genannt :-/


---- !!!!!!! -----

  Sollte ein User gerade auf die zu erzeugende Liste zugreifen, so
  wird eine (systemfreundliche!) Pause von 60 Sekunden eingelegt, danach
  versucht PMBSList erneut die Liste zu schreiben. Nach 10 erfolglosen
  Versuchen beendet sich PMBSList automatisch!

---- !!!!!!! -----

  Nach dem Erzeugen der Neue-Uploads-Liste wird von PMBSList eine
  Online-Message an die gerade eingeloggten User geschickt
  ("SYSTEM: neue Upload-Liste erzeugt um HH:MM!").
  (Für die Top-Files-Funktion ist das noch nicht realisiert!)

  In Prometheus muß man jetzt nur noch einen Befehl erzeugen, mit dem
  man die Listen anzeigen lassen kann, z.B.

     NAME: TOP FILES!
     BESCHREIBUNG:  die Super-Files dieser Box
     PARAMETER:     prometheus:texte/toplist.txt
     GRUPPE:        (wie gewünscht)
     TYP:           Text
     Shortcut:      3
     Befehl:        markieren
     Extern:        markieren

  Analog verfährt man mit der Neuen-Upload-Liste.

  Man kann natürlich auch im Login.txt z.B. die Neue-Upload-Liste
  eintragen, in die letzte Zeile sollte dann rein:

    #%>prometheus:texte/neulist.txt

  Mit ein paar Zusatzparametern kann man noch das Aussehen der Liste
  steuern, bitte dazu die mitgelieferten .ini-Dateien anschauen,
  diese sind kommentiert.

  Ruft man PMBSList ohne den CONFIG= Parameter auf, so wird die
  Datei 'pmbslist.ini' im gleichen Verzeichnis wie PMBSList gesucht.

  Den CONFIG= Parameter kann man auch mit C= abkürzen!!


Beschränkungen:

  In der Beta-Version können z.Zt. in der "Neue-Uploads-Liste" nur
  500 verschiedene Uploader aufgenommen werden, hat man mehr Uploader
  (was allerdings unwahrscheinlich ist), so wird das Programm mit an
  Sicherheit grenzender Wahrscheinlichkeit abstürzen :-)

  (Noch mal: Es geht um die Anzahl der VERSCHIEDENEN UPLOADER, also der
   User (!), nicht der Uploads selbst, da ist man nur durch den vorhandenen
   Speicher beschränkt!)


Support:

  Support gibt es vom Programmierer persönlich :-)
  Einfach eine E-Mail an JEFF@DAME.SHNET.ORG

  Das neueste Update gibts in der

     SANCTUARY BBS HAMBURG - +49-(0)40-3901997  (V.42bis)

     Login: GAST (kein Passwort)
     Brett: /A0-Amiga/A3-Prometheus

  oder in der

     NOTRE DAME BBS HAMBURG - +49-(0)40-2800074  ZyXEL EG 19.2
                            - +49-(0)40-247816   ACTiVE 28.800
                            - +49-(0)40-28050032 ISDN X.75

     Login: GAST (kein Passwort)
     Brett: /<---SUPPORT--->/JEFFS_PROMETHEUS-TOOLS

