home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / STARC20.LZH / STARCALL / SZRZ / GSZRZ.TXT next >
Text File  |  1992-06-14  |  31KB  |  865 lines
  1.                                                     XENIA Software
  2.                                                     Michael Ziegler
  3.                                                     Jagdfeldring 16
  4.                                                     8013 Haar
  5.                                                     Tel. 089-4602746
  6.  
  7.  
  8.  
  9.  
  10.                     GSZRZ Zmodem Paket für ATARI ST/TT
  11.  
  12.  
  13.  
  14.  
  15.  
  16. HAFTUNGSAUSSCHLUSS
  17. ------------------
  18.  
  19. Die Programme  wurden ausführlich getestet.  Für etwaige  Schäden, die
  20. durch die Verwendung von Programmen  des GSZRZ Paketes entstehen, kann
  21. ich keine Haftung übernehmen.
  22.  
  23. Sollten Sie  trotzdem einen Fehler feststellen  oder Verbesserungsvor-
  24. schläge haben, so können sie mich  entweder unter der oben angegebenen
  25. Anschrift oder über folgende Mailbox-Netze erreichen:
  26.  
  27. Michael Ziegler @ M im Mausnet
  28. Michael Ziegler 2:246/70.5 im Fidonet
  29.  
  30.  
  31.  
  32. ÜBERBLICK
  33. ---------
  34.  
  35.     Das GSZRZ-Paket beinhaltet  die X/Y/ZMODEM Übertragungs-Protokolle
  36.     für den ATARI ST/TT.
  37.  
  38.     Die  Programme sind  in Verbindung  mit  annähernd jedem  Terminal
  39.     Programm einsetzbar.
  40.  
  41.     Der  Übertragungsstatus wird  in einer  Dialog-Box angezeigt.  Die
  42.     letzte Meldung  bei Verlassen  wird auch  nach STDERR  ausgegeben.
  43.     Wird GSZRZ mit RUFUS von Michael Bernards betrieben, so wird diese
  44.     Message in das RUFUS-Terminalfenster ausgegeben.
  45.  
  46.  
  47.  
  48. DATEIEN
  49. -------
  50.  
  51.     Folgende Dateien sind im GSZRZ Paket enthalten:
  52.  
  53.     GSZRZ_TT.ACC   ATARI TT Version das Accessory bzw. GEM Programmes
  54.                    Diese Version ist NICHT auf dem ATARI ST lauffähig!
  55.     GSZRZ_TT.TTP   ATARI TT Version OHNE GEM-Dialog-Box
  56.                    Diese Version ist NICHT auf dem ATARI ST lauffähig!
  57.     GSZRZACC.ACC   ATARI ST Version des Accessory bzw. GEM Programmes
  58.     GSZRZ_ST.TTP   ATARI ST Version OHNE GEM-Dialog-Box
  59.     GSZRZ.TXT      diese Dokumentation
  60.     HISTORY.TXT    der Lebenslauf von GSZRZ
  61.     GACCTEST.C     Pure-C Quellcode Beispiel für Accessory Schnitt-
  62.                    stelle
  63.     GACCTEST.TTP   Ausführbares Programm
  64.     RS232ENC.LZH   Archiv des RTS/CTS Patches für den ATARI ST von
  65.                    Michael Bernards
  66.     SERPTCH2.LZH   Archiv des RTS/CTS Patches für den ATARI TT von
  67.                    ATARI Computer
  68.  
  69.     Die Accessory  Programme können  auch durch  Umbennen als  normale
  70.     GEM-Programme verwendet  werden. Durch  den ERSTEN  Parameter wird
  71.     dann ausgewählt, ob  Senden (-sz) oder Empfang  (-rz) durchgeführt
  72.     werden soll.
  73.  
  74.  
  75. INSTALLATION
  76. ------------
  77.  
  78.     Die Installation hängt von dem verwendeten Terminalprogramm ab. An
  79.     dieser Stelle ein paar Tips zur Installation mit RUFUS.
  80.  
  81.     Wenn  Sie genügend  Speicherplatz zur  Verfügung haben,  empfiehlt
  82.     sich die Installation als Accessory.  Dann einfach GSZRZACC.ACC in
  83.     das Rootdirectory kopieren. Im Dialog 'Protokoll' von RUFUS den
  84.     Slot ZMODEM einstellen. Dann Paramter sichern.
  85.  
  86.     Will man das TT-Accessory benützen,  so mu₧ man es  entweder umbe-
  87.     nennen,   oder  in   RUFUS.RUF   mit   einem  Editor   die   Zeile
  88.     ACCNAME=GSZRZ_TT.ACC eintragen.
  89.  
  90.  
  91.     Bei Verwendung  als PRG  (Accessory umbenennen  in PRG)  die Datei
  92.     GSZRZxxx.PRG in das Modul-Directory von  RUFUS kopieren. Im Dialog
  93.     'Protokoll'  von   RUFUS  einen  freien  Slot   einstellen.  Einen
  94.     Protokoll-Namen  eintragen. Bei  Typ EXTERN  einstellen. Dann  bei
  95.     Sender durch anklicken der Namenszeile GSZRZxxx.PRG auswählen. Bei
  96.     Parameter  -sz und  eventuelle  andere  Paramter eintragen  (durch
  97.     Leerzeichen  getrennt). Dann  bei  Empfänger  durch anklicken  der
  98.     Namenszeile ebenfalls  GSZRZxxx.PRG auswählen.  Bei Parameter  -rz
  99.     und  eventuelle   andere  Parameter  eintragen.   Dann  'Parameter
  100.     sichern'.
  101.  
  102.  
  103.  
  104. COMMANDLINE PARAMETER
  105. ---------------------
  106.  
  107.     Bitte  achten Sie  darauf, da₧  die Parameter  bei Gross-/  Klein-
  108.     schreibung  unterschiedliche Bedeutung  aufweisen können!  Deshalb
  109.     immer an die angegebenen Parameter  halten. Mehrere Parameter sind
  110.     durch Leerzeichen getrennt anzugeben (siehe Beispiele).
  111.  
  112.     GSZRZ beinhaltet sowohl Sende- als auch Empfangsroutinen. Um GSZRZ
  113.     mitzuteilen,  ob Senden  oder  Empfangen  erfolgen soll,  mu₧  als
  114.     ERSTER Parameter  -sz für Senden  oder -rz für Empfangen angegeben
  115.     werden. Bei Verwendung als Accessory  zusammen mit RUFUS wird dies
  116.     automatisch durch RUFUS erledigt.
  117.  
  118.     Wird nicht  Parameter -a  angegeben, so  wird immer  im Binär-Mode
  119.     übertragen!
  120.  
  121.     Von der  Übertragungsgeschwindigkeit her  gesehen, ist  das ZModem
  122.     von GSZRZ  default auf die höchstmögliche  Übertragungsrate einge-
  123.     stellt. Hat man  eine sehr schlechte Leitung und  kein MNP/V42, so
  124.     ist es sicherer, wenn man mit Parameter -l 1024 eine Blockquittung
  125.     verwendet  (siehe Parameter  -l  beim Senden).  Da  ist die  Über-
  126.     tragung allerdings etwas langsamer.
  127.  
  128.  
  129.  
  130. PARAMETER bei EMPFANG
  131. ---------------------
  132.  
  133. Umsetzung von eingehenden Newline-Zeichen
  134.  
  135.     -a          Diese Funktion wird verwendet,  um ASCII Übertragungen
  136.                 z.B. von einem Unix System  auf den ATARI vorzunehmen.
  137.                 Dabei werden  eingehende Linefeeds  in Carriage-Return
  138.                 Linefeed umgesetzt.
  139.  
  140.  
  141. Puffergrö₧e:
  142.  
  143.     -b  SIZE    Mit diesem  Parameter wird  die Grö₧e  des verwendeten
  144.                 Puffers der  seriellen Schnittstelle  für den  Empfang
  145.                 eingestellt. SIZE ist  die Grö₧e des Puffers  in Byte.
  146.                 Der  eingestellte  Defaultwert von  1024  Byte  dürfte
  147.                 ausreichend sein.
  148.  
  149.                 SIZE:  default 1024  Byte, minimal  128 Byte,  maximal
  150.                        16384 Byte
  151.  
  152.  
  153. Einstellen des CRC bei XModem
  154.  
  155.     -c          Wird dieser  Parameter angegeben,  so wird  bei XMODEM
  156.                 anstelle der Prüfsumme  ein 16 Bit CRC verwendet. Dies
  157.                 ist im Prinzip  auch sicherer. Jedoch kann nicht jedes
  158.                 Xmodem Protokoll auch mit CRC arbeiten.
  159.  
  160.  
  161. Unterdrückung der Carrier-Überwachung
  162.  
  163.     -D          Wird  dieser Parameter  angegeben, so  wird die  Über-
  164.                 wachung des Carrier Detect unterdrückt.
  165.  
  166.  
  167. Setzen des Datei Puffers
  168.  
  169.     -F SIZE     Mit diesem Parameter kann  die Grösse des Dateipuffers
  170.                 gesetzt  werden. Wenn  eine Datei  empfangen wird,  so
  171.                 werden die eingehenden Bytes in einem Puffer abgelegt.
  172.                 Ist dieser Puffer voll, so wird  er auf die Harddisk /
  173.                 Diskette  geschrieben.  Das beeinflu₧t  natürlich  die
  174.                 Übertragungsgeschwindigkeit. Darum kann  die Grö₧e des
  175.                 Puffers  manipuliert werden.  Der  Parameter gibt  die
  176.                 Grö₧e des Puffers in Byte an.
  177.  
  178.                 SIZE: default  8192 Byte, minimal 1024  Bytes, maximal
  179.                       262144 Bytes.
  180.  
  181.  
  182. Einstellen des Stream-Modus bei XMODEM/YMODEM
  183.  
  184.     -g          Wird dieser  Parameter angegeben,  so wird  bei XMODEM
  185.                 bzw. YMODEM der Stream-Mode benützt. Das bedeutet, da₧
  186.                 keine Quittung pro Datenblock  an den Sender geschickt
  187.                 wird.  Normalerweise   wird  nach   jedem  empfangenen
  188.                 Datenblock eine  Quittung an den Sender  geschickt, um
  189.                 mitzuteilen, da₧  der Block  empfangen wurde.  Hat man
  190.                 eine zuverlässige Verbindung, (MNP5,  V42bis), so kann
  191.                 die  Übertragungsgeschwindigkeit durch Wegfall  dieser
  192.                 Quittung erhöht werden.
  193.  
  194.  
  195. Akustische Anzeige des Übertragungsendes
  196.  
  197.     -G          Am Ende  der Übertragung wird  ein 'Pling'  ausgegeben
  198.  
  199.  
  200. Übertragung über die MIDI Schnittstelle
  201.  
  202.     -m          Wird  dieser  Parameter  angegeben,   so  erfolgt  die
  203.                 Übertragung  nicht über  die RS232,  sondern über  die
  204.                 MIDI Schnittstelle. Dieser Parameter mu₧ nicht angege-
  205.                 ben werden,  wenn GSZRZ  als Accessory  mit RUFUS  zu-
  206.                 sammen arbeitet. Da wird  automatisch immer die momen-
  207.                 tan bei RUFUS eingestellte Schnittstelle verwendet.
  208.                 (siehe Beispiel)
  209.  
  210. Abschalten des Maus-Interrupts
  211.  
  212.     -M          Durch diesen Parameter wird  der Mausinterrupt während
  213.                 der Übertragung abgeschaltet. Da bei manchen Benutzern
  214.                 Störungen der Übertragung auftraten,  wenn während der
  215.                 Übertragung die Maus bewegt wurde, ist es durch diesen
  216.                 Parameter möglich, den Mausinterrupt abzuschalten.
  217.  
  218.  
  219. Verhalten bei bereits existierender Datei
  220.  
  221.     Bei YMODEM und ZMODEM wird der  Dateiname bereits durch den Sender
  222.     vorgegeben.  Wenn dieser  Dateiname  bereits  existiert, kann  die
  223.     Reaktion auf diesen Fall eingestellt werden.
  224.  
  225.     -e          Wenn die zu empfangende  Datei bereits existiert, wird
  226.                 der Dateityp auf  001, wenn dies auch  schon existiert
  227.                 auf 002 etc. umbenannt.
  228.  
  229.  
  230.     -o FILE.EXT Der durch den Sender vorgegebene Dateinamen wird durch
  231.                 FILE.EXT ersetzt. Achtung: hier darf KEIN Pfad angeben
  232.                 werden.
  233.  
  234.     -p          Wenn Datei bereits existiert, durch SKIP an den Sender
  235.                 die  Übertragung dieser  Datei überspringen  (Achtung:
  236.                 kleines 'p' verwenden!)
  237.  
  238.     -y          Wenn  die Datei  bereits  existiert,  dann soll  diese
  239.                 gelöscht werden.
  240.  
  241.  
  242. Festlegen des Download-Directories
  243.  
  244.     -P PFAD     Durch Angabe dieses Parameters kann  das Zieldirectory
  245.                 bestimmt   werden.   Wird   dieser   Parameter   nicht
  246.                 angegeben,  so  landen  empfangene  Dateien  immer  im
  247.                 aktuellen Directory.
  248.  
  249.  
  250. Ausgaben bei Verlassen von GSZRZ an STDERR unterdrücken
  251.  
  252.  
  253.     -q          Wird dieser  Parameter angegeben, so wird  die Ausgabe
  254.                 der letzten  Meldung an STDERR  unterdrückt. (Sinnvoll
  255.                 bei Terminalprogrammen, die keine Umlenkung von STDERR
  256.                 vornehmen)
  257.  
  258.  
  259. Fortsetzen des Empfangs eines abgebrochenen Downloads
  260.  
  261.     -r          Wenn Datei bereits besteht, dann  mit Resume die Über-
  262.                 tragung fortsetzen. (nur bei ZMODEM)
  263.  
  264.  
  265. Setzen des Systemdatums für eine empfangene Datei.
  266.  
  267.     -s          Das File-Datum für empfangene Dateien auf das aktuelle
  268.                 Datum   setzen.  (Y/ZMODEM)   Kann  hauptsächlich   in
  269.                 Mailboxprogrammen von Nutzen sein.
  270.  
  271.  
  272. Ausgabe der erreichten CPS Rate am Ende der Übertragung
  273.  
  274.     -S          Wird dieser Parameter  angegeben, so wird am  Ende der
  275.                 Übertragung  die  erreichte CPS-Rate  an  STDERR  aus-
  276.                 gegeben.
  277.  
  278.  
  279. Einstellen der Timeout Zeit
  280.  
  281.     -t TIM      Die  Timeout  Zeit  wird   auf  TIM  Zehntel  Sekunden
  282.                 gesetzt.  Wurde   aufgenommen,  da   scheinbar  manche
  283.                 Mailboxen  recht  lange  brauchen,   bis  eine  ZMODEM
  284.                 Übertragung aufgenommen wird.  Normalerweise sollte es
  285.                 mit der Default-Einstellung aber keine Probleme geben.
  286.                 Defaultwert: 100, min: 10, max 1000
  287.  
  288.  
  289. Protokoll bei Empfang
  290.  
  291.     Default wird ZMODEM verwendet. Soll eines der anderen Protokolle
  292.     verwendet werden, so kann dies durch folgende Parameter erreicht
  293.     werden:
  294.  
  295.     -X          XMODEM-Protokoll verwenden
  296.  
  297.     -Y          YMODEM-Protokoll verwenden
  298.  
  299.  
  300.  
  301. Compression von ASCII Dateien
  302.  
  303.     -z          RLE Kompression verwenden. Ist nur dann sinnvoll, wenn
  304.                 im  ASCII-Mode  übertragen  wird und  KEIN  MNP5  oder
  305.                 V42bis eingesetzt wird. RLE  ist ein relativ einfacher
  306.                 Kompressionsalgorithmus. Dafür aber so schnell, da₧ es
  307.                 die Übertragungsrate immer noch positiv beeinflu₧t.
  308.  
  309.  
  310. Überprüfung der Online Zeit
  311.  
  312.     -U time         verbleibende Onlinezeit
  313.     -C baudrate     aktuelle Baudrate
  314.  
  315.     Für den  Einsatz in  Mailboxprogrammen wurde  für den  Empfang die
  316.     Prüfung der noch verbleibenden  Online-Zeit aufgenommen (Stichwort
  317.     NetCall Hour). Dazu sind die beiden Parameter -C und -U notwendig.
  318.     Bei -C wird  der folgende Wert als  aktuelle Baudrate ausgewertet.
  319.     -U ist die  restliche Onlinezeit in Sekunden. Reicht  die Zeit für
  320.     einen Upload  nicht mehr aus,  so wird RZ  mit Exitcode 9  und dem
  321.     Hinweis  'not  enough  time for  upload'  abgebrochen.  Zu  diesem
  322.     Zeit-punkt ist  noch keine  Datei angelegt,  es bleiben  also auch
  323.     keine  Datei-Leichen  zurück.  Wird  durch  Blockwiederholung  die
  324.     verfügbare  Online-Zeit überschritten,  so  wird  der Empfang  mit
  325.     Exitcode 10  abgebrochen. Die  empfangene Datei  wird geschlossen,
  326.     kann also eventuell später komplettiert werden.
  327.  
  328.     Beispiel: -rz -C 19200 -U 100
  329.  
  330.  
  331. BEISPIELE
  332. ---------
  333.  
  334. Ein paar Beispiele für Aufrufe von RZ:
  335.  
  336. -rz                  Empfang mit ZMODEM
  337.  
  338. -rz -Y               Empfang mit YMODEM
  339.  
  340. -rz -Y -g            Empfang mit YMODEM-1k-g
  341.  
  342. -rz -X TEST.XYZ      Empfang mit XMODEM. Bei Empfang mit XMODEM  M U S S
  343.                      immer ein Dateiname angegeben werden, da bei XMODEM
  344.                      der Dateiname nicht mit übertragen wird!
  345.  
  346. -rz -y -o TEST.XYZ -P D:\MAIL\DOWNLOAD
  347.                      Empfang mit ZMODEM,  Carrierüberwachung disabled,
  348.                      Zieldirectory   vorgeben,   Dateiname   vorgeben,
  349.                      eventuell vorhandene Datei löschen.
  350.  
  351. rz -m                Empfang über die MIDI-Schnittstelle
  352.  
  353.  
  354.  
  355.  
  356. PARAMETER bei SENDEN
  357. --------------------
  358.  
  359. Mögliche Commandline-Parameter bei Senden:
  360.  
  361. Anhängen an existierende Datei
  362.  
  363.    -+           Der Empfänger soll an ein existierendes File anhängen.
  364.                 Nur ZModem.
  365.  
  366.  
  367. ASCII Transfer
  368.  
  369.    -a           ASCII-Transfer, Rx soll CRLF übersetzen. Nur ZModem.
  370.  
  371.  
  372. Break unterdrücken
  373.  
  374.    -b           Bei einem Retry wird KEIN Break an das Modem ausge-
  375.                 geben. Nur ZModem. Normal wird bei einer Blockwieder-
  376.                 holung ein Break an das Modem geschickt, um den
  377.                 Modem-Puffer zu leeren.
  378.  
  379.  
  380. Konvertieren von '.'
  381.  
  382.    -d           Punkte '.' in Pfadnamen in '/' konvertieren. Nur bei
  383.                 YModem und ZModem. Wenn der Empänger keine '.' in
  384.                 Dateinamen haben will/kann.
  385.  
  386.  
  387. Carrier Überwachung
  388.  
  389.    -D           Überwachung des Carrier Detect unterdrücken
  390.  
  391.  
  392. Pfadangaben an Empfänger senden
  393.  
  394.    -f           Wird dieser Parameter angegeben, so wird die komplette
  395.                 Pfadangabe  mit  dem Dateinamen  übertragen.  Nur  bei
  396.                 ZModem. GSZRZ  schneidet bei Empfang  von  Pfaden  die
  397.                 Laufwerksbezeichnung  (z.B. D:\) ab. Stattdessen  wird
  398.                 ein eventuell mit -P angegebener Pfad davorgesetzt.
  399.  
  400. Setzen des Datei Puffers
  401.  
  402.    -F SIZE      Mit diesem Parameter kann  die Grösse des Dateipuffers
  403.                 gesetzt  werden. Wenn  eine Datei  empfangen wird,  so
  404.                 werden die eingehenden Bytes in einem Puffer abgelegt.
  405.                 Ist dieser Puffer voll, so wird  er auf die Harddisk /
  406.                 Diskette  geschrieben.  Das beeinflu₧t  natürlich  die
  407.                 Übertragungs-geschwindigkeit. Darum kann die Grö₧e des
  408.                 Puffers  manipuliert werden.  Der  Parameter gibt  die
  409.                 Grö₧e des Puffers in Byte an.
  410.  
  411.                 SIZE: default  8192 Byte, minimal 1024  Bytes, maximal
  412.                       262144 Bytes.
  413.  
  414.  
  415. Akustische Anzeige des Übertragungsendes
  416.  
  417.     -G          Am Ende der Übertragung wird ein 'Pling' ausgegeben
  418.  
  419.  
  420. Blockgrö₧e bei XModem / YModem
  421.  
  422.     -k          1024 Byte Pakete senden. Default werden bei XModem und
  423.                 YModem 128 Byte Pakete verwendet.
  424.  
  425.  
  426. Empfänger Quittung anfordern
  427.  
  428.     -l N        Alle  N  Bytes  (32  <= N  <=  1024)  Quittierung  von
  429.                 Empfänger anfordern. Nur bei  ZModem. Default wird bei
  430.                 ZModem der Stream-Mode verwendet. Das bedeutet da₧ der
  431.                 Sender  fortlaufend  Datenblöcke schickt  und  nur  im
  432.                 Fehlerfall  vom Empfänger  zu einer  Blockwiederholung
  433.                 aufgefordert  wird. Dadurch  wird  im Stream-Mode  ein
  434.                 höherer  Datendurchsatz  erreicht. Ist aber kein Hard-
  435.                 ware-Handshake  vorhanden (z.B. MIDI) mu₧ durch diesen
  436.                 Parameter für ein Software Handshake gesorgt werden.
  437.  
  438.  
  439. Übertragung über die MIDI Schnittstelle
  440.  
  441.     -m          Wird  dieser  Parameter  angegeben,   so  erfolgt  die
  442.                 Übertragung  nicht über  die RS232,  sondern über  die
  443.                 MIDI   Schnittstelle.  Dieser   Parameter  mu₧   nicht
  444.                 angegeben werden,  wenn GSZRZ als Accessory  mit RUFUS
  445.                 zusammen  arbeitet.  Da  wird  automatisch  immer  die
  446.                 momentan   bei   RUFUS    eingestellte   Schnittstelle
  447.                 verwendet.
  448.  
  449.                 Da  es bei  der  MIDI  Schnittstelle keine  Handshake-
  450.                 leitungen gibt, mu₧  man durch Angabe von  -l 1024 für
  451.                 ein Software-Handshake sorgen.
  452.  
  453.  
  454. Abschalten des Maus-Interrupts
  455.  
  456.     -M          Durch diesen Parameter wird  der Mausinterrupt während
  457.                 der Übertragung abgeschaltet. Da bei manchen Benutzern
  458.                 Störungen der Übertragung auftraten,  wenn während der
  459.                 Übertragung die Maus bewegt wurde, ist es durch diesen
  460.                 Parameter möglich, den Mausinterrupt abzuschalten.
  461.  
  462.  
  463. Bedingte Übertragung
  464.  
  465.     -n          Datei nur dann senden, wenn sie NEUER oder länger ist,
  466.                 als eine bereits beim Empfänger existierende Datei.
  467.                 Nur ZModem.
  468.  
  469.  
  470.     -N          Datei nur  dann senden, wenn  sie länger ist  oder ein
  471.                 ANDERES  Datum  aufweist,  als   beim  Empfänger.  Nur
  472.                 ZModem.
  473.  
  474.  
  475. 16 Bit CRC
  476.  
  477.     -o          Bei ZMODEM nur  16 Bit CRC verwenden.  Spart pro über-
  478.                 tragenem  Block 2  Byte. Ist  also  was für  Geschwin-
  479.                 digkeitsfanatiker :-) Es gibt ältere ZModem Programme,
  480.                 die nur 16 Bit CRC verwenden.
  481.  
  482.  
  483. Schützen einer bereits vorhandenen Datei
  484.  
  485.     -p          Wenn die zu übertragende  Datei bereits beim Empfänger
  486.                 existiert,  wird die  Übertragung NICHT  durchgeführt.
  487.                 Nur bei ZModen.
  488.  
  489.  
  490. Ausgaben bei Verlassen von GSZRZ an STDERR unterdrücken
  491.  
  492.  
  493.     -q          Wird dieser  PArameter angegeben, so wird  die Ausgabe
  494.                 der letzten  Meldung an STDERR  unterdrückt. (Sinnvoll
  495.                 bei Terminalprogrammen, die keine Umlenkung von STDERR
  496.                 vornehmen)
  497.  
  498.  
  499. Fortsetzen einer abgebrochenen Übertragung
  500.  
  501.     -r          Wenn die  Datei beim  Empfänger bereits  besteht, dann
  502.                 soll die  Übertragung mit  Resume fortgesetzt  werden.
  503.                 Das bedeutet,  da₧ mit der  Übertragung an  der Stelle
  504.                 fortgefahren   wird,  wo   eine  frühere   Übertragung
  505.                 abgebrochen  wurde.  Das  sollte man  aber  nnur  dann
  506.                 machen, wenn man sich absolut  sicher ist, da₧ es sich
  507.                 um exact die gleiche Datei handelt.
  508.  
  509.  
  510. Script File für Senden benützen
  511.  
  512.     -s FILE.EXT Die  Namen der  zu sendenden  Dateien  werden aus  dem
  513.                 Script-File Datei.Ext gelesen.  Nur ZModem. Praktisch,
  514.                 wenn man  wiederholt die  gleichen Dateien  übertragen
  515.                 mu₧.
  516.  
  517.  
  518. Ausgabe der erreichten CPS Rate am Ende der Übertragung
  519.  
  520.     -S          Wird dieser Parameter  angegeben, so wird am  Ende der
  521.                 Übertragung  die  erreichte CPS-Rate  an  STDERR  aus-
  522.                 gegeben.
  523.  
  524.  
  525. Einstellen der Timeout Zeit
  526.  
  527.     -t TIM      Die  Timeout  Zeit  wird   auf  TIM  Zehntel  Sekunden
  528.                 gesetzt. Das  ist die Zeit,  die auf eine  Antwort vom
  529.                 Empfänger  gewrtet  wird, bis  ein  Fehler  angenommen
  530.                 wird.    Normalerweise     sollte    es     mit    der
  531.                 Default-Einstellung   aber   keine   Probleme   geben.
  532.                 Defaultwert: 600, min: 10, max 1000
  533.  
  534.  
  535. Datei löschen
  536.  
  537.     -u          Die zu übertragende Datei soll nach der Übertragung
  538.                 gelöscht werden.
  539.  
  540.  
  541. Existierende Datei überschreiben
  542.  
  543.     -y          Der Empfänger soll eine eventuell bereits existierende
  544.                 Datei gleichen Namens überschreiben. Nur ZModem.
  545.  
  546.  
  547. Protokoll bei Senden
  548.  
  549.     Default wird ZMODEM verwendet. Soll eines der anderen Protokolle
  550.     verwendet werden, so kann dies durch folgende Parameter erreicht
  551.     werden:
  552.  
  553.     -X          XMODEM-Protokoll verwenden
  554.  
  555.     -Y          YMODEM-Protokoll verwenden
  556.  
  557.  
  558. Compression von ASCII Dateien
  559.  
  560.     -z          RLE Kompression verwenden. Ist nur dann sinnvoll, wenn
  561.                 im  ASCII-Mode  übertragen  wird und  KEIN  MNP5  oder
  562.                 V42bis eingesetzt wird. RLE  ist ein relativ einfacher
  563.                 Kompressionsalgorithmus. Dafür aber so schnell, da₧ es
  564.                 die Übertragungsrate immer noch positiv beeinflu₧t.
  565.  
  566.  
  567. Gro₧e Blöcke übertragen
  568.  
  569.     -8          Beim  Senden  8KB  Blöcke  verwenden.  ACHTUNG:  Diese
  570.                 Option verträgt sich nur mit wenigen ZModem Programmen
  571.                 am anderen Ende.
  572.  
  573.  
  574.  
  575. BEISPIELE
  576. ---------
  577.  
  578. Ein paar Beispiele für Parameterangaben beim Senden
  579.  
  580. sz TEST.XYZ             Senden mit ZMODEM
  581.  
  582. sz *.C *.H              Alle Dateien mit der Extension .C und .H mit
  583.                         ZMODEM senden.
  584.  
  585. sz -Y TEST.XYZ          Senden mit YMODEM
  586.  
  587. sz -Y -k TEST.XYZ       Senden mit YMODEM-1k-g
  588.  
  589. sz -X TEST.XYZ          Senden mit XMODEM
  590.  
  591. sz -8 TEST.XYZ          Senden mit ZMODEM in 8 KB Blöcken
  592.  
  593. sz -m -l 1024 TEST.XYZ  Senden über die MIDI Schnittstelle.
  594.  
  595. Wird am anderen Ende auch GSZRZ verwendet, so kann durch Angabe von
  596.  
  597. sz -m -8 -l 8192 TEST.XYZ auch in 8 KB-Blöcken übertragen werden.
  598.  
  599.  
  600.  
  601. EXITCODES
  602. ---------
  603.  
  604. Folgende Exitcodes werden  von GSZRZ bei Beendigung  des Programmes an
  605. den Aufrufer zurückgegeben:
  606.  
  607. 1  Argument Fehler, Commandline  fehlerhaft
  608. 2  Initialisierungsfehler (graf_handle,  appl_init)
  609. 3  Abbruch durch Eingabe von Ctrl-Alt
  610. 4  Speicher Anforderungsfehler, nicht genug  Speicher vorhanden
  611. 5  Carrier lost
  612. 8  ungültiger Struktur Zeiger (siehe ACC-Protokoll)
  613.  
  614. 128- Transfer-Fehler  Sollen z.B. 4 Files gesendet werden und bei 2
  615.                       Dateien SKIPPED der Receiver, so wird 128 + 2
  616.                       = 130 zurückgegeben. Kommt gar kein Sync zu-
  617.                       stande (Timeout), wird 128 zurückgegeben.
  618.  
  619.  
  620.  
  621. ACC-PROTOKOLL von GSZRZ
  622. -----------------------
  623.  
  624. GSZRZ als  ACC wird  durch ein  spezielles Protokoll  über die  Appli-
  625. cation-Message Funktion des GEM angesprochen.
  626.  
  627. msgbuf[0]   enthält die Kenn-Nummer für das ACC Protokoll. Sie
  628.             besteht aus den beiden Buchstaben 'GZ' entsprechend
  629.             dem Hexwert 0x475A.
  630.  
  631. msgbuf[1]   enthält den Application-ID, also den Wert, der bei
  632.             appl_init() als Rückgabewert erhalten wird.
  633.  
  634. msgbuf[2]   mu₧ immer 0 sein
  635.  
  636. msgbuf[3]   enthält die Länge des Commandlinestrings.
  637.  
  638. msgbuf[4]   untere 16 Bit des Pointers auf den Commandline String.
  639.  
  640. msgbuf[5]   obere 16 Bit des Pointers auf den Commandline String.
  641.  
  642.             Der Commandline-String  muss mit 0x00  abgeschlossen sein.
  643.             Er beinhaltet  die üblichen Switches,  wie bei  Aufruf als
  644.             PRG, also z.B. "-rz -D -P C:\\DOWNLOAD"
  645.  
  646. msgbuf[6]   untere 16 Bit des unten beschriebenen Struktur-Pointers
  647. msgbuf[7]   obere 16 Bit des Struktur Pointers
  648.  
  649.  
  650. typedef struct
  651. {
  652.     int version;                        /* Versionsnummer */
  653.     int baud;
  654.     int flow;
  655.     int ucr;
  656.     int flags;
  657.     int nbaud;
  658.     unsigned *bauds;
  659.  
  660.     /* nun folgen die Pointer auf verschiedene Funktionen */
  661.  
  662.     void (*set_rs232)(int baud, int flow, int ucr);
  663.     int (*instat)(void);                /* Rx Status        */
  664.     int (*in)(void);                    /* Rx Character     */
  665.     int (*outstat)(void);               /* Tx Status        */
  666.     void (*out)(int c);                 /* Tx Character     */
  667.     void (*send_break)(int brktim);     /* send break       */
  668.     int (*carrier)(void);               /* Carrier Status   */
  669.     void (*DTR)(int on_off);
  670.     int (*DSR)(void);
  671. }COM;
  672.  
  673. Von  dieser Struktur  werden von  GSZRZ nur  die Function-Pointer  für
  674. Rx-Status,  Rx-Character,  Tx-Status,  Tx-Character,  Send  Break  und
  675. Carrier-Status sowie 'version' verwendet.
  676.  
  677. In  'version'  ist  die   Versionsnummer  des  aufrufenden  Programmes
  678. enthalten. Die höherwertigen 16 Bit entsprechen der Versionsnummer vor
  679. dem  Komma. Die  niederwertigen  16 Bit  nach  dem Komma.  Ausgewertet
  680. werden nur die oberen 16 Bit. Diese müssen den Wert 1 enthalten. Damit
  681. ist gewährleistet, da₧ die Struktur den richtigen Aufbau enthält.
  682.  
  683. Kann kein gültiger Strukturpointer festgestellt  werden, so werden die
  684. Bios-funktionen der aktuell eingestellten Schnittstelle benützt.
  685.  
  686.  
  687.  
  688. Rückmeldungen von GSZRZ
  689. =======================
  690.  
  691. Wenn GSZRZ beendet wird, so erfolgt eine Rückmeldung an des aufrufende
  692. Programm:
  693.  
  694. msgbuf[0] = GZ_PRIVATE;
  695. msgbuf[1] = appl_id;
  696. msgbuf[2] = Exitcode;
  697. msgbuf[3] = (int) strlen(Meldung);
  698. msgbuf[4] = (unsigned int) ((long) Meldung & 0XFFFF);
  699. msgbuf[5] = (unsigned int) ((long) Meldung >> 16);
  700. msgbuf[6] = 0;
  701. msgbuf[7] = 0;
  702. appl_write(msgbuf[1], 16, txmsgbuf);
  703.  
  704.  
  705. Meldung ist ein Pointer auf den String, der normal von GSZRZ am Ende
  706. an 'stdout' ausgegeben wird. Bei RUFUS landet dieser String als Meldung von
  707. GSZRZ imTerminalfenster.
  708.  
  709. Exitcode enthält den Returncode von GSZRZ.
  710.  
  711.  
  712.  
  713.  
  714. RTS/CTS HANDSHAKE
  715. -----------------
  716.  
  717. Da die Programme über die  Betriebssystem-Routinen des ST/TT arbeiten,
  718. muss ein  eventuelles RTS/CTS-Handshake entweder  vom Terminalprogramm
  719. (z.B. RUFUS) oder über das Kontrollfeld vorgenommen werden.
  720.  
  721. Da die TOS-Routinen leider  sogar in TOS 1.04 und TOS  3.05 noch immer
  722. fehlerhaft sind, muss ein Patch installiert sein.
  723.  
  724. Für den ATARI ST kann ich RS232ENC empfehlen, das von Michael Bernards,
  725. dem Autor des Terminalprogrammes RUFUS, stammt.
  726.  
  727. Für den  TT empfiehlt sich SERPTCH2 von  ATARI, da werden  gleich alle
  728. Schnittstellen repariert.
  729.  
  730. Bei TOS 3.06 ist SERPTCH2 nicht mehr notwendig.
  731.  
  732.  
  733.  
  734. SHAREWAREVERSIONEN
  735. ------------------
  736.  
  737. Die Programme SZ.PRG und RZ.PRG in  GEM-Version sind nur bis Versionen
  738. kleiner als 2.0  SHAREWARE. Das bedeutet für den Anwender,  da₧ er die
  739. Programme der Versionen < 2.0 frei  kopieren und 3 Wochen testen kann.
  740. Alle  Versionen  ab  2.0 und  aufwärts  sind  persönlich  registrierte
  741. Versionen, die nicht weitergegeben werden dürfen.
  742.  
  743. Werden die Programme  der Versionen < 2.0 über  diesen Zeitraum hinaus
  744. weiter benutzt,  so ist die  EINMALIGE Shareware-Gebühr von  DM 30.-an
  745. den Autor zu entrichten. Der Betrag ist nur einmalig zu entrichten und
  746. berechtigt auch zur Benutzung künftiger GSZRZ-Versionen.
  747.  
  748. Bei Überweisungen  aus dem AUSLAND bitte  daran denken, da₧ bis  zu DM
  749. 10.--an Gebühren anfallen können! (z.B. Schweiz DM 7.50)
  750.  
  751. Registrierte Benutzer bekommen gegen EINSENDUNG EINER LEERDISKETTE UND
  752. EINEM FRANKIERTEN  RÜCKUMSCHLAG die Vollversion. Diese  beinhaltet die
  753. Implementation von XMODEM, XMODEM-1k, XMODEM-g, YMODEM-g, YMODEM Batch
  754. und ZMODEM.
  755.  
  756. Versionen  mit Versionsnummer  >=  2.0  werden NICHT  MEHR  öffentlich
  757. verteilt, sondern nur noch an lizensierte Benutzer vergeben.
  758.  
  759.  
  760.  
  761. DANKESCHÖN
  762. ----------
  763.  
  764. An dieser Stelle möchte ich mich bei meinen Betatestern bedanken.
  765.  
  766. Mein Dank gilt vor allem:
  767.  
  768. Jürgen Meyer, Carsten Meyer Maus @HH2, für das aufopfernde Testen,
  769.  
  770. Michael Bernards für die Unterstützung durch RUFUS 1.11
  771.  
  772. allen Benutzern von GSZRZ, die durch immer neue Vorschläge für eine
  773.  
  774. Weiterentwicklung des GSZRZ Zmodem Paketes sorgen.
  775.  
  776.  
  777.  
  778.  
  779. UPDATE-SERVICE
  780. --------------
  781.  
  782. Für  registrierte  GSZRZ  Benutzer gibt  es  einen  Update-Service  in
  783. verschiedenen Mailboxen.
  784.  
  785. Bis ein neu  registrierter Benutzer diesen Service  in Anspruch nehmen
  786. kann, können ca. 1-2 Wochen vergehen, da die Datei mit den Registrier-
  787. Daten in unregelmä₧igen Abständen in  der jeweiligen Mailbox upgedatet
  788. wird.
  789.  
  790. Dieser Service  ist eine kostenfreie  Einrichtung, die auf  Wunsch von
  791. Mailbox   Betreibern  eingerichtet   wurde.  Ich   kann  daher   nicht
  792. garantieren,  da₧ dieser  Service  jederzeit  erreichbar ist  und  die
  793. aktuellste Version des GSZRZ Paketes installiert hat.
  794.  
  795. Für den Update ist die Seriennummer Ihres GSZRZ Paketes notwendig.
  796. Diese steht in der Datei SERIAL.NUM auf der Original-Diskette.
  797.  
  798. Nach einloggen in die Mailbox mu₧  aus dem Menü der Updater aufgerufen
  799. werden. Das  kann je  nach Mailbox  unterschiedlich erfolgen.  Ist der
  800. Updater aufgerufen, so meldet er sich mit folgendem Text:
  801.  
  802.  
  803. >> Registering GSZRZ-Files V 2.6 (c) 1991, 1992 mz <<
  804.  
  805. A C H T U N G:  Nur für REGISTRIERTE Benutzer erlaubt!
  806. aktulle Version x.yy downloaden ? (J/N)
  807.  
  808. Vorname:
  809. Nachname:
  810. Seriennummer:
  811.  
  812. Nach Eingabe der  erforderlichen Daten wird eine  registrierte Version
  813. erstellt, mit  LHARC gepackt und  anschliessend wahlweise  mit Y-Modem
  814. oder Z-Modem gesendet.
  815.  
  816. Bitte achten Sie bei der Schreibweise von Vor-und Nachname darauf, da₧
  817. diese exakt  wie in  dem Dialogfenster  angezeigt, eingegeben  werden.
  818. Anderenfalls werden Sie als nicht updateberechtigt zurückgewiesen.
  819.  
  820. Der Update-Service wird von folgenden Mailboxen angeboten:
  821.  
  822.  
  823. TURBO TRON HAMBURG
  824.  
  825. Tel.: 040-890 11 62
  826.  
  827. Bps: 1200-14400 V32BIS/V42BIS/HST
  828.  
  829. Onlinezeiten: 18:00  Uhr -2:00 Uhr 20  Minuten 2:00 Uhr -8:00  Uhr 120
  830. Minuten 8:00 Uhr -18:00 Uhr 45 Minuten
  831.  
  832. -Gastdownload nicht  erlaubt !
  833. -Allerdings kann der Updater auch als Gast aufgerufen werden, also ist
  834.  ein Eintrag als User der Box nicht notwendig !
  835. -Kurzwort oder Cursorsteuerung moeglich
  836. -Updateraufruf durch GSZ im Menue.
  837.  
  838.  
  839.  
  840. TUMA BOX AUGSBURG
  841.  
  842. Tel.: 0821-667766
  843.  
  844. Bps: 1200-14400 V32BIS/V42BIS
  845.  
  846. Onlinezeiten: 24h
  847.  
  848. -Gastdownload erlaubt (1 Datei pro Anruf)
  849. -Allerdings kann der Updater auch als Gast aufgerufen werden, also ist
  850.  ein Eintrag als User der Box nicht notwendig !
  851. -Kurzwort oder Cursorsteuerung moeglich
  852. -Updateraufruf durch GSZ im Menue.
  853.  
  854.  
  855. ADRESSE
  856. -------
  857.  
  858. XENIA Software                       XENIA Software
  859. Michael Ziegler                      Michael Ziegler
  860. Jagdfeldring 16                      Kreissparkasse München
  861. D-8013 Haar                          BLZ 702 501 50
  862.                                      Kto: 420354680
  863.  
  864.  
  865.