			    (c) MAR 1995 by khweis@mvmpc9.ciw.uni-karlsruhe.de
						     
			    slip_it
			    -------

'slip_it' 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. Dieses 
Paket kann man als Ergnzung zu 'CROSSPOINT' von Peter Mandrella verwenden.
Hier muss lediglich eine ZConnect-Box im 'Sysop-mode' eingerichtet
werden und 'x_script.exe' als 'Importfilter' eingetragen werden.
Danach wird diese 'Slipbox' genauso behandelt, wie jede andere
Mailbox unter Crosspoint auch. Wer Crosspoint nicht mag, kann
auch 'YARN' als Offlinereader verwenden. Das Setup-Programm
installiert slip_it+Yarn vollautomatisch, sofern beim Aufruf von
'setup' yarn*.zip im selben Verzeichnis gefunden wird.

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_script.exe aufgerufen.
Dieses Programm intetrpretiert ein Skriptfile 'x_script.cfg'
In diesem Skriptfile steht u.a. der Aufruf 'shell ximport.bat' 
Dieser startet den 'uuz'-Konverter (Bestandteil von Crosspoint)
um Mail und News vom ZConnect-Format in die RFC-kompatible Form
zu bringen. Dann wird das Whlprogramm ('call dial') gestartet,
dass vom Anwender an die eigenen Beduerfnisse angepasst werden kann. 
Nach dem  Aufbau der Verbindung wird der Slipdriver geladen
und 'x-script.cfg' startet nun die einzelnen tcp/ip-clients.
Zum Schluss wird das Import-Programm aufgerufen ('shell ximport.bat'),
'uuz' wird diesmal in umgekehrter Richtung verwendet, d.h.
die im RFC-Format vorliegende Mail und News im 'spool'-verzeichnis
werden nun in das ZConnect-Format konvertiert und in 'infile.z'
abgelegt. Diese datei wird asnchliessend von Crosspoint eingelesen.
eingelesen.
 
Die von 'x_script.exe' 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 (scripts.zip)
sind (hoffentlich) selbsterklaerend und koennen als Grundlage
fuer eigene Skripts verwendet werden. 

Installation
------------
1. Verzeichnis \xp\x_slip einrichten und slip_it.exe dort entpacken.
   (Selbstextrahierendes File). Starten sie nun 'setup.bat'

   Wenn sie kein Crosspoint-Benutzer sind sondern 'YARN' als
   Offlinereader installieren wollen: kopieren sie Yarn*.zip
   und slip_it.exe in dasselbe Verzeichnis. Yarn wird dann
   zusmmen mit slip_it automatisch installiert. Weitere
   Editierarbeiten sind dann nicht mehr notwendig.

2. Editieren sie das Skriptfile 'x_script.cfg':
   'import.bat' und 'export.bat' werden ersetzt durch 
   'ximport.bat' und 'xexport.bat'.

3. Falls sie das automatische Dialup verwenden wollen:
   ersetzen sie den Aufruf 'call dial' durch 'call rzs-dial'

   ACHTUNG: alle zu slip_it gehoerenden Programme und Konfigurationsfiles
            (x_script.cfg, x_tcp.cfg, wattcp.cfg, dial bzw rzs-dial)
	    sollen im selben Verzeichnis stehen. 'x_script.exe' setzt 
            den Pfad beim Aufruf automatisch auf dieses Verzeichnis und
            bei der Rckkehr wieder auf den Originalpfad.

4. berprfen sie noch einmal alle Angaben in x_tcp.cfg.

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      Lschen      Whlen     Edit     Netztyp       OK      
 

Unter Edit/diverses:

    Verschiedene Einstellungen Ŀ
                                                            
     Online-Anruf     Pawort   GEHEIM                      
 MV                   Logfile                               
                      Script                                
                                                            
     Netzanruf        Ausschlu-  von    :     bis    :     
                      zeiten:     von    :     bis    :     
                                  von    :     bis    :     
                                  von    :     bis    :     
                                                            
                      Script                                
                                                            
     Eingangsfilter    \xp\x_slip\x_script.exe              
                                                            
ĳ                                                         
  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      Lschen      Whlen     Edit     Netztyp       OK      
  


   Die Konfiguratuion ist damit vollstaendig. 

   Ablauf eines Netcalls (s. x_script.cfg):
   'xexport.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 
   'ximport.bat' in das Crosspoint-Format konvertiert. Hiermit
   endet slip_it und Crosspoint beginnt mit dem Einsortieren von
   Mail und News (oder sie starten zuvor noch ein Importfilter,
   z.B. 'crosssecretary')

   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-c den tcp/ip-
   socket zu beenden. Es gibt Situationen (z.B. Verbindungsabbruch), in denen
   das nicht moeglich ist. Dann hilft leider nur ctrl-alt-del. 

x_news.rc
---------
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
   50 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)
Oder:
-  editieren sie in x_tcp.cfg den Eintrag 'newgroups: yymmdd 000000'
   'yymmdd' sind Jahres- Monat- und Tageszahl des letzten updates
   der 'newgroups'-Liste, die sich im Spool-Verzeichnis befindet.
   Dieser Eintrag wird bei einem Anruf automatisch  aktualisiert, falls der 
   Nesserver neue Newsgruppen angelegt hatte. Wenn sie diesen Eintrag
   manuell auf '700101 0000000' setzen, sollten sie eine komplette
   newgroups-Liste vom Server geschickt bekommen.

- Hinweis:
  Zum 'deaktivieren' (auskommentieren) von Eintraegen wird in allen
  Skripts das '#' - Zeichen verwendet
  
                          x_script                     
                        -------------
Eine vorlaeufige Beschreibung des Skriptsprache befindet sich
in x_script.txt (nicht mehr up to date!)
    
Wichtiger Hinweis
-----------------
1. slip_it sollte nicht unbeaufsichtigt laufen. Stellen sie sicher, 
   dass bei einem durchaus moeglichen  Protokoll-Problem die 
   Verbindung zum Server auch vom Modem alleine (oder einer Zeitschaltuhr)
   programmunabhngig abgebrochen wird! Sie benutzen slip_it auf 
   eigenes Risiko!

2. slip_it 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. Wer sich fr
   die Sourcen interessiert, findet die auf meinem server unter x_slip/src. 

3. Kommentare und Hinweise auf Fehler oder moegliche Verbesserungen
   sind erwnscht! 

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  05FEB95