                    RZ.PRG / SZ.PRG GEM-Version

Gem-Version des bekannten RZ.TTP bzw SZ.TTP. Der Transfer-Status wird
in einer GEM-Box angezeigt. Die letzte Meldung bei Verlassen wird
auch nach STDERR ausgegeben. Werden SZ & RZ mit Rufus verwendet, so
wird diese Message in das Rufus-Terminalfenster ausgegeben.

Eventuelle Fehlermeldungen bezglich RZ.PRG/SZ.PRG bitte an:

Michael Ziegler @ M im Mausnet

Die beiden Programme SZ.PRG und RZ.PRG in GEM-Version sind PUBLIC-DOMAIN.
Die Verwendung durch PD-Hndler ist hiermit ausdrcklich untersagt!
Die private Benutzung ist ohne jegliche Lizenz-Gebhren erlaubt.

**********************************************************************
** Jedoch sind Spenden zur Belohnung meiner Programmierwut und zur  **
** Entlastung meiner Telefonrechnung fr die Testerei auf das Konto **
**                                                                  **
**                    Kreissparkasse Haar                           **
**                    BLZ  702 501 50                               **
**                    Kto: 420354680                                **
**                                                                  **
** jederzeit willkommen. Bis jetzt ist noch keine angekommen :-(    **
**********************************************************************

Eine kommerzielle Verwendung dieser beiden Programme ist NICHT gestattet.

Die GEM-Versionen  SZ.PRG und RZ.PRG basiert auf den Unix-Sourcen von
Chuck Forsberg (...!tektronix!reed!omen!caf ) und einer berarbeiteten
Version fr den ATARI ST von Jwahar Bammi ( CompuServe: 71515,155 ).

Wie hoffentlich jeder versteht, kann ich keinerlei Haftung bei
Verwendung der GEM-Version von SZ.PRG und RZ.PRG bernehmen. Da ich
diese beiden PRG's selbst benutze, sind mir Fehlermeldungen oder
Verbesserungsvorschlge natrlich immer willkommen.


XMODEM/YMODEM:

Diese GEM-Versionen von SZ.PRG & RZ.PRG wurden in erster Linie als
Ergnzung fr das Terminalprogramm RUFUS von Michael Bernards geschaffen.
Sie beinhalten deshalb NUR das ZMODEM-Protokoll!
DIE BERTRAGUNG IN XMODEM / YMODEM IST MIT SZ.PRG & RZ.PRG NICHT MGLICH!


RTS/CTS-Handshake:

Da die beiden Programme ber die Betriebssystem-Routinen des ST/TT
arbeiten, muss ein eventuelles RTS/CTS-Handshake entweder vom Terminal-
programm (z.B. RUFUS) oder ber das Kontrollfeld vorgenommen werden.


---------------------------------------------------------------------
Mgliche Commandline-Parameter bei RZ.PRG:

Usage:  rz [-rtpy]
        -e if file exist, rename extension to 001 etc.
        -o file.ext override senders filename with file.ext
        -r allways resume transfer on existing files
        -t TIM Change timeout to TIM tenths of seconds
        -p Protect existing dest. file by skipping transfer if the
           destination file exists
        -y Yes, clobber existing file if any

Es wird immer im Binr-Mode bertragen !

---------------------------------------------------------------------
Mgliche Commandline-Parameter bei SZ.PRG:

Usage:  sz [-+cdefiLlnNopruy] file ...
        sz [-eqv] -c COMMAND
        + Append to existing destination file
        c send COMMAND
        d Change '.' to '/' in pathnames
        e Escape control characters
        f send Full pathname
        i send COMMAND, ack Immediately
        l N Limit frame length to N bytes (32 <= N <= 1024)
        n send file if Newer|longer
        N send file if different length|date
        o Use 16 bit CRC instead of 32 bit CRC
        p Protect existing destination file
        r Resume/Recover interrupted file transfer
        u Unlink file after transmission
        y Yes, overwrite existing file

Es wird immer im Binr-mode bertragen!

----------------------------------------------------------------------------
History:

v 1.1  21.5.90
Binr-Files wurden teilweise nicht korrekt bertragen.


v 1.2  27.05.90
Ein patchen von RUFUS ist nun nicht mehr notwendig. Die beiden
PRG's ersetzen die Standard SZ.TTP & RZ.TTP. Bei Start von ZMODEM
wird nun der Bildschirm gesichert und nach Beenden wieder restauriert.

Die Alert-Box beim Beenden wurde rausgenommen. Stattdessen wird die
letzte Status/Fehler Meldung an STDERR ausgegeben und landet somit
bei Verwendung von RUFUS im Terminalfenster.

Bei Receive wird jetzt nach Empfang der Dateigrsse abgeprft, ob auf
dem aktuellen Laufwerk genug Platz dafr ist. Wenn nicht, Cancel des
Receive und Fehlermeldung !

Der Fehler in der Zeitanzeige (Zehner-Minuten in Einer-Stundenfeld)
ist behoben.

RZ kennt nun auch Receive-Crash-Recovery. D. h. wenn whrend des
Empfangs einer Datei die Verbindung unterbrochen wird, so wird die
bisher empfangene Datei auf Platte/Disk abgelegt. Wird die Ver-
bindung neu aufgenommen, und das gleiche File empfangen, so wird
mit der bertragung dort begonnen, wo sie vorher unterbrochen wurde.
Sind die Dateigren der Datei auf Disk und der zu empfangenden Datei
gleich, so wird der Empfang abgebrochen, und die Fehlermeldung 
'xxxxxxxx already exists' ausgegeben.
Vorsicht ist angebracht. Hat man eine ltere Version eines Programmes
vorliegen, und ldt eine neuere Version runter, die um ein paar Bytes
lnger ist, so empfngt RZ im Resume-Mode und hngt nur die zustz-
lichen Bytes an !!!!! Das gibt natrlich Schrott. Also aufgepasst.


v 1.2a 01.06.90
Fehler in der Speicherbelegung behoben.
Getestet in Mono & Mittlerer Farb-Auflsung, mit und ohne AMCGDOS
It seem's to work.

v 1.2b 01.06.90
Wie gesagt, It seem's...
Luft jetzt auch mit BIGSCREEN 1.0 in Mono und Farbe
Bei Verwendung mit RUFUS 1.0 in RZ.TTP bzw SZ.TTP umbenennen.
RUFUS 1.02 verlangt RZ.PRG und SZ.PRG

v 1.2c 09.05.90
Grrrr, hatte den Fehler in 1.2b nur in RZ, nicht aber in SZ behoben.
War wohl schon zu spt in der Nacht und zu kurz vorm Urlaub.
 
v 1.3 18.06.90
Die ANZEIGE des Pfades auf 44 Zeichen begrenzt.
Existierte bei RZ das File bereits, so wurde der Transfer abgebrochen.
Nun erscheint eine Alertbox, in der ausgewhlt werden kann, ob das
File neu bertragen (Delete) oder abgebrochen (Abort) werden soll.
Ist ein File vorhanden, das krzer ist als das angeforderte File,
so kann zwischen Resume (unterbrochenen Transfer fortsetzen) oder
Delete (File komplett neu bertragen) gewhlt werden.

v 1.4 12.07.90
Auf Anregung eifriger Benutzer:

In RZ wird bei existierendem File nun eine Alertbox mit 3 Buttons
angezeigt (Resume | Delete | Abort) anstelle von 2 verschiedenen
Alertboxen.

Neuer Commandline Parameter: '-y' 
Wird bei Aufruf von RZ in der Commandozeile -y bergeben, so wird ein 
eventuell existierendes Receive-File OHNE Rckfrage gelscht und der
Empfang komplett durchgefhrt.

v 1.5 09.09.90
Pixelsalat bei Beenden von SZ & RZ auf TT030 in mittlerer Auflsung
beseitigt.

v 1.6 25.10.90

Neuer Commandlineparameter fr RZ.PRG: '-r'
    Wird bei Aufruf von RZ in der Commandozeile -r bergeben, so wird
    ein eventuell existierendes Receive-File OHNE Rckfrage im Resume-
    Mode empfangen. Parameter -y darf nicht angegeben sein!

Neuer Commandlinparameter fr RZ.PRG: '-o file.ext'
    Wird bei Aufruf von RZ in der Commandozeile -o file.ext bergeben,
    so wird der vom Sender geschickt Dateiname durch file.ext ersetzt. 
    Sollte file.ext bereits existieren, so wird es vorher gelscht.

Neuer Commandlineparameter fr RZ.PRG: '-e'

    Existiert das zu empfangende File bereits, so wird die File-Extension
    im Dateinamen des NEUEN Files durch 001 (max 999!) ersetzt.

Mehr Variationen zu diesem Thema nehme ich NICHT mehr auf ! Weitere An-
fragen / Vorschlge sind zwecklos !

Die bertragung im ASCII-Mode wurde in beiden PRG's vollstndig entfernt,
    da sie eh nicht richtig funktionierte und wohl kaum verwendet wird!

Bei SZ wird nun der Filename in Kleinbuchstaben bertragen. (Wird in 
    der ZMODEM-Doku empfohlen)

Und nun das Beste: SZ kann jetzt den vollen Stream-Mode, wartet also
    nicht mehr alle 1024 Bytes auf ein ACK ! Dadurch wird der Durchsatz 
    beim Senden bei High-Speed wesentlich verbessert.
    Ausserdem wird bei fehlerhafter bertragung automatisch die Block-
    grsse reduziert und bei fehlerfreier bertragung wieder heraufgesetzt.
    Dadurch wird bei schlechter Leitung der Durchsatz verbessert, da die 
    zu wiederholenden Blockgrssen sich bei hufigen Fehlern verringern
    und infolgedessen hufiger intakte Blcke bertragen werden knnen.

v 1.7 02.11.90

SZ & RZ schalten nun nichtmehr den Handshake aus.
Mein besonderer Dank gilt hierbei Rainer Micheels, der mich darauf 
aufmerksam machte.

