                                                    XENIA Software
                                                    Michael Ziegler
                                                    Jagdfeldring 16
                                                    85540 Haar
                                                    Tel. 089-4602746




            GSZRZ Zmodem Paket fr ATARI ST/STE/TT/FALCON





HAFTUNGSAUSSCHLUSS
------------------

Die Programme  wurden ausfhrlich getestet.  Fr etwaige  Schden, die
durch die Verwendung von Programmen  des GSZRZ Paketes entstehen, kann
ich keine Haftung bernehmen.

Sollten Sie  trotzdem einen Fehler feststellen  oder Verbesserungsvor-
schlge haben, so knnen sie mich  entweder unter der oben angegebenen
Anschrift oder ber folgendes Mailbox-Netz erreichen:

Michael Ziegler @ M im Mausnet



BERBLICK
---------

    Das GSZRZ-Paket beinhaltet  die X/Y/ZMODEM bertragungs-Protokolle
    fr den ATARI ST/STE/TT/FALCON.

    Die  Programme sind  in Verbindung  mit  annhernd jedem  Terminal
    Programm einsetzbar.

    Der  bertragungsstatus wird  in einem  Dialog-Fenster angezeigt.
    Die letzte Meldung bei Verlassen  wird auch nach STDERR ausgegeben.
    Wird GSZRZ mit RUFUS von Michael Bernards oder CoNnect von Wolfgang
    Wander betrieben, so wird diese Message in das Terminalfenster aus-
    gegeben.

    GSZRZ luft auch unter Multi-TOS und MAG!X 2.0.


DATEIEN
-------

    Folgende Dateien sind im GSZRZ Paket enthalten:

    GSZRZ_30.PRG   ATARI TT/FALCON Version des GEM Programmes bzw. ACC
                   Diese Version ist NICHT auf dem ATARI ST lauffhig!
                   Zur Verwendung als ACC einfach umbenennen.
    GSZRZ_ST.PRG   ATARI ST Version des GEM Programmes bzw. Accessory
                   Zur Verwendung als ACC einfach umbenennen.
    GSZRZ.TXT      diese Dokumentation
    HISTORY.TXT    der Lebenslauf von GSZRZ
    GACCTEST.LZH   Pure-C Quellcode Beispiel fr Accessory Schnitt-
                   stelle
    FSER096B.LZH   Archiv des Serial-Patches fr den ATARI MegaST/TT
                   von Franz Sirl.
    SERPTCH2.LZH   Archiv des RTS/CTS Patches fr den ATARI MeagST/TT
                   von ATARI Computer.
    HSMODA01.LZH   Archiv des Serial-Patches von Harun Scheutzow fr
                   den ATARI ST/TT/FALCON.

    Die GEM-Programme knnen durch Umbenennen in GSZRZ_xx.ACC auch als
    Accessories verwendet werden. Durch den ERSTEN Parameter wird aus-
    gewhlt,  ob  Senden (-sz) oder Empfang  (-rz) durchgefhrt werden
    soll.


INSTALLATION
------------

    Die Installation hngt von dem verwendeten Terminalprogramm ab. An
    dieser Stelle ein paar Tips zur Installation mit RUFUS.


Verwendung mit RUFUS
--------------------

    Wenn  Sie gengend  Speicherplatz zur Verfgung haben, kann  GSZRZ
    als  Accessory  installiert  werden. Dann einfach GSZRZ_xx.PRG als
    GSZRZACC.ACC in das Rootdirectory kopieren. Im  Dialog 'Protokoll'
    von RUFUS den Slot ZMODEM einstellen. Dann Parameter sichern.

    Will  man  das 30-Accessory bentzen (TT, FALCON oder eine PAK mit
    6802/30), so mu man es entweder umbenennen, oder in RUFUS.RUF mit
    einem Editor die Zeile ACCNAME=GSZRZ_30.ACC eintragen.

    Bei  Verwendung als ACC unter Connect oder RUFUS darf -rz bzw. -sz
    NICHT  mehr angegeben werden, da es (unsichtbar) von Connect/RUFUS
    eingefgt wird.

    Bei Verwendung  als PRG die Datei GSZRZ_xx.PRG in das Modul-Direc-
    tory von RUFUS kopieren. Im Dialog 'Protokoll'  von   RUFUS  einen
    freien Slot einstellen. Einen Protokoll-Namen  eintragen.  Bei Typ
    EXTERN einstellen. Dann bei Sender durch anklicken der Namenszeile
    GSZRZxxx.PRG  auswhlen. Bei  Parameter -sz und  eventuelle andere
    Parameter eintragen (durch Leerzeichen getrennt). Dann bei Empfn-
    ger durch anklicken der Namenszeile  ebenfalls  GSZRZxxx.PRG  aus-
    whlen. Bei Parameter -rz und eventuelle andere Parameter eintra-
    gen. Dann 'Parameter sichern'.


Verwendung unter Connect
------------------------

    Bei CoNnect ist dies nicht notwendig. CoNnect  kann  den Namen des
    ACC selbst suchen. Bei CoNnect  mu nur in dem Dialog Transfer der
    Button 'ACC suchen' angeklickt werden. Wenn GSZRZ_xx.ACC vorhanden
    ist, findet CoNnect den Namen und trgt diesen entsprechend ein.


