Metropoli BBS
VIEWER: xpslip.txt MODE: TEXT (CP437)
			    (c) Dec 1994 by khweis@mvmpc9.ciw.uni-karlsruhe.de
						     
			    XP_SLIP
			    -------

'xp_slip' ist ein Programmpaket fuer DOS, mit dem man News und Mail ueber
eine tcp/ip-Verbindung automatisch holen und versenden kann um
sie spaeter mit einem Offline-Reader bearbeiten zu koennen. Ich habe
dieses Paket speziell an 'CROSSPOINT' von Peter Mandrella angepasst.
Hier muss lediglich eine ZConnect-Box im 'Sysop-mode' eingerichtet
werden und 'x_slip.bat' als 'Importfilter' eingetragen werden.
Danach wird diese 'Slipbox' genauso behandelt, wie jede andere
Mailbox unter Crosspoint auch. 

Der Austausch von News und Mail ueber einen tcp/ip (Slip)-
Zuganng hat gegenueber dem Mailtausch mitttels 'uucp'-Protokoll
einige Vorteile:

- Man muss nur _einen_ Rechner konfigurieren (naemlich den eigenen)
- Das Programm funktioniert unabhaengig von einem speziellen Server
  ueberall dort, wo man einen tcp/ip-Zugang hat - das kann auch
  ein direkter Zugang zu einem lokalen Ethernet sein (dann benoetigt
  man einen Packetdriver fuer die Netzkarte anstelle des Slipdrivers)
- News und Mail sind immer auf dem aktuellen Stand, ausgehende
  Mail wird unmittelbar in das Netz weitergeleitet.
- Man belegt keinerlei Plattenplatz oder Rechenzeit auf einem
  speziellen Server.

Natuerlich gibt es auch einen Nachteil: News und Mail werden ungepackt
uebertragen, sodass die effektive Uebertragungsrate geringer ist, als
bei einem Transfer von gepackten Batchfiles mittels uucp (etwa 2000cps
gegenueber knapp 3000cps bei einer Slipverbindung mit V42/V42bis bei
14400 bps)

Arbeitsweise
-------------
Beim Start eines Netcalls wird x_slip.bat aufgerufen. 
Dieses startet den 'uuz'-Konverter (Bestandteil von Crosspoint)
um Mail und News vom ZConnect-Format in die RFC-kompatible Form
zu bringen. Dann wird x_script gestartet. Dieses Programm
interpretiert ein Skriptfile (x_script.cfg), dass vom Anwender
an die eigenen Beduerfnisse angepasst werden kann. Nachdem
das Skriptfile abgearbeitet wurde, wird wiederum der uuz-
Konverter gestartet, diesmal aber in umgekehrter Richtung, d.h
die im RFC-Format vorliegende Mail und News werden in das 
ZConnect-Format konvertiert und anschliessend von Crosspoint
eingelesen.
 
Die von 'x_script verwendete Skriptsprache ist ein leicht 
durchschaubares Pseudobasic mit einigen Spezialkommandos
zur Behandlung der seriellen Schnittstelle. Damit lassen
sich 'intelligente' Waehlskripts erstellen, Files modifizieren,
Dos-Programme starten usw... Die anliegenden Beispielskripts
sind (hoffentlich) selbsterklaerend und koennen als Grundlage
fuer eigene Skripts verwendet werden. Ich werde eine ausfuehrliche
Beschreibung von x_script zusammen mit dem noch zu schreibenden
skriptfaehigen telnet-Client veroeffentlichen. Die allernotwendigsten
Hinweise zur Syntax finden sie in 'x_xcript.doc.

Installation
------------
1. Verzeichnis \xp\x_slip einrichten und xp_slip.exe dort entpacken.
   (Selbstextrahierendes File). Falls Ihr Crosspoint nicht in \xp\
   liegt, muessen sie die entsprechenden Pfade in import.bat und 
   export.bat und im Crosspoint-setup anpassen! 

   ACHTUNG: alle zu xp_slip gehoerenden Programme erwarten die zugehoerigen
	    Konfigurations-  Mail- und Newsfiles im selben Verzeichnis,
	    in dem auch die Programme laufen. 

2. x_script.cfg modifizieren. 
   (s. auch x_script.doc)

   $PORT=2     das ist die Nummer ihrer seriellen Schnittstelle (1-4). Oder:
   $PORT=2f0   Wenn sie eine von der Standardbelegung abweichende Adresse
   $IRQ=5      haben, muessen Sie statt der Portnummer, die richtige 
	       Portadresse eintragen (entweder dezimal oder in der
	       gezeigten hexadezimal-Notation) sowie die zugehoerige
	       Interruptnummer hinzufuegen.
   $BAUD=38400 Dies ist die Baudrate ihrer Schnittstelle. Ohne Angabe
	       wird 38400 als Default genommen.
   opencom     Dieses Kommando initialisiert die serielle Schnittstelle. 

