                    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.

Die Programme SZ.PRG und RZ.PRG in GEM-Version sind ab Version 1.9
SHAREWARE. Das bedeutet fr den Anwender, da er die Programme frei
kopieren und 3 Wochen testen kann.

Werden die Programme ber diesen Zeitraum hinaus weiter benutzt, so
ist die EINMALIGE Shareware-Gebhr von DM 30.- an den Author zu ent-
richten. Entgegen blicher Shareware ist der Betrag nur einmalig zu
entrichten und berechtigt auch zur Benutzung knftiger GSZRZ-Versionen.

Eine kommerzielle Nutzung der beiden Programme darf nur mit schriftlicher
Zustimmung des Authors erfolgen.

Der Vertrieb durch PD-Hndler ist ausdrcklich untersagt!


**********************************************************************
** Bankverbindung:                                                  **
**                                                                  **
**                    Michael Ziegler                               **
**                    Kreissparkasse Haar                           **
**                    BLZ  702 501 50                               **
**                    Kto: 420354680                                **
**                                                                  **
** Adresse:                                                         **
**                    Michael Ziegler                               **
**                    8013 Haar                                     **
**                    Jagdfeldring 16                               **
**                                                                  **
**********************************************************************


Die Programme wurden ausfhrlich getestet. Fr etwaige Schden, die durch
die Verwendung von SZ.PRG und RZ.PRG entstehen, kann ich keinerlei Haftung
bernehmen.

Da ich diese beiden PRG's selbst benutze, sind mir Fehlermeldungen oder
Verbesserungsvorschlge natrlich immer willkommen.
Eventuelle Fehlermeldungen bezglich RZ.PRG/SZ.PRG bitte an:

Michael Ziegler @ M im Mausnet
Michael Ziegler 2:246/2.9 im Fido-Net

Die neueste Version dieser Programme ist immer in folgenden Mailboxen
verfgbar:

Maus Mnchen @ M,  Tel. 089-654708
What's Up Mnchen im ATARI-Bereich, Tel. 089-3617476, Fido 2:246/2.9



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  [-eopqrsty]
            e if file exist, rename extension to 001 etc.
            o file.ext override senders filename with file.ext
            p Protect existing dest. file by skipping transfer if the
              destination file exists
            q Quiet mode, send no message to stderr
            r allways resume transfer on existing files
            s Set time of the day for received files
            t TIM Change timeout to TIM tenths of seconds
            y Yes, clobber existing file if any

Es wird immer im Binr-Mode bertragen !

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

Usage:  sz [-deflnNopruy] file ...
        sz [-eiq] -c COMMAND
            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
            z Use ZMODEM Compression (RLE) *

Es wird immer im Binr-mode bertragen!


Ein Tip von Rene Deutscher, @ HH im MausNet:
Bei Verwendung mit MNP-Modems sollte das Register S26 (RTS/CTS-Delay) auf
einen Wert von 10 - 20 gesetzt werden.

----------------------------------------------------------------------------
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.

v 1.8 10.11.90

Asche auf mein Haupt. Ab v 1.6 ist der Exit-Code von RZ falsch
gewesen. Sorry ! Jetzt wird wieder 0 zurckgegeben, wenn alles ok war.

Bei RZ wird nun ein empfangenes File nicht mehr Read-Only, wenn
es diesen Status mitbekommen hat. Das war doch etwas lstig.

Benutzer von High-Speed Modem's sollten bei SZ den Parameter -l 1024
angeben. Dann wird nach jedem Frame ein ACK angefordert.
Eventuelle Fehler bei Retry werden damit behoben.


v 1.9 08.12.90

SZ.PRG und RZ.PRG sind ab sofort Shareware! Bitte die entsprechenden
Bedingungen beachten.

SZ sendet bei Retries nun ein Break von 250 ms an das Modem. Damit mssten
die Probleme mit MNP5 beseitigt sein.
Mein Dank an Rene Deutscher @ HH, ohne dessen Hilfe das Problem noch
nicht besetigt wre.

Bei SZ wird nun eine korrekte Fehlermeldung angezeigt, wenn der Empfnger
den Transfer eines Files berspringt, weil es bereits existiert.

Neuer Commandlineparameter fr RZ.PRG: '-s'
    Wird dieser Parameter angegeben, so wird nicht das mit ZMODEM ber-
    mittelte Filedatum verwendet, sondern das aktuelle Systemdatum und 
    Uhrzeit.

Neuer Commandlineparameter fr RZ.PRG & SZ.PRG: '-q'
    Wird dieser Parameter angegeben, so wird am Ende keine Ausgabe einer
    Meldung nach stderr vorgenommen.


v 1.9a 17.12.90

Fehler bei RZ behoben: Wenn Platte das zu empfangende File nicht mehr
aufnehmen konnte, wurde ein Skip an den Sender geschickt. Dies wirkte
sich beim Maustausch fatal aus, da die Maus den Tausch als erfolgreich
angesehen hat. Nun wird ein Cancell gesendet. Dadurch bricht die Maus den
Tausch ohneErfolg ab.

Bei SZ & RZ: Man sollte bei TC kein String-Merge gestatten, wenn man
die Resource im File stehen hat. Das fhrte ab und an zu seltsamen Effekten 
bei langen Pfad- Filenamen.


v 1.9b 02-01-91

Der Fehler im TOS, dass bei ausgewhltem RTS/CTS Handshake trotzdem
keines verwendet wird, wird nun von SZ & RZ korrigiert.
Anscheinend ist in IOREC der RS232 eine Variable als WORD deklariert,
die von den Tx-Routinen aber als Byte abgeprft wird. SZ bzw RZ tragen den
Wert aus dem Low-Byte des WORD's nun auch im High-Byte ein. Dann 
funktioniert das RTS/CTS Handshake.

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

Geplant fr Version 2.0, nur fr registrierte Benutzer:

RLE-Compression. Wenn die Gegenseite mit RLE sendet, stellt sich RZ auto-
matisch darauf ein. Bei SZ muss Parameter -z angegeben werden. Diese Com-
pression ermglicht eine hhere bertragungsrate, wenn das zu bertragende
File NOCH NICHT mit einem Packer komprimiert wurde. 

Implementation von XMODEM und YMODEM

