QWKRR128 - Der Offlinemailreader für den Commodore 128

Anhang C

QPA Anleitung
QPA benötigen sie, wenn in ihrer Mailbox die sogenannte Cross-Archivierung nicht unterstützt wird. Unter Cross-Archivierung versteht man, wenn unterschiedliche gepackte Mailpakete beim Down- bzw. Upload in der Mailbox unterstützt werden.

Wollen Sie ein externes Packprogramm verwenden, so können sie mit Hilfe von QWKRR eine .MSG - Datei erstellen, die sie anschließend weiterverarbeiten können. Noch einfacher geht es mit der QP‹A› boot Option von QWKRR. Hier werden ihre einzelnen Nachrichten zusammengefaßt und anschließend automatisch QPA geladen.

Copyright-Hinweise:
Die Programme QPA und QPA.ML wurden von Russell Prater und Rod Gasson geschrieben. Diese Programme können frei weitergegeben werden, solange diese unverändert und keine Gebühr dafür verlangt wird. Möchten sie eigene Veränderungen an den Programmen vornehmen, so tun sie dies. Einzige Voraussetzung hierzu ist, daß sie einen anderen Filenamen verwenden und ihr Programme nicht dem originalen Programmarchiv hinzufügen. Dadurch können sehr einfach Mißverständnisse von vornherein ausgeschlossen werden.

QPA und QPA.ML:
Mit Hilfe dieser beiden Programme können sie eine QWK-Nachrichtendatei im ARC-Format erstellen. Die Datei wird hierbei lediglich abgespeichert, d.h. es wird keine Kompression der Datei vorgenommen. Meiner Meinung nach ist eine einfache Bedienung besser, als eine Verkürzung der Uploadzeit, die ohnehin nicht nennenswert ist. Beim ARC-Format wird in den seltensten Fällen eine Kompressionsrate von 2:1 erreicht, sodaß sich das Fehlen einer Datenkompression nicht als allzugroßer Nachteil ergibt.

Installation von QPA:
Kopieren sie QPAxx und QPA.ML auf ihre Arbeitsdiskette, am besten auf dieselbe Diskette, auf der sich auch QWKRR128 befindet. Damit die QP‹A› boot-Option von QWKRR richtig funktionieren kann, sollten sie den Dateinamen "QPA" nicht verändern, denn nach einer Datei mit diesem Namen wird QWKRR128 suchen. So wie sie QPA erhalten haben, werden ihre Laufwerksnummern und die entsprechenden Dateinamen nicht stimmen. Damit sie nun QPA ihren Wünschen entsprechend anpassen können, wurde eine Vorkehrung getroffen. Es ist nun dabei wichtig, daB sie wissen, welche userdefinierten Variablen im Programm verwendet werden. Das Programm wird ihre Eingaben nicht auf die Richtigkeit hin überprüfen, achten sie daher selbst auf eine korrekte Eingabe. Es werden ihnen lediglich ihre eingegebenen Daten zur Kontrolle nocheinmal angezeigt, damit sie diese gegebenenfalls berichtigen können.

R$: Dies ist der Name ihres *.MSG-Paketes. Der Name wird von ihrer Mailbox vorgegeben und sie müssen diesen Namen bei dieser Variable eingeben. Beachten Sie hierbei die Groß- bzw. Kleinschreibung. Starten Sie QPA von QWKRR aus, so wird der Name ihres gerade bearbeiteten Mailpaketes verwendet.

D: Als voreingestellte Laufwerksadresse wird das zuletzt benutzte Laufwerk genutzt. QPA.ML wird von diesem Laufwerk nachgeladen. Die Adresse wird in der Variablen D abgespeichert. Ich empfehle ihnen, QPA und QPA.ML auf der gleichen Diskette abzuspeichern, auf der sich auch die Systemdateien von QWKRR128 befinden.

Dl: Dies ist das Eingabe-Laufwerk, auf dem QPA ihre .MSG-Datei erwartet.

PAS: Dies ist der Eingabe-Pfad; normalerweise '0:', es sei denn sie benutzen ein CMDLaufwerk.

DP: Dies ist das Ausgabe-Laufwerk, auf dem QPA ihre .REP-Datei abspeichert.

PR$: Dies ist der Ausgabe-Pfad; normalerweise '0:', es sei denn sie benutzen ein CMD-Laufwerk. Beachten sie bei der Bngabe der jeweiligen Pfade bitte folgendes: Als Pfad wird '0:' eingestellt, wenn sie das Eingabefeld leer lassen. '0:" wird bei der Anzeige der Vorgaben nicht mitangezeigt!

Die Variable R$ ist bei QPA, so wie sie das Hilfsprogramm erhalten haben, gleich BBSID, alle Laufwerksnummern gleich D, dem Vorgabelaufwerk, und alle Pfade auf '0:' gesetzt. Sie können auf zwei Arten die Vorgabe verändern. Zum einen können sie, nachdem sie die Programmzeile 100 aufgelistet haben, den Namen ihres Mailpaketes an der Stelle von 'BBSID" einfügen; die Endung .MSQ dürfen sie dabei auf keinen Fall mitangeben, diese wird nämlich automatisch angefügt. Die Laufwerksadresse ihrer verwendeten Laufwerke geben sie bei jeder Dx=D-Auswahl mit an. Verwenden sie ein CMD-Laufwerk so müssen sie noch gegebenenfalls den Pfad mitangeben. Zum Schluß bestätigen sie ihre neu editierte Zeile 100 mit einem RETURN und speichern das geänderte File wieder auf ihre Arbeitsdiskette. Als zweite Möglichkeit, mit der sie ihre Daten eingeben können, ist die Änderung der Daten beim Programmablauf von QPA selbst.
Beachten sie bitte: Mit F$ haben sie die Möglichkeit ihre .MSG-Datei zu löschen, bevor das eigentliche .REP-File auf Diskette gespeichert wurde. Diese Option wurde für User mit nur einem kleinen Laufwerk implementiert. BENUTZEN SIE DIESE OPTION NUR, WENN SIE ÜBERHAUPT KEINE ANDERE MÖGLICHKBT HABEN. Sobald nämlich ihre Nachrichten in den Speicher gelesen und von der Diskette gelöscht wurden, können sie durch einen kurzen Stromausfall oder einem Diskettenfehler alle ihre Nachrichten unwiederruflich verlieren.

