Eine kleine Hilfe zum Offline-Prozessor
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Bitte UNBEDINGT lesen!

-------------------------------------------------------------------
INHALT

0.    Allgemeines
1.    Richtlinien fuer Nutzung des Services
2.    Erzeugen eines/mehrere QWK-Packete(s)
3.    Download von fertigen QWK-Files
4.    Richtlinien fuer die Arbeit mit dem QWK und beim Offline-Arbeiten
5.    Upload eines Reply-Files
5.1.  Allgemein
5.2.  Was bei News-Artikeln zu beachten ist....
5.3.  Wie Mails versendet werden 
6.    QWK-Mail-Server (Offline-Processor)
7.    Einstellungen fuer Server-Prozess (Optionen, Gruppen.....)

-------------------------------------------------------------------

0. Allgemeines

Achtung: Nachfolgende Beschreibung bezieht sich auf den qwk-Mode des
Offline-Prozessors! Bei SOUP/SLNP bestehen _keine_ deratigen Limits etc!
 
Mit Hilfe des QWKs ist es normalerweise nur in kleinen Systemen 
moeglich einfach Offline-Packete zu erzeugen, die dann unter einem der
vielen bekannten QWK-Reader zu Hause (oder wo anders ;-) gelesen und
beantwortet werden koennen. Das dabei resultierende 'Reply'-File kann dann
wieder in der BBS via Upload eingespeist werden, die neuen Artikel werden
dann in den jeweiligen Brettern eingeordnet. 
Im Usenet ist das damit nicht mehr so einfach moeglich, da vor allem durch
die Groesse und der Anzahl der 'neuen' Nachrichten  je Tag dieses durch die
QWK-Format-Spezifikation nicht mehr voll bewaeltigt werden kann. 
 Einschraenkungen durch QWK-Spezifikation:
  - Header-Zeilen werden effektiv durch 15..25-Zeichen-Format verstuemmelt,
    Replys sind da direkt kaum noch moeglich
  - Gruppen-namen werden natuelich auch voll an dieser Position
    abgeschnitten
  - max. 0.5MB (das packen schon einige QWK-Reader nicht mehr richtig) je 
    je QWK-Packet, zumindest bei vielen Readern.....
  - lange Pack-Zeiten, die bei groesser Anzahl von Artikeln sofort ins
    Gewicht fallen
  - ein grosser Artikel und das QWK-Archiv ist mit einem 1/2 Artikel mehr 
    als voll :(
  - max. 999 Konferenzen (Gruppen) moeglich - das wird bereits bei jedem
    kleinen Usenet-System ueberschritten
  - News-Server normalerweise nur im Netz verfuegbar
  - Reply-Header der jeweiligen Artikel werden in der Regel nicht durch 
    Offline-Reader-Programm auf User-Seite richtig generiert, da die
    eigentlich gar nicht existent sind......
  - usw.


Daher habe ich versch. Zusaetze einbauen muessen, damit dies dennoch
moeglich ist:
 - automatische Konvertierung des Usenet-Gruppen-Namen auf max 15 Zeichen,
   zugehoerigens Gruppen-Konvertierungs-File ist offline als 'LOGOFF.DAT' 
   im QWK-File lesebar. 
 - aktuelles Gruppen-Konvertierungs-File kann max. 999 Konferenzen (Gruppen)
   enthalten. Das ist durch das QWK-Format spezifiziert. Man kann also mit 
   dieser Methode max. diese Zahl je User bestellen. Bei jeder neuen 
   Gruppe wird automatisch eine neue Registierung durchgefuehrt. 
   Die Registrier-Datenbank bleibt bei jedem User induviduell erhalten, jede
   Gruppe, die einmal mit eingepackt wurde, kommt in diese. Wenn man mal die
   Zahl 999 erreicht hat, bricht der QWK-Server automatisch mit dem
   QWK-Prozess ab. In diesem Fall ist diese Datenbank im QWK-Setup auf NULL
   zu setzen. Aber Achtung! Zu diesem Zeitpunkt sind die bis dahin gueltigen 
   Zuordnungen Gruppennamen<->Konferenz-Nummern ungueltig und werden im
   Laufe der Zeit wieder 'rekonstruiert'. Das bedeutet also, dass ein Upload 
   eines 'alten' Reply-files zwar funktioniert, jedoch alle Newsartikel in
   falsche Gruppen gepostet werden!!!!! Also Vorsicht!
 - es wird immer eine Gruppe nach der anderen 'abgearbeitet'.
 - zu lange Artikel (frei einstellbar zwischen 8012bytes...400kbytes) werden
   einfach ignoriert
 - Bei EMail-Adressen, die ueber 25-zeichen hinausgehen, ist ein Mailen
   ueber einen Nicknamen durch Eintrag in das persoenliche (Online) Adress-
   buch moeglich. Der QWK-Server erkennt auch automatisch externe ALIAS-
   Mail-Adressen, die evtl. ein BBS-User gesetzt hat, oder wenn User-Level
   zu klein ist oder.... Der QWK-Server arbeitet also bei Reply-Upload etwa 
   genau so, als wenn Du Oneline am BBS-Prompt waest ;)
   Spaeter ist eine Opion im Offline-Processor (QWK-Mail-Server) geplant,
   der eine Offline-Pflege des privaten Adressbuches erlaubt.
 - Wenn ein Artikel in einem Brett mit 'private' beantwortet wurde, wird
   automatisch vom Server ein EMail gereriert (Reply to...). Ausserdem 
   wird betreffender Artikel auch in die Newsgruppe gepostet. Wer dem Autor
   nur eine  persoenliche Mail zukommen lassen will (ohne diese auch in die
   Gruppe zu posten), muss diese dann _NUR_ in die Konferenz "Email"
   schreiben. Wenn der Autor keine persoenliche Nachricht bekommen, nur
   der Artikel in die Gruppe gepostet werden soll, ist als 'Empfaenger'
   _IMMER_ "ALL" einzutragen. 
 - die 'richtigen' (langen) aktuellen Newsgruppen sind aus dem Kon -
   vertierungs-File oder aus der ersten Zeile des jeweiligen Artikels
   sichtbar.
 - News+Mail-Haeder werden automatisch nachgeneriert
 - QWK-Prozesse koennen mehrfach in einer Warteschlange geschickt werden,
   die ein QWK-Server der Reihe nach (im Hintergrund) abarbeitet ...
 - QWK-Uploads koennen im Hintergrund verarbeitet werden. Der QWK-Server
   generiert dabei eine STATUS-Mail fuer das private Postfach.
 - QWK-Server und QWK im Direkt-Mode darf nie zusammen (gleichzeitig)
   genutzt werden!!!!!
 - soup (slnp..) experminentell mit im src implementiert