Verwendung mit HARLEKIN III
---------------------------

    Fr HARLEKIN III mu GSZRZ_ST  oder GSZRZ_30 in GSZRZACC.ACC umbe-
    nannt und in das Rootdirectory der Bootpartition kopiert werden.
    Unter 'Optionen'  'Zmodem' mu 'externes Modul anwenden' aktiviert
    werden. Bei 'Senden' bzw 'Empfangen' ist zumindest bei Harlekin in
    Version 3.0 jeweils -M einzutragen (siehe TROUBLE.TXT).


Verwendung unter MultiTOS
-------------------------

    Unter MultiTOS mu GSZRZ als  Programm verwendet werden, wenn eine
    andere Schnittstelle als MODEM1 verwendet wird. Auerdem empfiehlt
    sich ein Treiber wie FAST_SER oder HSMODEM.


Verwendung in anderen Terminal- oder Mailbox Programmen
-------------------------------------------------------

    Wird GSZR mit anderen Programmen verwendet, so sei an dieser Stelle
    auf die Dokumentation der entsprechenden Programme hingewiesen.


COMMANDLINE PARAMETER
---------------------

    Bitte  achten Sie  darauf, da  die Parameter  bei Gross-/  Klein-
    schreibung  unterschiedliche Bedeutung  aufweisen knnen!  Deshalb
    immer an die angegebenen Parameter  halten. Mehrere Parameter sind
    durch Leerzeichen getrennt anzugeben (siehe Beispiele). Dateinamen
    sind immer NACH dem letzten Parameter anzugeben! Bei CoNnect kommt
    also bei Sendeparameter das $ immer als letztes Zeichen!

    GSZRZ beinhaltet sowohl Sende- als auch Empfangsroutinen. Um GSZRZ
    mitzuteilen,  ob Senden  oder  Empfangen  erfolgen soll,  mu  als
    ERSTER Parameter  -sz fr Senden  oder -rz fr Empfangen angegeben
    werden.  Bei  Verwendung  als  Accessory  zusammen  mit RUFUS oder
    CoNnect  wird  dies automatisch  durch  RUFUS/CoNnect erledigt. In
    diesem Fall darf -sz bzw. -rz NICHT eingesetzt sein!

    Wird nicht  Parameter -a  angegeben, so  wird immer  im Binr-Mode
    bertragen!

    Von der  bertragungsgeschwindigkeit her  gesehen, ist  das ZModem
    von GSZRZ  default auf die hchstmgliche  bertragungsrate einge-
    stellt. Hat man  eine sehr schlechte Leitung und  kein MNP/V42, so
    ist es sicherer, wenn man mit Parameter -l 1024 eine Blockquittung
    verwendet  (siehe Parameter  -l  beim Senden).  Da  ist die  ber-
    tragung allerdings etwas langsamer.



PARAMETER bei EMPFANG
---------------------

Umsetzung von eingehenden Newline-Zeichen

    -a          Diese Funktion wird verwendet,  um ASCII bertragungen
                z.B. von einem Unix System  auf den ATARI vorzunehmen.
                Dabei werden  eingehende Linefeeds  in Carriage-Return
                Linefeed umgesetzt.


Protokollabschlu am Ende der bertragung in CPS-Rate einbeziehen

    -A          Am  Ende  einer bertragung  wird nach Abspeichern der
                Datei die CPS-Rate noch einmal berechnet. Da  sich die
                Leute  nicht einig  waren, ob das in die CPS-Rate ein-
                flieen soll oder nicht, gibts nun eine Option dafr.
                Wird -A angegeben, wird das Beenden des Protokolls mit
                in die Berechnung der CPS Rate einbezogen.

Puffergre:

    -b  SIZE    Mit diesem  Parameter wird  die Gre  des verwendeten
                Puffers der  seriellen Schnittstelle  fr den  Empfang
                eingestellt. SIZE ist  die Gre des Puffers  in Byte.
                Der  eingestellte  Defaultwert von  1024  Byte  drfte
                ausreichend sein.

                SIZE:  default 1024  Byte, minimal  128 Byte,  maximal
                       16384 Byte


Einstellen des CRC bei XModem

    -c          Wird dieser  Parameter angegeben,  so wird  bei XMODEM
                anstelle der Prfsumme  ein 16 Bit CRC verwendet. Dies
                ist im Prinzip  auch sicherer. Jedoch kann nicht jedes
                Xmodem Protokoll auch mit CRC arbeiten.


Unterdrckung der Carrier-berwachung

    -D          Wird  dieser Parameter  angegeben, so  wird die  ber-
                wachung des Carrier Detect unterdrckt.

Escapen von Kontroll-Zeichen

    -e          Bei Empfang wird das 'escapen' aller Kontroll-Zeichen
                durchgefhrt (siehe auch -e bei Senden).

Setzen des Datei Puffers

    -F SIZE     Mit diesem Parameter kann  die Grsse des Dateipuffers
                gesetzt  werden. Wenn  eine Datei  empfangen wird,  so
                werden die eingehenden Bytes in einem Puffer abgelegt.
                Ist dieser Puffer voll, so wird  er auf die Harddisk /
                Diskette  geschrieben.  Das beeinflut  natrlich  die
                bertragungsgeschwindigkeit. Darum kann  die Gre des
                Puffers  manipuliert werden.  Der  Parameter gibt  die
                Gre  des Puffers in Byte  an. Die  Puffergre  kann
                auch in Kilobyte oder Megabyte angegeben werden:
                -F 16K oder -F 2M. Gibt man -F -1 an, so wird das kom-
                plette verfgbare Ram minus 100 KB als Puffer benutzt.

                SIZE: default  8192 Byte, minimal 1024  Bytes.