Sobald sie QPA gestartet haben, werden ihnen die Voreinstellungen am Bildschirm angezeigt. Anschließend werden sie gefragt, ob sie mit diesen Vorgaben einverstanden sind. Durch Druck auf eine beliebige Taste, außer der Taste "n", akzeptieren sie diese Daten. Drücken sie die Taste "n", so können sie jeden einzelnen Punkt entsprechend abändern, oder mit ENTER bestätigen. Die vorgegebene Laufwerksnummer entspricht dem gerade benutzten Laufwerk. Zum Ändern dieser Vorgabe, geben sie einfach die gewünschte Nummer z.B. 8, 9, ... an, oder sie geben ein "d" für die Übernahme des Defaultlaufwerkes an. Sobald sie ihre Eingabe beendet haben, werden sie erneut gefragt, ob sie die Eingaben übernehmen oder nochmals korrigieren möchten. Wollen sie die Angaben übernehmen, so drücken sie eine beliebige Taste außer "n". Nachdem Sie die Daten bestätigt haben, erfolgt eine Abfrage, ob sie diese Daten als Vorgabe für einen späteren Programmaufruf abspeichern möchten. Betätigen sie eine Taste, nicht jedoch die Taste "y", dann werden ihre Daten nicht abgespeichert, sondern lediglich für diesen Programmaufruf verwendet. Für den Porgrammablauf, bei den eben aufgeführten Abfragen, wurde eine Zeitschleife im Programm implementiert. Antworten sie auf eine Frage "Accept y/n" nicht, bevor die Zeit (ca. 10 sec.) abgelaufen ist, so wird als Antwort ein "yes" gewertet und dementsprechend im Programm fortgefahren.

Wollen sie ihre Änderungen auch bei einem erneuten Aufruf von QPA benutzen, so achten sie darauf, daß sich die Diskette, von der sie aus QPA geladen haben, im aktuellen Laufwerk befindet. Betätigen sie dann die Taste "y", so wird das Programm sogleich unter dem Namen QPA auf ihrer Diskette abgespeichert: eine bereits existierende Datei mit diesem Namen wird hierbei überschrieben. Anschließend wird QPA erneut, mit den aktuellen Daten, gestartet. QPA wird daraufhin den Maschinensprachetreil QPA.ML nachladen, eventuell dabei auftretende Laufwerksfehler melden, und den Namen ihrer .MSG-Datei anzeigen, die in das Archiv ‹bbsid›.REP gepackt werden. QPA wird ihnen jeden Fehler melden, der bei der Abarbeitung des Programmes auftritt. Diskettenfehler werden mit den jeweiligen Fehlernummem und Meldungen ausgegeben. Sollte das Nachrichtenpaket zu groß werden, wird eine entsprechende Meldung von QPA ausgegeben und der Programmablauf gestoppt. Der C=128 hat ausreichend Platz im Arbeitsspeicher für ein Datenfile mit etwa 249 Diskettenblöcken. Dabei ist es ihnen überlassen, solch ein Monster zu erzeugen; im praktischen Betrieb werden sie diese Grenze wohl kaum erreichen.

Traten keinerlei Probleme auf, so wird ihnen dies mit der Meldung "Finished!" am Bildschirm angezeigt. Sie können nun ihre ‹bbsid›.REP-Datei in ihre Mailbox schicken. Bei der Verwendung von QPA als Archivierungsprogramm wird keine Datums- und Zeitangabe mit archiviert; es wird bei jedem Archiv als Datum der 1 .April '93 gewählt.

Hinweise zu den CMO-Laufwerken und Verzeichnissen
QWKRR unterstützt die Unterverzeichnisse von CMD-Laufwerken voll. Hierzu werden zwei Pfadvariablen bei QPA verwendet:
PA$: Dies ist der Pfad, in dem ihre einzelnen Nachrichten von QWKRR abgespeichert wurden.

PR$: In diesen Pfad speichert QPA ihre ‹bbsid›.REP-Datei

Beide Variablen sind von Haus aus auf '0:' gesetzt. Sie können, wie Anfangs beschrieben, diese Pfade im Programmlisting oder beim Ablauf von QPA selbst, abändern. Fügen sie jedoch nicht '/:' am Ende ihres Pfades hinzu. Außerdem muß jeder Pfad mit der Partitionsnummer und zwei Schrägstrichen "px//" beginnen. z.B.: PA$="1//QWKRR 128/NACHRICHTEN".

Die Schreibweise der CMD-Unterverzeichnissen unterscheidet sich grundlegend von den 1581-Subdirectories und sind daher nicht kompatibel!


Anhang B		Anhang D

QWKRR128,

der Offline-Mail-Reader

für den Commodore C128

Anhang C