Die nun folgenden Variablen koennen frei vereinbart werden:
Login=         Ihr Login-Name
Password=      Ihr Passwort  
initstring=    Init-String Ihres Modems
redialtimeout= Wartezeit vor Wiederwahl
   
Die restlichen Zuweisungen betreffen IP- und Portnummer von News-
SMTP- und Popmailserver sowie den zu verwendenden Packetdriver.
Es stehen 'slipper' und 'cslipper' zur Verfuegung. Letzterer verwendet
Header-Compression - aber das laeuft nur, wenn der Slipserver 
ebenfalls fuer compressed Slip eingerichtet ist.

3. Crosspoint einrichten:
--------------------------
ZConnect Box einrichten. Unter /Edit/Boxen/Edit/Namen:

k┌───────────────────────────────────────────────────────────────────┐
n│√ rzstud1┌─ uc2p @ rzstud1  ─────────────────────────────┐         │
s│         │                                               │         │
a│         │  Boxname     rzstud1                          │         │
a│         │                                               │         │
m│         │  Username    uc2p                             │         │
 │         │                                               │         │
 │         │  Kommentar                                    │         │
 │         │                                               │         │
 │         │  Realname    Katharina Weiss                  │         │
 │         │                                               │         │
 │         │  Domain      rz.uni-karlsruhe.de              │         │    
 ├─────────└───────────────────────────────────────────────┘─────────┤
 │   Neu      Löschen      Wählen     Edit     Netztyp       OK      │
 └───────────────────────────────────────────────────────────────────┘

Unter Edit/diverses:

   ┌─ Verschiedene Einstellungen ────────────────────────────┐
   │                                                         │
   │  Online-Anruf     Paßwort   GEHEIM                      │
 MV│                   Logfile                               │
   │                   Script                                │
   │                                                         │
   │  Netzanruf        Ausschluß-  von    :     bis    :     │
   │                   zeiten:     von    :     bis    :     │
   │                               von    :     bis    :     │
   │                               von    :     bis    :     │
   │                                                         │
   │                   Script                                │
   │                                                         │
   │  Eingangsfilter    \xp\x_slip\x_slip.bat                │
   │                                                         │
───│                                                         │─
  N│  Sonstiges        [x]   /Netcall/Alle                   │
───│                                                         │─
   └─────────────────────────────────────────────────────────┘

unter Edit/Sysopmode:

/k┌───────────────────────────────────────────────────────────────────┐
/n│√ RZSTUD1     ZConnect    khweis                                   │
/s│   ┌─ Sysop-Mode ───────────────────────────────────────────────┐  │
/a│   │                                                            │  │
/a│   │  Eingangspuffer    \XP\X_SLIP\INFILE.Z                     │  │
/m│   │                                                            │  │
  │   │  Ausgangspuffer    \XP\X_SLIP\OUTFILE.Z                    │  │
  │   │                                                            │  │
  │   │  Startprogramm                                             │  │
  │   │                                                            │  │
  │   │  Endprogramm                                               │  │
  │   │                                                            │  │
  │   │   [x]   /»Netzanruf-Bericht                                │  │
  │   │                                                            │  │
  │   └────────────────────────────────────────────────────────────┘  │
  ├───────────────────────────────────────────────────────────────────┤
  │   Neu      Löschen      Wählen     Edit     Netztyp       OK      │
  └───────────────────────────────────────────────────────────────────┘


   Die Konfiguratuion ist damit vollstaendig. Vor dem Start eines
   Netcalls, sollten sie zunaechst den Verbindungsauffbau zum
   Slipserver mit dem beigefuegten test.cfg testen, Aufruf: x_script test.cfg
   Dieser Aufruf stellt eine Telnetsession mit manuellem Login her.
   Probieren sie dann x_script.cfg aus (Aufruf: x_script, das Skriptfile
   'x_script.cfg' wird automatisch als default-Skriptfile genommen).
   Dieser Script sollte auf der rzstud1 problemlos laufen.

   Ablauf eines Netcalls:
   'export.bat' konvertiert ausgehende Mail in das RFC-Format. Danach
   folgen Dialup-Login-PPL. Nachdem PPL die Slipverbindung installiert
   hat, werden der Reihe Nach News- Mail und Popmail- Client gestartet.
   (Nicht gewuenschte Dienste sollten sie mit '#' auskommentieren.)
   nachdem der letzte Client seine Arbeit beendet hat, wird die
   Verbindung beendet (hangup), dann die eingehende Mail von 
   'import.bat' in das Crosspoint-Format konvertiert. Hiermit
   endet xp_slip und Crosspoint beginnt mit dem Einsortieren von
   Mail und News (oder sie starten zuvor noch ein Importfilter,
   z.B. 'cs' wie gezeigt.)

   Hinweis: Eine Newssession kann jederzeit mit Escape abgebrochen werden.
   Mit 's'(skip) wird eine Gruppe uebersprungen. Falls irgendwas schieflaeuft
   und der Client 'haengt', koennen Sie versuchen mit ctrl-break den tcp/ip-
   stack zu beenden. Es gibt Situationen (z.B. Verbindungsabbruch), in denen
   das nicht moeglich ist. Dann hilft leider nur ctrl-alt-del. (Ueber eine
   Wiederwahlmoeglichkeit bei laufender Session, denke ich z.Zt. intensiv
   nach ;-)