Einstellen des Stream-Modus bei XMODEM/YMODEM

    -g          Wird dieser  Parameter angegeben,  so wird  bei XMODEM
                bzw. YMODEM der Stream-Mode bentzt. Das bedeutet, da
                keine Quittung pro Datenblock  an den Sender geschickt
                wird.  Normalerweise   wird  nach   jedem  empfangenen
                Datenblock eine  Quittung an den Sender  geschickt, um
                mitzuteilen, da  der Block  empfangen wurde.  Hat man
                eine zuverlssige Verbindung, (MNP5,  V42bis), so kann
                die  bertragungsgeschwindigkeit durch Wegfall  dieser
                Quittung erhht werden.


Akustische Anzeige des bertragungsendes

    -G          Am Ende  der bertragung wird  ein 'Pling'  ausgegeben


Schnittstelle festlegen

    -H n        Mit diesem Parameter wird die Schnittstelle festgelegt.

                     ST           MSTE      TT      FALCON
                1   AUX           AUX      AUX       AUX
                3   MIDI          MIDI     MIDI      MIDI
                6   MODEM1        MODEM1   MODEM1    -
                7   -             MODEM2   MODEM2    MODEM2
                8   -             SERIAL2  SERIAL1   SERIAL2/LAN
                9   -             -        SERIAL2   -


Logfile schreiben

    -L [x:\pfad\]filename.ext
                Logging der Aktivitten. Wenn GSZRZ  beendet  wird, so
                wird ein Eintrag in die Datei FILENAME geschrieben mit
                folgendem Format:

            SZ: HISTORY.TXT  Len:    20408 Tim: 00.00.18 Err:  0 CPS: x
            RZ: ANSI.SYS     Len:     1709 Tim: 00.00.02 Err:  0 CPS: x
            ^^  ^                    ^          ^              ^
            ||  Filename     bertr. Bytes      Dauer    Fehlercode
            |X/Y/Z Protokoll
            S oder R fr Send / Receive


bertragung ber die MIDI Schnittstelle

    -m          Wird  dieser  Parameter  angegeben,   so  erfolgt  die
                bertragung  nicht ber  die RS232,  sondern ber  die
                MIDI Schnittstelle. Dieser Parameter mu nicht angege-
                ben werden,  wenn GSZRZ  als Accessory  mit RUFUS  zu-
                sammen arbeitet. Da wird  automatisch immer die momen-
                tan bei RUFUS eingestellte Schnittstelle verwendet.
                (siehe Beispiel)

Abschalten des Maus-Interrupts

    -M          Durch diesen Parameter wird  der Mausinterrupt whrend
                der bertragung abgeschaltet. Da bei manchen Benutzern
                Strungen der bertragung auftraten,  wenn whrend der
                bertragung die Maus bewegt wurde, ist es durch diesen
                Parameter mglich, den Mausinterrupt abzuschalten.
                Ausserdem wird bei diesem Parameter auch das Multitas-
                king  unterbunden, um maximalen Datendurchsatz auf dem
                ST zu erreichen.


Verhalten bei bereits existierender Datei

    Bei YMODEM und ZMODEM wird der  Dateiname bereits durch den Sender
    vorgegeben.  Wenn dieser  Dateiname  bereits  existiert, kann  die
    Reaktion auf diesen Fall eingestellt werden.

    -o FILE.EXT Der durch den Sender vorgegebene Dateinamen wird durch
                FILE.EXT ersetzt. Achtung: hier darf KEIN Pfad angeben
                werden.

    -p          Wenn Datei bereits existiert, durch SKIP an den Sender
                die  bertragung dieser  Datei berspringen  (Achtung:
                kleines 'p' verwenden!)

    -E          Wenn die zu empfangende  Datei bereits existiert, wird
                der Dateityp  der BEREITS  VORHANDENEN  Datei auf 001,
                wenn dies auch schon existiert auf 002 etc. umbenannt.

    -y          Wenn  die Datei  bereits  existiert,  dann soll  diese
                gelscht werden.


Festlegen des Download-Directories

    -P PFAD     Durch Angabe dieses Parameters kann  das Zieldirectory
                bestimmt   werden.   Wird   dieser   Parameter   nicht
                angegeben,  so  landen  empfangene  Dateien  immer  im
                aktuellen Directory.

    Wenn Dateien  mit vorangestelltem Pfad  empfangen werden,  so wird
    von diesem Pfad eine eventuelle Laufwerksangabe abgeschnitten. Der
    restliche  Pfad  wird entweder  an  den  aktuellen oder  wenn  mit
    Parameter -P ein Pfad vorgegeben wurde, an diesen angehngt.

    Beispiel:
    Das aktuelle Direktory sei C:\MAIL\DOWNLOAD

    Datei vom Sender: J:\TEST\XYZ\FILE.EXT
    ohne -P wird folgendes File erzeugt:
               C:\MAIL\DOWNLOAD\TEST\XYZ\FILE.EXT
    mit -P D:\RECEIVE landet das File in:
               D:\RECEIVE\TEST\XYZ\FILE.EXT

    Ordner, die nicht existieren, werden angelegt!


    -d          Wird  dieser Parameter angegeben, so  werden eventuell
                vom  Sender kommende  Pfade  abgeschnitten. Dies dient
                der Sicherheit vor allem bei Einsatz in Mailboxen.