Wer den QWK-Service nutzen will, sollte sich auch unbedingt an die
NETIQUETTE halten. Wer davon noch nie etwas gehoert hat, sollte zuvor
unbedingt mit Hilfe es 'INFO'-Befehls diese und das andere dazu lesen. 

-------------------------------------------------------------------  


1. Richtlinien fuer Nutzung des QWK-Services
Da die BBS nur als GAST-Account gedacht ist, der nur als Schnuppen-Account
dient, ist betreffender QWK-Service derzeit nur zu experimentellen Zwecken 
aktiviert. Eine Einschraenkung des Services auf bestimmte Gruppen /
Volumen ist daher schon im Gespraech. 
Wer vernuenftig News+Mail Offline lesen will, sollte dann doch lieber einen
UUCP oder IP-Account nehmen (alles weitere steht in den Info-Seiten der
Boerde, Befehl 'lynx').


-------------------------------------------------------------------

2. Erzeugen eines/mehrere QWK-Packete(s)
Zuvor sollte man noch einmal genau sehen, welche Gruppen bestellt wurden
sind. Dazu nutzt man den Befehl 'cd' (im GEOnet-Mode). Danach ist der Befehl
"QWK" zu starten, wo man ueber ein kleines Menue nochmal die Einstellungen(9)
ueberpruefen kann. 
Nun hat man die Wahl, ob der QWK-Daemon im Direkt- (3) oder im Server-Mode
(4) laufen soll. Dabei ist eigentlich letzteres das Guenstigeste, da der
Prozess im Hintergrund laeuft und man in der BBS weiter arbeiten kann. Alle
dabei anfallenden Meldungen werden in eine Datei geschrieben, die man ueber
den 'view'-Befehl in der QWK-Shell (6) ansehen kann. 
Falls der QWK-Prozess (aus welchem Grund auch immer: nntp-Server nicht
verfuegbar....) irgendwo stecken bleibt, wird selbst versaendlich keine 
Logdatei geschrieben. In diesem Fall ist der QWK-Prozess (vorerst) noch mal
im 'Direkt'-Mode (3) aufzurufen, wobei kein Logfile erzeugt wird, jedoch
alle Meldungen 'oneline' ueber den Screen scrollen. 
Am Menuepunkt(6), der QWK-Shell, werden auch alle fertigen QWK-Packete
angezeigt. Der 'Task'-Befehl in dieser Shell listet alle noch in der
Warteschlange befindlichen QWK-Auftraege auf.
Wenn der QWK-Server eine Warteschlange abarbeitet, ist dieses Prozess (noch)
nicht in der QWK-Shell sichtbar. Um zu sehen, ob noch der QWK-Server taetig
ist, kann man in der GEOnet-Hauptshell den 'ps xa' Befehl nutzen, der alle
derzeit auf der Unix-Kiste laufenden Prozesse auflistet (der Prozess ist
dann 'uqwk .....').

 
-------------------------------------------------------------------