x_news.src
----------
Dieses File enthaelt die von Ihnen gelesenen Gruppen, gefolgt von  einer
Nummer. Die Nummer ist die Artikelnummer des zuletzt gelesenen Artikels.
Wenn sie eine neue Gruppe einrichten, koennen sie ...

-  die Nummer einfach weglassen - dann versucht das Programm die letzten
   100 Artikel (Variable New_max in x_tcp.cfg) anzufordern. 
-  negative Zahl eintragen - dann  versucht das Programm die angegebene
   Artikelzahl zu holen.
-  '0' eintragen  - dann versucht das Programm _alle_ Artikel der jeweiligen
   Newsgroup zu holen (Vorsicht!)
-  Eine komplette Liste mit allen Newsgruppen wird angefordert, wenn Sie
   '$LIST > zielfile' in x_news.src eintragen. (Dieser Einrag wird nach
   Erhalt der Liste automatisch geloescht). Auch andere Kommandos, z.B.
   '$NEWGROUPS...' sind moeglich. (Syntax s. einschlaegige RFC's)
-  Zum 'auskommentieren von Eintraegen wird '#' veerwendet
   (wie in allen von mir verwendeten Skriptfiles)   
  
                          x_script                     
                        -------------
Eine vorlaeufige Beschreibung des Skriptsprache befindet sich
in x_script.txt
    
Wichtiger Hinweis
-----------------
1. x_slip ist noch im Betastadium. Lassen sie es bitte nicht unbeaufsichtigt
   laufen und stellen sie sicher, dass bei einem durchaus moeglichen 
   Protokoll-Problem (x_slip 'haengt' dann) die Verbindung zum Server
   auch vom Modem alleine (oder einer Zeitschaltuhr) unabhaengig von 
   x_slip beendet werden kann! Sie benutzen x_slip auf eigenes Risiko!

2. xp_slip verwendet als tcp/ip Kernel den (frei verfuegbaren) 'waterloo-tcp' 
   von Erik Engelke, sowie die slipdriver '(c)slipper' von Peter Tattam.
   Beide Programme sind frei zur nicht-kommerziellen Nutzung, die
   Rechte an diesen Programmen bleiben selbstverstaendlch bei dem jeweiligen
   Autor! Fuer die Nutzung von Crosspoint gelten die Lizenzbestimmungen 
   von Peter Mandrella in 'Lizenz.doc' im Crosspoint-Paket.

   Alle anderen Programme, Batchfiles, doc-files usw. sind 'auf meinem Mist'
   gewachsen und duerfen frei (im Sinne von nichtkommerziell) verwendet
   und weiter verbreitet werden. Ein Hinweis auf meine Autorenschaft 
   und die Beifuegung dieses Dokuments sind dabei Bedingung. Nach der
   endgueltigen Fertigstellung aller Programme werde ich auch die 
   Sourcen zur freien Verfuegung stellen. 

3. Kommentare und Hinweise auf Fehler oder moegliche Verbesserungen
   an:

Karl-Heinz Weiss    Voice:  07244-1792 (priv.) 0721-608-2418 (Uni)
Eulenweg 2          E-mail: khweis@mvmpc9.ciw.uni-karlsruhe.de 
7504 Weingarten     Fido: Karl-heinz Weiss 2:2476/17.19
----------------------------------------------------------------------------
						     (c) K.H. Weiss 11.12.94
[ RETURN TO DIRECTORY ]