Ausgaben bei Verlassen von GSZRZ an STDERR unterdrcken

    -q          Wird dieser  Parameter angegeben, so wird  die Ausgabe
                der letzten  Meldung an STDERR  unterdrckt. (Sinnvoll
                bei Terminalprogrammen, die keine Umlenkung von STDERR
                vornehmen)


Fortsetzen des Empfangs eines abgebrochenen Downloads

    -r          Wenn Datei bereits besteht, dann  wird  ohne Rckfrage
                mit Resume  die  bertragung  fortgesetzt. Ohne diesen
                Parameter erscheint eine  Alert-Box, in der ausgewhlt
                werden  kann, ob die bertragung fortgesetzt, abgebro-
                chen oder das alte File gelscht wird.
                (nur ZMODEM)


Setzen des Systemdatums fr eine empfangene Datei.

    -s          Das File-Datum fr empfangene Dateien auf das aktuelle
                Datum   setzen.  (Y/ZMODEM)   Kann  hauptschlich   in
                Mailboxprogrammen von Nutzen sein.


Ausgabe der erreichten CPS Rate am Ende der bertragung

    -S          Wird dieser Parameter  angegeben, so wird am  Ende der
                bertragung  die  erreichte CPS-Rate  an  STDERR  aus-
                gegeben.


Einstellen der Timeout Zeit

    -t TIM      Die  Timeout  Zeit  wird   auf  TIM  Zehntel  Sekunden
                gesetzt.  Wurde   aufgenommen,  da   scheinbar  manche
                Mailboxen  recht  lange  brauchen,   bis  eine  ZMODEM
                bertragung aufgenommen wird.  Normalerweise sollte es
                mit der Default-Einstellung aber keine Probleme geben.
                Defaultwert: 100, min: 10, max 1000


Protokoll bei Empfang

    Default wird ZMODEM verwendet. Soll eines der anderen Protokolle
    verwendet werden, so kann dies durch folgende Parameter erreicht
    werden:

    -X          XMODEM-Protokoll verwenden

    -Y          YMODEM-Protokoll verwenden


Compression von ASCII Dateien

    -z          RLE Kompression  erlauben. Wird dieser Parameter ange-
                geben, so  wird  RLE Kompression  zugelassen. Ob diese
                auch verwendet wird, hngt  zustzlich  vom Sender ab.
                Ist  nur dann sinnvoll, wenn im  ASCII-Mode bertragen
                wird und  KEIN  MNP5  oder V42bis eingesetzt wird. RLE
                ist  ein  relativ  einfacher  Kompressionsalgorithmus.
                Dafr aber so schnell, da  die bertragungsrate immer
                noch positiv beeinflut wird.


berprfung der Online Zeit

    -U time         verbleibende Onlinezeit
    -C baudrate     aktuelle Baudrate

    Fr den  Einsatz in  Mailboxprogrammen wurde  fr den  Empfang die
    Prfung der noch verbleibenden  Online-Zeit aufgenommen (Stichwort
    NetCall Hour). Dazu sind die beiden Parameter -C und -U notwendig.
    Bei -C wird  der folgende Wert als  aktuelle Baudrate ausgewertet.
    -U ist die  restliche Onlinezeit in Sekunden. Reicht  die Zeit fr
    einen Upload  nicht mehr aus,  so wird RZ  mit Exitcode 9  und dem
    Hinweis  'not  enough  time for  upload'  abgebrochen.  Zu  diesem
    Zeit-punkt ist  noch keine  Datei angelegt,  es bleiben  also auch
    keine  Datei-Leichen  zurck.  Wird  durch  Blockwiederholung  die
    verfgbare  Online-Zeit berschritten,  so  wird  der Empfang  mit
    Exitcode 10  abgebrochen. Die  empfangene Datei  wird geschlossen,
    kann also eventuell spter komplettiert werden.

    Beispiel: -rz -C 19200 -U 100



BEISPIELE
---------

Ein paar Beispiele fr Aufrufe von RZ:

-rz                  Empfang mit ZMODEM

-rz -Y               Empfang mit YMODEM

-rz -Y -g            Empfang mit YMODEM-1k-g

-rz -X TEST.XYZ      Empfang mit XMODEM. Bei Empfang mit XMODEM  M U S S
                     immer ein Dateiname angegeben werden, da bei XMODEM
                     der Dateiname nicht mit bertragen wird!

-rz -y -o TEST.XYZ -P D:\MAIL\DOWNLOAD
                     Empfang mit ZMODEM,  Carrierberwachung disabled,
                     Zieldirectory   vorgeben,   Dateiname   vorgeben,
                     eventuell vorhandene Datei lschen.

-rz -m               Empfang ber die MIDI-Schnittstelle