3. Download fertiger QWK-Packete
Im QWK-Menue ist ueber (6) eine QWK-Shell verfuegbar, in der dies ueber den
Befehl "download id" moeglich ist. Dabei ist zu beacheten, dass immer das
QWK-File 'system.qwk' heisst, also jedes QWK-packet den selben Namen hat.
Das ist fuer eine DOS-QWK-Reader notwendig. 
Wenn man alle seine, im Spool-Pfad liegenden, QWK-Packete gleichzeitig holen
moechte, ist dies ueber 'download *' moeglich. Dabei ist zu beachten, dass
danach das '1.zip' usw. per Hand in 'system.qwk' umzubenenen ist. 



-------------------------------------------------------------------

4.QWK-Mail-Server (Offline-Processor)

     ->  Noch in Entwicklung - bitte nicht nutzen !

 Das einzigste, was gehen muesste, ist 'HELP' 'GROUPS' 'ALLGROUPS'
 Man schickt einfach eine EMail (Konferenz 0) an "QWK". Das Subject ist
 dabei voellig egal. Im Kopf der Message muss dann der jeweilige 
 Befehl stehen.....
 Es ist auch eine Reihe von Befehlen moeglich, wobei jeder in einer 
 neuen Zeile stehen muss.
 Das Resultat des Offline-Processors wird dann in die PM gesendet.

-------------------------------------------------------------------

5. Upload eines Reply-Files
5.1.  Allgemein
 Das QWK-Reply-File ist mit einem ueblichen QWK-Reader zu erzeugen.
 Dabei sollte zuerst getestet werden, ob der betreffende Reader die 
 BBS-ID korrekt zurueckgibt. Dazu ist ein Test-Reply (Mail an sich oder
 so...) zuvor einzuspielen (im Direkt-Mode). 
 Ich habe den QWK-Server mit "UniQWK" (unter Win3.11) getestet, was problem-
 los lief. Betreffender Offline-Reader liegt hier in der FileBase in der
 Area "bbs.bin       Terminals und Offline-Reader, etc."

 Wichtiges zum Upload:
 Man kann den Reply-Upload im Direkt- oder Hintergrund-Mode vornehmen.
 Im ersten Fall kann man genau beobachten, was der Daemon-Prozess macht, im
 zweiten Fall bekommt man ein Status-Mail, dass alles enthaelt.


"To:"-Feld im QWK-Reader reicht fuer Empfaenger-EMail-Adresse nicht aus:
 Es ist moeglich in der ersten oder zweiten Zeile eine zusaetzliche 
 "To: ...." oder/und "Subject: ..." Zeile einzufuegen, die die Eintraege 
 im QWK-Reply 'ersetzt'. 
 Das ist dann unbedingt noetig, wenn die Zeichem-Laenge 25Chars bei Mail-
 Adresse usw. nicht ausreicht! Das QWK-Format erlaubt es sonst anderes
 nicht.


