QWKRR128 - Der Offlinemailreader für den Commodore 128

Anhang B

QPX Anleitung
Mit QWX v4.0 kö sie ihre ARC-Mailpakete entpacken und mehrere Voreinstellungen für QWKRR treffen. Sie müssen hierbei nicht viel machen - ein Tastendruck und QWKRR128 wird nachgeladen

Copyright-Hinweise
Das Programm QPX wurde von Russell Prater und Rod Gasson geschrieben. Das Programm kann frei weitergegeben werden, solange dieses unverändert und keine Gebühr dafür verlangt wird. Möchten sie eigene Veränderungen an dem Programm vornehmen, so tun sie dies. Einzige Voraussetzung hierzu ist, daß sie einen anderen Fielnamen verwenden und ihr Programm nicht mit dem originalen Programmarchiv hinzufügen. Dadurch können sehr einfach Mißverständnisse von vornherein ausgeschlossen werden.
QPX benötigt zum Programmablauf CSX128-ML von Chris Smeets ©. CSX128.ML ist in dem gepackten File CSX01.SDA, einem C64-Archiv (!) enthalten. Kein Teil von CSX01.SDA darf in irgendeiner anderen Form, als der *.SDA und ohne ausdrückliche Zustimmung des Copyright-Inhabers weitergegeben werden.

Installation von QPX
Kopieren Sie QPX und CSX128.ML auf ihre Arbeitsdiskette, am besten auf dieselbe Diskette, auf der sichn auch QWKRR128 befindet. Sie sollten für QPX v4.0 der Einfachheit halber als Programmnamen QPX benutzen, da dieser Name von QPX selbst verwendet wird, wenn sie ihre Änderungen im Programm abspeichern. So wie Sie QPX erhalten haben, werden Ihre Laufwerksnummern und die entsprechenden Dateinamen nicht stimmen. Damit sie nun QPX ihren Wünschen entsprechend anpassen können, wurde eine Vorkehrung getroffen. Es ist nun dabei wichtig, daß sie wissen, welche userdefinierten Variablen im Programm verwendet werden. Das Programm wird ihre Eingaben nicht auf die Richtigkeit hin überprüfen, achten sie daher auf eine korrekte Eingabe. Es werden ihnen lediglich ihre eingegebenen Daten zur Kontrolle nocheinmal angezeigt, damit sie diese gegebenenfalls nochmal berichtigen können.

R$: Dies ist der Name des QWK MAIL-Paketes. Benutzen Sie zum Downloaden ihres Mailpaketes das Y-Modem-Protokoll, so wird der Name von ihrer Mailbox, in der Form ‹bbsid›.QWK vorgegeben und sie müssen diesen Namen bei dieser Variable eingeben. Beachten Sie hierbei die Groß- und Kleinschreibung. Benutzen Sie hingegen z.B. das X-Modem-Protokoll, so können sie jeden beliebigen Namen verwenden.

K$: Sollte es vorkommen, daß QPX sich aufhängt, nachdem die notwendigen Dateien aus dem Archiv entpackt wurden, müssen sie diese VAriable auf "y" setzen. Dieser Fehler tritt auf, wenn sie mit Desterm V2.00 ihr Datenpaket aus einer Maximus oder einer EzyCom-Mailbox holen. Mit Setzen dier Variable auf "y" aktivieren sie einen kleinen Patch, bei dem dieser Fehler umgangen wird. Wenn Sie Dialogue 128 verwenden, ihr Datenpaket aus einer anderen Mailbox holen, oder keine Probleme nach dem Entpacken ihres Mailpaketes auftreten, so setzen sie diese Variable einfach auf "n".

D$: QWKRR Laufwerkseinstellungen sollen verwendet werden. Setzen sie diese Variable auf "y", so wird QWKRR die Laufwerke verwenden, die in der Datei QWK.DEFAULTS festgelegt wurden. Sollte dieses File nicht existieren, was eigentlich gar nicht sein darf (!), oder wenn diese Variable auf 'n' gesetzt ist, wird nach dem Start von QWKRR das Programm angehalten, damit sie ihre Laufwerkseinstellungen vornehmen können.

N$: Setzten sie diese Variable auf "y", dann wird ihr Nachrichtenpaket automatisch nach dem Start von QWKRR 128 indiziert.

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

Dl: Dies ist das Eingabe-Laufwerk, auf dem ihr Mailpaket stehen sollte.