-rz -m -b 8192 -l 8192
                     Empfang ber MIDI. Der Rx Puffer mu bei Verwendung
                     von 8 KB Blcken auch auf 8KB gesetzt werden, da es
                     sonst zu Pufferberlufen kommt.


PARAMETER bei SENDEN
--------------------

ACHTUNG: Immer beachten, da erst die verschiedenen Parameter und dann
         als letztes der/die Dateinamen der zu sendenden Datei(en) an-
         gegeben wird.

Mgliche Commandline-Parameter bei Senden:

Anhngen an existierende Datei

   -+           Der Empfnger soll an ein existierendes File anhngen.
                Nur ZModem.


ASCII Transfer

   -a           ASCII-Transfer, Rx soll CRLF bersetzen. Nur ZModem.


Protokollabschlu am Ende der bertragung in CPS-Rate einbeziehen

    -A          Am  Ende  einer bertragung  wird nach Abspeichern der
                Datei die CPS-Rate noch einmal berechnet. Da  sich die
                Leute  nicht einig  waren, ob das in die CPS-Rate ein-
                flieen soll oder nicht, gibts nun eine Option dafr.
                Wird -A angegeben, wird das Beenden des Protokolls mit
                in die Berechnung der CPS Rate einbezogen.


Break unterdrcken

   -b           Bei einem Retry wird KEIN Break an das Modem ausge-
                geben. Nur ZModem. Normal wird bei einer Blockwieder-
                holung ein Break an das Modem geschickt, um den
                Modem-Puffer zu leeren.


Konvertieren von '.'

   -d           Punkte '.' in Pfadnamen in '/' konvertieren. Nur bei
                YModem und ZModem. Wenn der Empnger keine '.' in
                Dateinamen haben will/kann.


Carrier berwachung

   -D           berwachung des Carrier Detect unterdrcken


Escapen von Kontroll-Zeichen

   -e           Wenn dieser Parameter angegeben wird, werden alle Kon-
                troll-Zeichen  'escaped'. Dies ist besonders bei Unix-
                Systemen blich.

Pfadangaben an Empfnger senden

   -f           Wird dieser Parameter angegeben, so wird die komplette
                Pfadangabe  mit  dem Dateinamen  bertragen.  Nur  bei
                ZModem.


Setzen des Datei Puffers

    -F SIZE     Mit diesem Parameter kann  die Grsse des Dateipuffers
                gesetzt  werden. Wenn  eine  Datei  gesendet wird,  so
                so wird sie blockweise in einen Puffer eingelesen.
                Das beeinflut bei kleinen Blcken natrlich die ber-
                tragungsgeschwindigkeit.  Die  Gre  des Puffers kann
                manipuliert  werden. Der Parameter gibt die Gre  des
                Puffers in Byte an. Die Puffergre kann auch in Kilo-
                byte oder Megabyte angegeben werden:
                -F 16K oder -F 2M. Gibt man -F -1 an, so wird das kom-
                plette verfgbare Ram minus 100 KB als Puffer benutzt.

                SIZE: default  8192 Byte, minimal 1024  Bytes.


Akustische Anzeige des bertragungsendes

    -G          Am Ende der bertragung wird ein 'Pling' ausgegeben


Schnittstelle festlegen

    -H n        Mit diesem Parameter wird die Schnittstelle festgelegt.

                     ST           MSTE      TT      FALCON
                1   AUX           AUX      AUX       AUX
                3   MIDI          MIDI     MIDI      MIDI
                6   MODEM1        MODEM1   MODEM1    -
                7   -             MODEM2   MODEM2    MODEM2
                8   -             SERIAL2  SERIAL1   SERIAL2/LAN
                9   -             -        SERIAL2   -


Blockgre bei XModem / YModem

    -k          1024 Byte Pakete senden. Default werden bei XModem und
                YModem 128 Byte Pakete verwendet.


Empfnger Quittung anfordern

    -l N        Alle  N  Bytes  (32  <= N  <=  1024)  Quittierung  von
                Empfnger anfordern. Nur bei  ZModem. Default wird bei
                ZModem der Stream-Mode verwendet. Das bedeutet da der
                Sender  fortlaufend  Datenblcke schickt  und  nur  im
                Fehlerfall  vom Empfnger  zu einer  Blockwiederholung
                aufgefordert  wird. Dadurch  wird  im Stream-Mode  ein
                hherer  Datendurchsatz  erreicht. Ist aber kein Hard-
                ware-Handshake  vorhanden (z.B. MIDI) mu durch diesen
                Parameter fr ein Software Handshake gesorgt werden.


bertragung ber die MIDI Schnittstelle

    -m          Wird  dieser  Parameter  angegeben,   so  erfolgt  die
                bertragung  nicht ber  die RS232,  sondern ber  die
                MIDI   Schnittstelle.  Dieser   Parameter  mu   nicht
                angegeben werden,  wenn GSZRZ als Accessory  mit RUFUS
                zusammen  arbeitet.  Da  wird  automatisch  immer  die
                momentan   bei   RUFUS    eingestellte   Schnittstelle
                verwendet.

                Da  es bei  der  MIDI  Schnittstelle keine  Handshake-
                leitungen gibt, mu  man durch Angabe von  -l 1024 fr
                ein Software-Handshake sorgen (wenn -8 verwendet wird,
                dann -l 8192).