5.2.  
 Was bei News-Artikeln zu beachten ist....

 Wenn ein neuer Artikel gepostet werden soll, ist dieser _IMMER_ an 
 die an "ALL" zu senden. Wenn man betreffenden Artikel an
 eine andere Mail-Adresse sendet, wird dieser ein Reply auf ... draus 
 erzeugt. 
 Wenn nur der Autor, oder wer eben sonst diese EMail-Adresse
 hat, diese Message bekommen soll, ist die _IMMER_ in die Konferenz "Email"
 (konferenz 0) zu senden. 
 News kann nur versendet werden, wenn der NNTP-Server-1 (der Haupt-Server,
 nicht der zweite, der automatisch umstellt, falls der erste ausser Betrieb
 ist) fuer das Posten im Netz verfuegbar ist und wenn man als User das 
 entsprechende Level hat (siehe Level-befehl). Wenn also bei Login in der
 bbs keine Fehlermeldung betreffs nntp-server gekommen ist, ist dieser auch
 verfuegbar ("NewsStat"-Befehl).
  
 Wenn ein 'langes Subject' genutzt werden soll, ist dass als erstes eine
 zusaetzliche "Subject: ..." Zeile einzufuegen! Diese wird dann, anstatt 
 der aus dem 'QWK-Subject'-Header genommen.
 


5.3.  
 Wie Mails versendet werden (vom internen Mail-Server)...
 
 
 Reihenfolge beim Versenden von Mail (beim bbs-mailer-daemon):
 1. Test ob Mail extern ist ("@" oder "!" enthaelt), und versenden, falls
    Levels entspr. ok sind.......... oder
 2. ist der User im privaten Oneline-Adressbuch (derzeit nocht nicht!)
    ... oder
 3. Test ob User in der BBS-User-Base ist, wobei der User auch abgekuerzt 
    werden, oder beim Nickname genannt werden kann. Es wird immer an den 
    ersten Benutzer mit der Uebereinstimmung diese Mail gesendet. 
    Wenn man ganz genau gehen will, sollte man also z.B. nicht diese Mail 
    an "S" schicken, sondern lieber "Sylvio Runge" ausschreiben. Einige 
    QWK-Reader lassen nur einen Namen zu. In diesem Fall kann man auch 
    "Sylvio.Runge" schreiben. Der BBS-Mailer-Daemon ignoriert dabei den '.'
    automatisch bei Bedarf.
    Wenn der 'andere' User (oder Sysop :-) eine alternative EMail-Adresse 
    gesetzt hat, wird automatisch sofort an diese weitergeleitet.
    ... oder
 4. Generierung einer Fehler-Mail und Versand in die PM

  

-------------------------------------------------------------------

6. Einstellungen fuer Server-Prozess (Optionen, Gruppen.....)
 
 -Im QWK-Menue 'EInstellungen' waehlen:
  Bitte unbedingt testen, ob 'Maximal-Groesse' der einzelnen News-Artikel
  ab mind. 8012 Bytes eingestellt (vor allen bei 'alten Usern' !!!) ist. 
  Sonst wird kein Artikel in das QWK-Archiv gepackt, da alles, was groesser 
  als die EInstellung 100Bytes ist ignoriert wird (also alles) :)
  Aus Gruenden der Eindeutigkeit sollte man die Header voll mit bestellen,
  nur so kann man gezielt noch ein Reply an den Autor machen :-)

 -News-Gruppen bestellen:
  Dazu muss derzeit Oneline der "Bestellen"- Befehl  benutzt werden. Dazu 
  existiert in der BBS eine umfangreiche Hilfe-Seite ("Hilfe Bestellen").
  Der Einstellungen des 'AREA'-Befehls sind im QWK-Prozessor ohne Bedeutung.
  Es ist darauf zu achten, dass nicht zu viele Gruppen bestellt sind....

 -Die aktuellen Artikel-Zeiger sind nur innerhalb des QWK-Prozessors
  gueltig. Sie koennen ueber das QWK-Menue zurueckgesetzt werden.

-------------------------------------------------------------------

7. Fehler beim Lesen der QWK-Files?

Fals Du Fehler beim Lesen dieser Files hast, lese bitte die Hilfe in Deinem
Reader, welche Grenzen er hat, und stelle diese dann im QWK-Setup
ein. 
Es existiert eine 'setzte Standard'-Option bei 'Einstellungen', mit der
eigentlich jeder Reader klar kommen sollte (Start-Werte).
Lange Gruppennamen sind standard-maessig auch auf 'aus', da einige Reader
bei zu langen Namen eine Crash hinlegen (ist halt kein Linux :)
Also bitte diese nur aufschalten, wenn es Dein Reader sicher vertraegt!







-------------------------------------------------------------------


                                   -> wird mal weiter ausgebaut.... :-)