PA$: Dies ist der Bngabe-Pfad; normalerweise '0:', es sei denn sie benutzen ein CMD-Laufwerk.

DP: Dies ist das Ausgabe-Laufwerk, auf dem die entpackten Dateien (*.DAT) geschrieben werden.

PR$: Dies ist der Ausgabe-Pfad; normalerweise '0:', es sei denn sie benutzen ein CMD-Laufwerk.

DQ: Adresse des Laufwerkes, von dem QWKRR gebootet werden soll.

PQ$: Dies ist der QWKRR-Pfad; normalerweise 'O:', es sei denn sie benutzen ein CMD-Laufwerk. Beachten sie bei der Eingabe der jeweiligen Pfade bitte folgendes: Als Pfad wird '0:' eingestellt, wenn sie das Bngabefeld leer lassen. '0:' wird bei der Anzeige der Vorgaben nicht mitangezeigt!

CT$: Setzen sie diese Variable auf "y", so wird das aktuelle Datum mit Uhrzeit dem gerade entpackten Mailpaket (CONTROLDAT) entnommen. Verwenden sie ein CMD-Laufwerk mit einer Echtzeituhr, so werden diese Daten einfach ignoriert. Sie müssen diese Variable lediglich auf "n" setzten, wenn sie eine andere Methode zum Setzen der Uhrzeit und des Datums verwenden, wie z.B. Smartwateh oder Übernahme der Uhrzeit von Dialogue 128. Stellen sie die Uhr mit Hilfe dieser Methode, so wird diese Zeit in der Regel nicht 100% stimmen; zum Bearbeiten ihres Mailpaketes dürfte dies jedoch reichen.

Die Variable R$ ist bei QPX, so wie sie es erhalten haben, gleich "mail.qwk", K$, der Maximus-Pateh ist auf 'n', die Autoindexfunktion nicht und 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 'mail.qwk' einfügen. 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, Die zweite Möglichkeit, mit der sie ihre Daten eingeben können, ist die Änderung der Daten beim Programmablauf von QPX selbst.

Sobald sie QPX 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, auBer 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 QPX benutzen, so achten sie darauf, daß sich die Diskette, von der sie aus QPX geladen haben, im aktuellen Laufwerk befindet. Betätigen sie dann die Taste "y", so wird das Programm sogleich unter dem Namen QPX auf ihrer Diskette abgespeichert; eine bereits existierende Datei mit diesem Namen wird hierbei überschrieben. Anschließend wird QPX erneut, mit den aktuellen Daten, gestartet. QPX wird daraufhin den Maschinenspracheteil CSX128.ML nachladen, eventuell dabei auftretende Laufwerksfehler melden, und den Namen des zu entpackenden ‹bbsid›.QWK-Paketes anzeigen. QWKRR benötigt lediglich die CONTROL.DAT und die MESSAGE.DAT-Files, alle anderen Dateien werden nicht benötigt. Diese Dateien werden beim Entpackvorgang einfach übersprungen und lediglich am Bildschirm angezeigt, so daß sie den gerade laufenden Entpackvorgang am Bildschirm mitverfolgen können. QPX wird ihnen jeden Fehler melden, der bei der Abarbeitung des Programmes auftritt. Diskettenfehler werden mit den jeweiligen Fehlernummern und Meldungen ausgegeben. Nachdem die *.DAT-Files entpackt wurden, wird QPX automatisch QWKRR nachladen und ihre Nachrichten indizieren, je nachdem wie sie die entsprechenden Optionen eingestellt haben. Sie können somit mit nur einem Tastendruck ihr Mailpaket entpacken, QWKRR 128 booten, die Nachrichten indizieren und nach einer kurzen Wartezeit ihre Mitteilungen bearbeiten.

Hinweise zu den CMD-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 muB jeder Pfad mit der Partitionsnummer und zwei Schrägstrichen "px//" beginnen.

Beispiel: Sie haben ihr Mailpaket auf ihrer Festplatte in Partition 3, Unterverzeichnis "DOWNLOADS' abgespeichert, so mÜssen sie die entsprechende Pfadvariable PA$="3//DOWNLOADS" setzen. FÜgen sie, wie schon erwähnt, nicht '/:' am Ende ihres Pfades an, QPX macht dies automatisch und es wÜrde sonst ein SYNTAX-ERROR erzeugt!

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


Anhang A		Anhang c

QWKRR128,

der Offline-Mail-Reader

für den Commodore C128

Anhang B