Abschalten des Maus-Interrupts

    -M          Durch diesen Parameter wird  der Mausinterrupt whrend
                der bertragung abgeschaltet. Da bei manchen Benutzern
                Strungen der bertragung auftraten,  wenn whrend der
                bertragung die Maus bewegt wurde, ist es durch diesen
                Parameter mglich, den Mausinterrupt abzuschalten.
                Ausserdem wird bei diesem Parameter auch das Multitas-
                king  unterbunden, um maximalen Datendurchsatz auf dem
                ST zu erreichen.


Bedingte bertragung

    -n          Datei nur dann senden, wenn sie NEUER oder lnger ist,
                als eine bereits beim Empfnger existierende Datei.
                Nur ZModem.


    -N          Datei nur  dann senden, wenn  sie lnger ist  oder ein
                ANDERES  Datum  aufweist,  als   beim  Empfnger.  Nur
                ZModem.


16 Bit CRC

    -o          Bei ZMODEM nur  16 Bit CRC verwenden.  Spart pro ber-
                tragenem  Block 2  Byte. Ist  also  was fr  Geschwin-
                digkeitsfanatiker :-) Es gibt ltere ZModem Programme,
                die nur 16 Bit CRC verwenden.


Schtzen einer bereits vorhandenen Datei

    -p          Wenn die zu bertragende  Datei bereits beim Empfnger
                existiert,  wird die  bertragung NICHT  durchgefhrt.
                Nur bei ZModen.


Ausgaben bei Verlassen von GSZRZ an STDERR unterdrcken


    -q          Wird dieser  PArameter angegeben, so wird  die Ausgabe
                der letzten  Meldung an STDERR  unterdrckt. (Sinnvoll
                bei Terminalprogrammen, die keine Umlenkung von STDERR
                vornehmen)


Fortsetzen einer abgebrochenen bertragung

    -r          Mit  diesem  Parameter  wird dem Empfnger mitgeteilt,
                da  der Sender in  der Lage ist, das Fortsetzen einer
                abgebrochenen bertragung zu handhaben. (nur ZMODEM)


Script File fr Senden bentzen

    -s FILE.EXT Die  Namen der  zu sendenden  Dateien  werden aus  dem
                Script-File Datei.Ext gelesen.  Nur ZModem. Praktisch,
                wenn man  wiederholt die  gleichen Dateien  bertragen
                mu.


Ausgabe der erreichten CPS Rate am Ende der bertragung

    -S          Wird dieser Parameter  angegeben, so wird am  Ende der
                bertragung  die  erreichte CPS-Rate  an  STDERR  aus-
                gegeben.


Einstellen der Timeout Zeit

    -t TIM      Die  Timeout  Zeit  wird   auf  TIM  Zehntel  Sekunden
                gesetzt. Das  ist die Zeit,  die auf eine  Antwort vom
                Empfnger  gewrtet  wird, bis  ein  Fehler  angenommen
                wird.    Normalerweise     sollte    es     mit    der
                Default-Einstellung   aber   keine   Probleme   geben.
                Defaultwert: 600, min: 10, max 1000


Datei lschen

    -u          Die zu bertragende Datei soll nach der bertragung
                gelscht werden.


Existierende Datei berschreiben

    -y          Der Empfnger soll eine eventuell bereits existierende
                Datei gleichen Namens berschreiben. Nur ZModem.


Protokoll bei Senden

    Default wird ZMODEM verwendet. Soll eines der anderen Protokolle
    verwendet werden, so kann dies durch folgende Parameter erreicht
    werden:

    -X          XMODEM-Protokoll verwenden

    -Y          YMODEM-Protokoll verwenden


Compression von ASCII Dateien

    -z          RLE Kompression verwenden. Ist nur dann sinnvoll, wenn
                im  ASCII-Mode  bertragen  wird und  KEIN  MNP5  oder
                V42bis eingesetzt wird. RLE  ist ein relativ einfacher
                Kompressionsalgorithmus. Dafr aber so schnell, da es
                die bertragungsrate immer noch positiv beeinflut.


berprfung der Online Zeit

    -U time     verbleibende Onlinezeit

                Fr den Einsatz in Mailboxprogrammen wurde fr das Sen-
                den die Prfung der noch verbleibenden Online-Zeit auf-
                genommen. 'time' ist die restliche Onlinezeit in Sekun-
                den.  Wird  durch  Blockwiederholung die verfgbare On-
                line-Zeit  berschritten, so  wird das Senden mit Exit-
                code 10 abgebrochen.

                Beispiel: -sz -U 100


Groe Blcke bertragen

    -8          Beim  Senden  8KB  Blcke  verwenden.  ACHTUNG:  Diese
                Option vertrgt sich nur mit wenigen ZModem Programmen
                am anderen Ende.



BEISPIELE
---------

Ein paar Beispiele fr Parameterangaben beim Senden

-sz TEST.XYZ             Senden mit ZMODEM

-sz *.C *.H              Alle Dateien mit der Extension .C und .H mit
                         ZMODEM senden.

-sz -Y TEST.XYZ          Senden mit YMODEM

-sz -Y -k TEST.XYZ       Senden mit YMODEM-1k-g

-sz -X TEST.XYZ          Senden mit XMODEM

-sz -8 TEST.XYZ          Senden mit ZMODEM in 8 KB Blcken

-sz -m -l 1024 TEST.XYZ  Senden ber die MIDI Schnittstelle.

Wird am anderen Ende auch GSZRZ verwendet, so kann durch Angabe von

-sz -m -8 -l 8192 TEST.XYZ auch in 8 KB-Blcken bertragen werden.

Paramter fr Empfang bei Verwendung von 8KB Blcken:

rz -m -b 8192



EXITCODES
---------

Folgende Exitcodes werden  von GSZRZ bei Beendigung  des Programmes an
den Aufrufer zurckgegeben:

1  Argument Fehler, Commandline  fehlerhaft, ev. auch Datei nicht gefunden
2  Initialisierungsfehler (graf_handle,  appl_init)
3  Abbruch durch Eingabe von Ctrl-C oder Anklicken des 'Closers'
4  Speicher Anforderungsfehler, nicht genug  Speicher vorhanden
5  Carrier lost
8  ungltiger Struktur Zeiger (siehe ACC-Protokoll)
9  Nicht genug Zeit fr Upload
10 Abbruch wegen berschreitung des Zeitlimits
11 Kein/ungltiges Porthandle
12 Disk full
16 Cancel received    Abbruch durch Gegenseite
128- Transfer-Fehler  Sollen z.B. 4 Files gesendet werden und bei 2
                      Dateien SKIPPED der Receiver, so wird 128 + 2
                      = 130 zurckgegeben. Kommt gar kein Sync zu-
                      stande (Timeout), wird 128 zurckgegeben.



ACC-PROTOKOLL von GSZRZ
-----------------------

GSZRZ als  ACC wird  durch ein  spezielles Protokoll  ber die  Appli-
cation-Message Funktion des GEM angesprochen.

msgbuf[0]   enthlt die Kenn-Nummer fr das ACC Protokoll. Sie
            besteht aus den beiden Buchstaben 'GZ' entsprechend
            dem Hexwert 0x475A.

msgbuf[1]   enthlt den Application-ID, also den Wert, der bei
            appl_init() als Rckgabewert erhalten wird.

msgbuf[2]   mu immer 0 sein

msgbuf[3]   enthlt die Lnge des Commandlinestrings.

msgbuf[4]   untere 16 Bit des Pointers auf den Commandline String.

msgbuf[5]   obere 16 Bit des Pointers auf den Commandline String.

            Der Commandline-String  muss mit 0x00  abgeschlossen sein.
            Er beinhaltet  die blichen Switches,  wie bei  Aufruf als
            PRG, also z.B. "-rz -D -P C:\\DOWNLOAD"



Rckmeldungen von GSZRZ
=======================

Wenn GSZRZ beendet wird, so erfolgt eine Rckmeldung an des aufrufende
Programm:

msgbuf[0] = GZ_PRIVATE;
msgbuf[1] = appl_id;
msgbuf[2] = Exitcode;
msgbuf[3] = (int) strlen(Meldung);
msgbuf[4] = (unsigned int) ((long) Meldung & 0XFFFF);
msgbuf[5] = (unsigned int) ((long) Meldung >> 16);
msgbuf[6] = 0;
msgbuf[7] = 0;
appl_write(msgbuf[1], 16, txmsgbuf);


Meldung ist ein Pointer auf den String, der normal von GSZRZ am Ende
an 'stdout' ausgegeben wird. Bei RUFUS landet dieser String als Meldung von
GSZRZ imTerminalfenster.

Exitcode enthlt den Returncode von GSZRZ.




RTS/CTS HANDSHAKE
-----------------

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

Da die TOS-Routinen leider  sogar in TOS 1.04 und TOS  3.05 noch immer
fehlerhaft sind, muss ein Patch installiert sein.

Hier kann ich HSMODEM empfehlen, das von Harun Scheutzow stammt und aus
dem ATARI wirklich was rausholt!



SHAREWAREVERSIONEN
------------------

Die Programme SZ.PRG und RZ.PRG in  GEM-Version sind nur bis Versionen
kleiner als 2.0  SHAREWARE. Das bedeutet fr den Anwender,  da er die
Programme der Versionen < 2.0 frei  kopieren und 3 Wochen testen kann.
Alle  Versionen  ab  2.0 und  aufwrts  sind  persnlich  registrierte
Versionen, die nicht weitergegeben werden drfen.

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

Bei berweisungen  aus dem AUSLAND bitte  daran denken, da bis  zu DM
12.50 an Gebhren anfallen knnen!

Registrierte Benutzer bekommen gegen EINSENDUNG EINER LEERDISKETTE UND
EINEM FRANKIERTEN  RCKUMSCHLAG die Vollversion. Diese  beinhaltet die
Implementation von XMODEM, XMODEM-1k, XMODEM-g, YMODEM-g, YMODEM Batch
und ZMODEM.

Versionen  mit Versionsnummer  >=  2.0  werden NICHT  MEHR  ffentlich
verteilt, sondern nur noch an lizensierte Benutzer vergeben.



DANKESCHN
----------

An dieser Stelle mchte ich mich bei meinen Betatestern bedanken.

Mein Dank gilt vor allem:

Jrgen Meyer, Carsten Meyer Maus @HH2, fr das aufopfernde Testen,

Michael Bernards fr die Untersttzung durch RUFUS,

Wolfgang Wander fr die Untersttzung durch CoNnect,

Harun Scheutzow fr 'den besten' Seriell-treiber fr alle ATARIs,

Franz Sirl fr seinen Patch FAST_SER,

Achim Wilhelm fr die Untersttzung bei der Fahndung nach Bugs im
FALCON-TOS 4.01,

allen Benutzern von GSZRZ, die durch immer neue Vorschlge fr eine
Weiterentwicklung des GSZRZ Zmodem Paketes sorgen.




UPDATE-SERVICE
--------------

Fr  registrierte  GSZRZ  Benutzer gibt  es  einen  Update-Service  in
verschiedenen Mailboxen.

Bis ein neu  registrierter Benutzer diesen Service  in Anspruch nehmen
kann, knnen ca. 1-2 Wochen vergehen, da die Datei mit den Registrier-
Daten in unregelmigen Abstnden in  der jeweiligen Mailbox upgedatet
wird.

Dieser Service  ist eine kostenfreie  Einrichtung, die auf  Wunsch von
Mailbox   Betreibern  eingerichtet   wurde.  Ich   kann  daher   nicht
garantieren,  da dieser  Service  jederzeit  erreichbar ist  und  die
aktuellste Version des GSZRZ Paketes installiert hat.

Fr den Update ist die Seriennummer Ihres GSZRZ Paketes notwendig.
Diese steht in der Datei SERIAL.NUM auf der Original-Diskette.

Nach einloggen in die Mailbox mu  aus dem Men der Updater aufgerufen
werden. Das  kann je  nach Mailbox  unterschiedlich erfolgen.  Ist der
Updater aufgerufen, so meldet er sich mit folgendem Text:


>> Registering GSZRZ-Files V 2.6 (c) 1991, 1992 mz <<

A C H T U N G:  Nur fr REGISTRIERTE Benutzer erlaubt!
aktulle Version x.yy downloaden ? (J/N)

Vorname:
Nachname:
Seriennummer:

Nach Eingabe der  erforderlichen Daten wird eine  registrierte Version
erstellt, mit  LHARC gepackt und  anschliessend wahlweise  mit Y-Modem
oder Z-Modem gesendet.

Bitte achten Sie bei der Schreibweise von Vor-und Nachname darauf, da
diese exakt  wie in  dem Dialogfenster  angezeigt, eingegeben  werden.
Anderenfalls werden Sie als nicht updateberechtigt zurckgewiesen.

Der Update-Service wird von folgenden Mailboxen angeboten:

-----------------------------------------------------------------------------
Box        :         Turbo Tron         Hamburg
Baudrate   :         2400 - 14400 V32 V32bis

Tel.-Nummer:         040 - 890 11 62
Sperrzeiten:         - keine -

Updater    :         Eingabe von GSZRZ,UPDATER oder GSZ
Sonstiges  :         Die Programmecke ist nur fr eingetragene User.

   Tip : Morgens ab 4:00 Uhr ist die Box weitgehenst bis 9:00 Uhr frei !

Besonderheit:        TumTausch - Maustauschkompatibel !

-----------------------------------------------------------------------------
Box        :         MADNESS Headquarter         Hamburg Wedel
Baudrate   :         1200 - 14400 V.32bis, V.42bis, MNP-5

Tel.-Nummer:         04103-18391
Sperrzeiten:         - keine -

Updater    :         Eingabe von GSZRZ,UPDATER oder GSZ
Sonstiges  :         Die Programmecke ist unbeschrnkt benutzbar

Besonderheit:        TumTausch - Maustauschkompatibel !

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

Box        :         Tuma Box           Augsburg
Baudrate   :         1200 - 16800 V32 V32bis ZyXel-Mode

Tel.-Nummer:         0821 - 667766

Updater    :         Eingabe von GSZRZ,UPDATER oder GSZ
Sperrzeiten:         - keine -


Sonstiges  :         Die Programmecke ist benutzbar,allerdings nur ein
                     File pro LOGIN,bei Interresse an mehr bitte Userantrag.

-----------------------------------------------------------------------------
Box        :         no|where         Udenbreth/Eifel
Baudrate   :         1200 - 16800 V32 V32bis

Tel.-Nummer:         02448 - 8009

Updater    :         Eingabe von GSZRZ,UPDATER oder GSZ
Sonstiges  :         Die Programmecke ist benutzbar,allerdings nur ein
                     File pro LOGIN,bei Interresse an mehr bitte Userantrag.

Sperrzeiten:         05:30 - 06:00

Besonderheit:        TumTausch - Maustauschkompatibel !

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

Box        :         Basi-Box           Bassersdorf Schweiz
Baudrate   :         1200 - 14400 V.32 V32.bis, MNP & V.42bis, HST

Tel.-Nummer:         0041-1-8364174

Updater    :         Eingabe von GSZRZ,UPDATER oder GSZ
Sperrzeiten:         - keine -


Sonstiges  :         Gastdownload unbeschrnkt mglich.

Besonderheit:        TumTausch - Maustauschkompatibel !

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

ADRESSE
-------

XENIA Software                       XENIA Software
Michael Ziegler                      Michael Ziegler
Jagdfeldring 16                      Kreissparkasse Mnchen
D-85540 Haar                         BLZ 702 501 50
                                     Kto: 420354680

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

