home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / telecomm / gszrzs47 / gszrzeng.txt < prev    next >
Text File  |  1994-03-26  |  33KB  |  938 lines
  1.                                                  XENIA Software
  2.                                                  Michael Ziegler
  3.                                                  Jagdfeldring 16
  4.                                                  D-85540 Haar, Germany
  5.                                                  Telephone ++49/89/4602746
  6.  
  7.  
  8.  
  9.  
  10.        GSZRZ ZMODEM Program Package for the ATARI ST/STE/TT/FALCON
  11.  
  12.  
  13.  
  14.  
  15. EXEMPTION FROM LIABILITY
  16. ------------------------
  17.  
  18. The programs have been tested exhaustively. XENIA Software shall not be
  19. liable for any damages that result from using programs of the GSZRZ
  20. package.
  21.  
  22. If you find an error nevertheless, you can contact XENIA Software using the
  23. address given above or the following bulletin board system (BBS) net:
  24.  
  25. - Michael Ziegler @ M          in Mausnet
  26.  
  27.  
  28.  
  29.  
  30. SUMMARY
  31. -------
  32.  
  33. The GSZRZ program package comprises the X/Y/ZMODEM file transfer protocols
  34. for the ATARI ST/STE/TT/FALCON computers.
  35.  
  36. The programs can be used in conjunction with almost any communication
  37. program.
  38.  
  39. The transfer status is displayed in a dialog window. When leaving the program,
  40. the final message is written to STDERR output. If GSZRZ is used in conjunction
  41. with Michael Bernards' RUFUS or Wolfgang Wander's CoNnect, this message is
  42. written to the terminal window.
  43.  
  44. GSZRZ can be used under Multi-TOS and MAG!X, too.
  45.  
  46.  
  47.  
  48.  
  49. FILES
  50. -----
  51.  
  52. The GSZRZ program package consists of these files:
  53.  
  54. GSZRZ_30.PRG   ATARI TT/FALCON version of the accessory or GEM program.
  55.                Cannot be run on the ATARI ST!
  56. GSZRZ_ST.PRG   ATARI ST version of the accessory or GEM program
  57. GSZRZENG.TXT   this documentation file
  58. HISTORY.TXT    GSZRZ history file (only in German)
  59. FSER096B.LZH   Archive of Franz Sirl's serial patch for the ATARI MegaST/TT
  60. SERPTCH2.LZH   Archive of ATARI Computer's RTS/CTS patch for the ATARI
  61.                MegaST/TT
  62. HSMODA02.LZH   Archive of Harun Scheutzow's excellent serial patch for all
  63.                ATARIs.
  64.  
  65. The GEM programs can be used as accessory programs by simply renaming the
  66. files to an extension ACC.
  67.  
  68.  
  69.  
  70.  
  71. INSTALLATION
  72. ------------
  73.  
  74. The installation depends on the communication program used. Here are some
  75. hints for installing with RUFUS.
  76.  
  77. If your computer has enough memory available, you can install GSZRZ as
  78. an accessory: Copy GSZRZ_xx.ACC as GSZRZACC.ACC into the root directory,
  79. use the slot ZMODEM in RUFUS' dialog box 'Protokoll', and save the
  80. parameters using 'Parameter sichern'.
  81.  
  82. If you want to use the TT/FALCON accessory, you have to rename it or
  83. enter the line ACCNAME=GSZRZ_30.ACC into the file RUFUS.RUF.
  84.  
  85. This will not be necessary with CoNnect as it can search for the ACC's
  86. name. In CoNnect, you simply click on the button 'ACC suchen' in the dialog
  87. box Transfer. If GSZRZ_xx.ACC can be found, CoNnect will enter its name
  88. accordingly.
  89.  
  90. If you want to use GSZRZ as a PRG, you have to rename the accessory to
  91. GSZRZ_xx.PRG and copy it into RUFUS' module directory. In RUFUS' dialog box
  92. 'Protokoll', enter a free slot, enter a protocol name, choose type EXTERN.
  93. At 'Sender', choose GSZRZxxx.PRG by clicking on the name. At 'Parameter',
  94. enter '-sz' and other parameters as needed separated by blanks. Then, at
  95. 'Empfänger', choose GSZRZxxx.PRG by clicking on the name. At 'Parameter',
  96. enter '-rz' and other parameters as needed separated by blanks. Save the
  97. parameters using 'Parameter sichern'.
  98.  
  99. To use GSZRZ with HARLEKIN III, GSZRZ_xx.ACC has to be renamed to
  100. GSZRZACC.ACC and copied into the root directory of the boot partition. In
  101. 'Optionen' 'ZMODEM' activate 'externes Modul anwenden'. In 'Senden' and
  102. 'Empfangen' you have to enter '-M', at least in HARLEKIN version 3.0 (see
  103. TROUBLE.TXT).
  104.  
  105. MultiTOS
  106. --------
  107.  
  108. If You work with MultiTOS and GSZRZ is not used as program and if another
  109. serial device then MODEM1 is used, then You must specify parameter -H!
  110.  
  111.  
  112. COMMAND LINE PARAMETERS
  113. -----------------------
  114.  
  115. Please note that the case of the parameters is important (e.g., '-g' is
  116. different from '-G') and always use the parameters exactly as indicated.
  117. Multiple parameters have to be separated by blanks (see the examples
  118. below). File name have to be given AFTER the last parameter. If you are
  119. using CoNnect, the '$' has to be the last character of the parameters for
  120. sending.
  121.  
  122. GSZRZ contains routines for sending and receiving. To tell GSZRZ to send or
  123. to receive, the FIRST parameter has to be '-sz' or '-rz'. If you are using
  124. GSZRZ as an accessory in conjunction with RUFUS or CoNnect, this will be
  125. done for you by RUFUS/CoNnect automatically.
  126.  
  127. If you don't specify the parameter '-a', all transfers will be performed in
  128. binary mode.
  129.  
  130. GSZRZ' ZMODEM routines default to the fastest transfer rate possible. If
  131. the phone line is rather noisy and you don't use MNP/V42, it is safer to
  132. specify block acknowledge mode by the parameter '-l 1024' (see parameter -l
  133. for sending). This will slow down the transfer somewhat.
  134.  
  135.  
  136.  
  137.  
  138. PARAMETERS FOR RECEIVING
  139. ------------------------
  140.  
  141. Translation of incoming newline characters
  142.  
  143. -a             This function is used in transferring ASCII files e.g. from
  144.                UNIX systems to the ATARI. Incoming newline characters are
  145.                translated into carriage return/line feed sequences.
  146.  
  147.  
  148. Include protocol end into CPS rate
  149.  
  150. -A             At the end of a file transmission an acknowledge between
  151.                sender and receiver is done. Some people want to include this in
  152.                the final calculation of the CPS rate.
  153.                If -A is set, the last CPS-rate is calculated after the
  154.                acknowledge.
  155.  
  156.  
  157. Receive buffer size
  158.  
  159. -b SIZE        This parameter is used to specify the size of the receive
  160.                buffer of the serial interface. SIZE indicates the buffer's
  161.                size in bytes. The default value of 1024 bytes should be
  162.                sufficient for most cases.
  163.  
  164.                SIZE: default 1024 bytes, minimum 128, maximum 16384
  165.  
  166.  
  167. Use CRC with XMODEM
  168.  
  169. -c             If this parameter is specified, the XMODEM routines use a 16
  170.                bit CRC instead of a simple checksum. While this is safer,
  171.                don't expect every XMODEM protocol program to be able to
  172.                work in this mode.
  173.  
  174.  
  175. Suppress carrier detect
  176.  
  177. -D             If this parameter is specified, the monitoring of the
  178.                carrier detect line will be suppressed.
  179.  
  180.  
  181. Escaping of control characters
  182.  
  183. -e             If this parameter is specified, the 'escaping' of all
  184.                control characters will be performed. (Often used in
  185.                UNIX systems)
  186.  
  187.  
  188. File buffer size
  189.  
  190. -F SIZE        This parameter specifies the size of the file buffer. When
  191.                receiving a file, all incoming characters are stored in a
  192.                buffer. Whenever this buffer fills, it will be written to
  193.                the hard disk/floppy disk. As this affects the transfer
  194.                rate, this buffer's size can be specified. SIZE indicates
  195.                the size of the buffer in bytes, the suffixes 'K' and 'M'
  196.                indicate kilobyte and megabyte, e.g. '-F 16K' and '-F 2M'.
  197.                '-F -1' results in a buffer that uses all available RAM
  198.                except 100 KB.
  199.  
  200.                SIZE: default 8192 bytes, minimum 1024 bytes
  201.  
  202.  
  203. Stream mode in XMODEM/YMODEM
  204.  
  205. -g             If this parameter is specified, XMODEM and YMODEM transfers
  206.                will use the stream mode, i.e. the acknowledging of each
  207.                data block will be suppressed. Usually, after receiving
  208.                every data block an acknowledgement is returned to the
  209.                sender to signal that the block has been received
  210.                successfully. If the connection is reliable (MNP5, V42bis),
  211.                the transfer rate can be increased by omission of the
  212.                acknowledgement.
  213.  
  214.  
  215. Audible indication of the end of the transfer
  216.  
  217. -G             The end of the transfer will be indicated by an audible
  218.                signal ('pling').
  219.  
  220.  
  221. Serial device
  222.  
  223. -H n           With this parameter You can select a serial device. This is
  224.                usefull, if GSZRZ is used as accessory unter MultiTOS.
  225.  
  226.  
  227.                      ST           MSTE      TT      FALCON
  228.                 1   AUX           AUX      AUX       AUX
  229.                 3   MIDI          MIDI     MIDI      MIDI
  230.                 6   MODEM1        MODEM1   MODEM1    -
  231.                 7   -             MODEM2   MODEM2    MODEM2
  232.                 8   -             SERIAL2  SERIAL1   SERIAL2/LAN
  233.                 9   -             -        SERIAL2   -
  234.  
  235.  
  236.  
  237. Iconify the GSZRZ window on startup
  238.  
  239.     -I x,y      With this parameter it is possible (only with MultiTOS with
  240.                 AES version > 4.0) to iconify the window of GSZRZ already at
  241.                 startup and position the window at x,y.
  242.  
  243.  
  244.  
  245. Log file
  246.  
  247. -L [x:\path\]filename.ext[,level]
  248.                Log all activities to the file specified.
  249.                On level 1, when GSZRZ stops it will write an entry
  250.                to the file specified using the following format:
  251.  
  252.     SZ: HISTORY.TXT  Len:    20408 Tim: 00.00.18 Err:  0 CPS: x
  253.     RZ: ANSI.SYS     Len:     1709 Tim: 00.00.02 Err:  0 CPS: x
  254.     ^^  ^                    ^          ^              ^
  255.     ||  file name            bytes      duration       error code
  256.     |X/Y/Z protocol
  257.     S or R for Send / Receive
  258.  
  259.                 On level 2, each message displayed on the line
  260.                 'last status/error' is written to the logfile too.
  261.  
  262.  
  263. Use MIDI interface
  264.  
  265. -m             If this parameter is specified, the transfer will be
  266.                performed via MIDI interface. If GSZRZ is used as an
  267.                accessory in conjunction with RUFUS, this parameter
  268.                is added by RUFUS and must not be specified
  269.                (see example below).
  270.  
  271.  
  272. Disable mouse interrupt
  273.  
  274. -M             This parameter disables the mouse interrupt during the
  275.                transfer. Use this parameter if moving the mouse disturbs
  276.                the file transfer. In addition, this parameter causes the
  277.                AES multitasking to be disabled to achieve maximum data
  278.                rates on the ST.
  279.  
  280.  
  281. Reaction on existing file names
  282.  
  283.                In the YMODEM and ZMODEM protocols, the file name is
  284.                specified by the sender. If a file of that name already
  285.                exists, the receiver's reaction can be specified.
  286.  
  287. -o FILE.EXT    The file name specified by the sender will be replaced by
  288.                FILE.EXT. CAUTION: You cannot specify a path here!
  289.  
  290. -p             The receiver will send SKIP to the sender effecting that the
  291.                file will not be transferred. CAUTION: lower case 'p'!
  292.  
  293. -E             The extension of the ALREADY EXISTING file will be changed
  294.                to .001, if that one is already existing to .002 etc.
  295.  
  296. -y             The already existing file will be deleted.
  297.  
  298.  
  299.  
  300. -r             If the sender can handle it, a CRC check is done on the existing
  301.                part of the file. If the CRC's are identically, the transmission
  302.                is resumed. If the file CRC's are different or the sender can't
  303.                handle a CRC verification, an alert with the following possibi-
  304.                lities is displayed:
  305.  
  306.                         Rename  give a new filename for the file to receive
  307.                         Delete  delete the existing file
  308.                         Abort   abort the receive
  309.  
  310. -rr            If the sender can handle it, a CRC check is done on the existing
  311.                part of the file. If the CRC's are identically, the transmission
  312.                is resumed. If the file CRC's are different or the sender can't
  313.                handle a CRC verification, a Resume is done.
  314.  
  315. If none of these parameters are in affect, an alert box is displayed in the way
  316. a different CRC is handled.
  317.  
  318.  
  319. Specify the download directory
  320.  
  321. -P PATH        This parameter specifies the target directory. If this
  322.                parameter has not been specified, all files received will be
  323.                stored in the current directory.
  324.  
  325.                If a file with path affixed to the file name is received, a
  326.                possible drive specifier will be stripped off. The remaining
  327.                path will be appended to the current path or, if a path was
  328.                specified by '-P', to the specified path.
  329.  
  330.                Example: Let C:\MAIL\DOWNLOAD be the current directory.
  331.                Receive a file J:\TEST\XYZ\FILE.EXT. The file stored will
  332.                be:
  333.                    without '-P':
  334.                        C:\MAIL\DOWNLOAD\TEST\XYZ\FILE.EXT
  335.                    with '-P D:\RECEIVE':
  336.                        D:\RECEIVE\TEST\XYZ\FILE.EXT
  337.  
  338.                Non-existent directories will be created.
  339.  
  340.  
  341. -d             If this parameter is specified, possible paths on the
  342.                incoming file names will be stripped off. This safety
  343.                precaution should be used with bulletin board systems (BBS).
  344.  
  345.  
  346. Suppress outputs to STDERR when leaving GSZRZ
  347.  
  348. -q             If this parameter is specified, the output of the final
  349.                message to STDERR will be suppressed. Use this in
  350.                conjunction with communication programs that do not redirect
  351.                STDERR.
  352.  
  353.  
  354. Resume an interrupted transfer
  355.  
  356. -r             With this parameter, the sender tells the receiver that it is
  357.                possible to handle a CRC protected resume.
  358.  
  359.  
  360. Set the file date
  361.  
  362. -s             Set the file date of the file received to the current date.
  363.                This can be useful in BBS programs.
  364.  
  365.  
  366. Output the CPS rate to STDERR
  367.  
  368. -S             If this parameter is specified, the CPS rate will be written
  369.                to STDERR at the end of the transfer.
  370.  
  371.  
  372. Set the time-out time
  373.  
  374. -t TIM         This parameter sets the time-out time to TIM/10 seconds. It
  375.                has been implemented as some BBS take rather long to set up
  376.                a ZMODEM transfer. Usually, there should be no problems with
  377.                the default value of 100 (i.e. 10 seconds). Minimum 10,
  378.                maximum 1000.
  379.  
  380.  
  381. Protocol for receiving
  382.  
  383.                The default protocol used is ZMODEM. If you want to use one
  384.                of the other protocols, specify one of these parameters:
  385.  
  386. -X             Use XMODEM protocol
  387.  
  388. -Y             Use YMODEM protocol
  389.  
  390.  
  391.  
  392. Checking the on-line time
  393.  
  394. -U time        on-line time remaining
  395. -C baud rate   actual baud rate
  396.  
  397.                For the usage in BBS programs, the checking of the on-line
  398.                time was implemented (key word: "NetCall Hour"). This needs
  399.                two parameters -C and -U. The value following -C gives the
  400.                remaining on-line time in seconds. The value following -U
  401.                gives the actual baud rate. If the remaining time doesn't
  402.                suffice for an upload, RZ will exit with an exit code 9 and
  403.                the message 'not  enough  time for  upload'. At that time,
  404.                no files have been created. If the available on-line time is
  405.                exceeded, the receive operation will be stopped with an
  406.                error code 10. The partially received file will be closed,
  407.                so that the transfer can be resumed later on.
  408.  
  409.                Example:  -rz -C 19200 -U 100
  410.  
  411.  
  412.  
  413.  
  414. EXAMPLES
  415. --------
  416.  
  417. Some examples of parameters for RZ:
  418.  
  419. -rz                  receive using ZMODEM
  420.  
  421. -rz -Y               receive using YMODEM
  422.  
  423. -rz -Y -g            receive using YMODEM-1k-g
  424.  
  425. -rz -X TEST.XYZ      receive using XMODEM.
  426.                      NOTE: a file name MUST be specified as it cannot be
  427.                      transferred by XMODEM!
  428.  
  429. -rz -y -o TEST.XYZ -P D:\MAIL\DOWNLOAD
  430.                      receive using ZMODEM, carrier detect disabled, target
  431.                      directory specified, file name specified, delete
  432.                      possibly existing file
  433.  
  434. -rz -m               receive via MIDI interface
  435.  
  436. -rz -m -b 8192 -l 8192
  437.                      receive via MIDI. The Rx buffer has to be set to 8 KB
  438.                      if you are using 8 KB blocks to avoid buffer overflow.
  439.  
  440.  
  441.  
  442.  
  443. PARAMETERS FOR SENDING
  444. ----------------------
  445.  
  446. REMEMBER:      Please remember to specify the file name(s) after all the
  447.                parameters have been given.
  448.  
  449.  
  450. Append to existing file
  451.  
  452. -+             The receiver should append the file transferred to an
  453.                existing file (ZMODEM only).
  454.  
  455.  
  456. ASCII Transfer
  457.  
  458. -a             ASCII Transfer. The receiver has to translate CR/LF (ZMODEM
  459.                only)
  460.  
  461.  
  462. Include protocol end into CPS rate
  463.  
  464. -A             At the end of a file transmission an acknowledge between
  465.                sender and receiver is done. Some people want to include this in
  466.                the final calculation of the CPS rate.
  467.                If -A is set, the last CPS-rate is calculated after the
  468.                acknowledge.
  469.  
  470.  
  471. Suppress break
  472.  
  473. -b             At a retry, NO break will be sent to the modem (ZMODEM
  474.                only). Usually, a break is sent to the modem at a block
  475.                retry operation to empty the modem's buffer.
  476.  
  477.  
  478. Conversion of '.'
  479.  
  480. -d             Dots '.' in path names are converted to slashes '/'
  481.                (Y/ZMODEM only). This is useful if the receiver isn't able
  482.                to handle dots in file names.
  483.  
  484.  
  485. Suppress carrier detect
  486.  
  487. -D             If this parameter is specified, the monitoring of the
  488.                carrier detect line will be suppressed.
  489.  
  490.  
  491. Escaping of control characters
  492.  
  493. -e             If this parameter is specified, the 'escaping' of all
  494.                control characters will be performed as it is usually done
  495.                on UNIX systems.
  496.  
  497.  
  498. Send path name to the receiver
  499.  
  500. -f             If this parameter is specified, the full path name is
  501.                transmitted together with the file name (ZMODEM only).
  502.                Note that '\' is converted to '/' as noted in the
  503.                Zmodem Specification. Some Zmodem programs on PC's
  504.                cannot accept this conversion!
  505.  
  506.  
  507. File buffer size
  508.  
  509. -F SIZE        This parameter specifies the size of the file buffer. When
  510.                sending a file, this buffer is filled by reading from
  511.                hard disk/floppy disk. SIZE indicates the size of the buffer
  512.                in bytes, the suffixes 'K' and 'M' indicate kilobyte and
  513.                megabyte, e.g. '-F 16K' and '-F 2M'.
  514.                '-F -1' results in a buffer that uses all available RAM
  515.                except 100 KB.
  516.  
  517.                SIZE: default 8192 bytes, minimum 1024 bytes
  518.  
  519.  
  520. Audible indication of the end of the transfer
  521.  
  522. -G             The end of the transfer will be indicated by an audible
  523.                signal ('bell').
  524.  
  525.  
  526. Serial device
  527.  
  528. -H n           With this parameter You can select a serial device. This is
  529.                usefull, if GSZRZ is used as accessory unter MultiTOS.
  530.  
  531.  
  532.                      ST           MSTE      TT      FALCON
  533.                 1   AUX           AUX      AUX       AUX
  534.                 3   MIDI          MIDI     MIDI      MIDI
  535.                 6   MODEM1        MODEM1   MODEM1    -
  536.                 7   -             MODEM2   MODEM2    MODEM2
  537.                 8   -             SERIAL2  SERIAL1   SERIAL2/LAN
  538.                 9   -             -        SERIAL2   -
  539.  
  540.  
  541. Iconify the GSZRZ window on startup
  542.  
  543. -I x,y          With this parameter it is possible (only with MultiTOS with
  544.                 AES version > 4.0) to iconify the window of GSZRZ already at
  545.                 startup and position the window at x,y.
  546.  
  547.  
  548.  
  549. Block size for XMODEM/YMODEM
  550.  
  551. -k             Send 1024 byte packages. The X/YMODEM default value is 128
  552.                bytes.
  553.  
  554.  
  555. Request receiver acknowledge
  556.  
  557. -l N           Request an acknowledge from the receiver after N bytes
  558.                (32 <= N <= 1024, 8192 if parameter -8 is used) have been
  559.                transferred (ZMODEM only). The ZMODEM default is to use
  560.                stream mode, i.e. the sender will send data blocks
  561.                continuously and will be requested to repeat blocks in
  562.                cases of errors only. This results in an increased data rate
  563.                in the stream mode. If no hardware handshake is possible
  564.                (e.g. MIDI interface), this parameter forces a software
  565.                handshake to be performed.
  566.  
  567.  
  568. Use MIDI interface
  569.  
  570. -m             If this parameter is specified, the transfer will be
  571.                performed via the MIDI interface. If GSZRZ is used as an
  572.                accessory in conjunction with RUFUS, this is the default and
  573.                this parameter need not be specified (see example below).
  574.  
  575.                As the MIDI interface does not have handshake lines, a
  576.                software handshake has to be requested by specifying the
  577.                parameter '-l 1024' or '-l 8192' if parameter -8 is used.
  578.  
  579.  
  580. Disable mouse interrupt
  581.  
  582. -M             This parameter disables the mouse interrupt during the
  583.                transfer. Use this parameter if moving the mouse disturbs
  584.                the file transfer. In addition, this parameter causes the
  585.                multitasking to be disabled to achieve maximum data rates on
  586.                the ST.
  587.  
  588.  
  589. Conditional transfer
  590.  
  591. -n             Send file only if it is newer or longer than the one that
  592.                already exists at the receiver (ZMODEM only).
  593.  
  594. -N             Send file only if it has a different file date or is longer
  595.                than the one that already exists at the receiver (ZMODEM
  596.                only).
  597.  
  598.  
  599. 16 Bit CRC
  600.  
  601. -o             Use 16 Bit CRC only for ZMODEM transfers. Saves 2 bytes per
  602.                block transferred. Some older ZMODEM programs use nothing
  603.                but 16 Bit CRC.
  604.  
  605.  
  606. Protect an existing file
  607.  
  608. -p             If the file to be transferred already exists at the
  609.                receiver, the transfer will NOT be performed (ZMODEM only).
  610.  
  611.  
  612. Suppress outputs to STDERR when leaving GSZRZ
  613.  
  614. -q             If this parameter is specified, the output of the final
  615.                message to STDERR will be suppressed. Use this in
  616.                conjunction with communication programs that do not redirect
  617.                STDERR.
  618.  
  619.  
  620. Resume an interrupted transfer
  621.  
  622. -r             If this parameter is specified, the receiver is told that
  623.                the sender is able to resume a partial transfer (ZMODEM
  624.                only).
  625.  
  626.  
  627. Use script file for sending
  628.  
  629. -s FILE.EXT    The names of the files to be transferred are being read from
  630.                the script file FILE.EXT (ZMODEM only). Useful for
  631.                transferring the same files repeatedly.
  632.  
  633.  
  634. Output the CPS rate to STDERR
  635.  
  636. -S             If this parameter is specified, the CPS rate will be written
  637.                to STDERR at the end of the transfer.
  638.  
  639.  
  640. Set the time-out time
  641.  
  642. -t TIM         Sets the time-out time to TIM/10 seconds. This is the time
  643.                that will be waited for an answer from the receiver until an
  644.                error is assumed. Usually, there should be no problems with
  645.                the default value of 600 (i.e. 60 seconds). Minimum 10,
  646.                maximum 1000.
  647.  
  648.  
  649. Delete file after transfer
  650.  
  651. -u             The file to be transferred will be deleted after the
  652.                transfer has ended.
  653.  
  654.  
  655. Replace existing file
  656.  
  657. -y             The receiver will replace a file of the same name that
  658.                possibly already exists with the file transferred (ZMODEM
  659.                only)
  660.  
  661.  
  662. Protocol for sending
  663.  
  664.                The default protocol used is ZMODEM. If you want to use one
  665.                of the other protocols, specify one of these parameters:
  666.  
  667. -X             Use XMODEM protocol
  668.  
  669. -Y             Use YMODEM protocol
  670.  
  671.  
  672.  
  673. Checking the on-line time
  674.  
  675. -U time        on-line time remaining
  676.  
  677.                For the usage in BBS programs, the checking of the on-line
  678.                time was implemented. The value following -C gives the
  679.                remaining on-line time in seconds. If the available on-line
  680.                time is exceeded, the send operation will be stopped with an
  681.                error code 10.
  682.  
  683.                Example:  -sz -U 100
  684.  
  685.  
  686. Transfer big blocks
  687.  
  688. -8             Use 8 KB blocks for transfer. CAUTION: Don't expect to find
  689.                many ZMODEM programs that can use this option at the other
  690.                end of the line!
  691.  
  692.  
  693.  
  694.  
  695. EXAMPLES
  696. --------
  697.  
  698. Some examples of parameters for sending:
  699.  
  700. -sz TEST.XYZ         send using ZMODEM
  701.  
  702. -sz *.C *.H          send all files with extensions .C and .H using ZMODEM
  703.  
  704. -sz -Y TEST.XYZ      send using YMODEM
  705.  
  706. -sz -Y -k TEST.XYZ   send using YMODEM-1k-g
  707.  
  708. -sz -X TEST.XYZ      send using XMODEM
  709.  
  710. -sz -8 TEST.XYZ      send using ZMODEM in 8 KB blocks
  711.  
  712. -sz -m -l 1024 TEST.XYZ
  713.                      send via MIDI interface
  714.  
  715. If the receiver uses GSZRZ, too, you can use 8 KB block transfers via MIDI
  716. interfaces, too, by specifying
  717.  
  718. -sz -m -8 -l 8192 TEST.XYZ
  719.  
  720. The receiver has to use these parameters:
  721.  
  722. -rz -m -b 8192
  723.  
  724.  
  725.  
  726. EXIT CODES
  727. ----------
  728.  
  729. When exiting from the program, GSZRZ returns one of the following exit
  730. codes to the caller:
  731.  
  732.   1  Argument error, command line parameters wrong, file not found
  733.   2  Initialization error (graf_handle,  appl_init)
  734.   3  User break by entering Ctrl-C or clicking on 'closers'
  735.   4  Memory allocation error, not enough memory
  736.   5  Carrier lost
  737.   8  Invalid structure pointer (see ACC protocol)
  738.   9  Not enough time for upload
  739.  10  Time limit exceeded
  740.  11  No/wrong port handle
  741.  12  Disk full
  742.  16  Cancel received   Aborted by other side
  743. 128+ Transfer error (for example, if 4 files are to be transferred and the
  744.      receiver skips 2 files, 128 + 2 = 130 is returned. If no sync is
  745.      established, 128 is returned)
  746.  
  747.  
  748.  
  749.  
  750. ACC PROTOKOLL OF GSZRZ
  751. -----------------------
  752.  
  753. GSZRZ used as an ACC is addressed using a special protocol via the
  754. application message function of GEM.
  755.  
  756. msgbuf[0]   contains an ID of the ACC protocol. It consists of the letters
  757.             'GZ'. i.e. the hex value 0x475A.
  758.  
  759. msgbuf[1]   contains the application ID, i.e. the value that is returned by
  760.             appl_init().
  761.  
  762. msgbuf[2]   always has to be 0.
  763.  
  764. msgbuf[3]   contains the length of the command line string.
  765.  
  766. msgbuf[4]   the lower 16 bits of the pointer to the command line string.
  767.  
  768. msgbuf[5]   the upper 16 bits of the pointer to the command line string.
  769.  
  770.             The command line string has to be terminated by 0x00. It
  771.             contains the usual switches as in calls to the PRG, e.g.
  772.             "-rz -D -P C:\\DOWNLOAD"
  773.  
  774. RETURN CODES
  775. ------------
  776.  
  777. At exit, GSZRZ returns the following values to the calling program:
  778.  
  779. msgbuf[0] = GZ_PRIVATE;
  780. msgbuf[1] = appl_id;
  781. msgbuf[2] = Exitcode;
  782. msgbuf[3] = (int) strlen(message);
  783. msgbuf[4] = (unsigned int) ((long) message & 0XFFFF);
  784. msgbuf[5] = (unsigned int) ((long) message >> 16);
  785. msgbuf[6] = 0;
  786. msgbuf[7] = 0;
  787. appl_write(msgbuf[1], 16, txmsgbuf);
  788.  
  789. 'message' is a pointer to a string, that is written to STDOUT when exiting
  790. the program. RUFUS/CoNnect causes this string to be displayed as a GSZRZ
  791. message in the communication window.
  792.  
  793. 'Exitcode' contains GSZRZ's return code.
  794.  
  795.  
  796.  
  797.  
  798. RTS/CTS HANDSHAKE
  799. -----------------
  800.  
  801. As the GSZRZ programs use the ST/TT's operating system routines, the
  802. RTS/CTS handshake has to be performed by the communication program (e.g.
  803. RUFUS) or using the control area.
  804.  
  805. Because the TOS routines are faulty even in TOS 1.04 and TOS 3.05, a patch
  806. has to be installed.
  807.  
  808. With the ATARI ST, I can recommend HSMODEM1 by Harun Scheutzow.
  809.  
  810. With the TT, SERPTCH2 by ATARI is recommended, because it will repair all
  811. interfaces.
  812.  
  813. With TOS 3.06, SERPTCH2 should no longer needed.
  814.  
  815.  
  816.  
  817.  
  818. SHAREWARE VERSIONS
  819. ------------------
  820.  
  821. The Shareware-Version of GSZRZ is restricted in some functions. The user
  822. can evaluate the programs for 3 weeks, copy them freely, and share them
  823. with other users. All registered versions are for single users and MUST NOT
  824. be copied and handed on to other users.
  825.  
  826. If you use these programs more than 3 weeks, you MUST pay a ONE-TIME fee
  827. of DM 30.00 to the author (XENIA Software, Michael Ziegler).
  828. This fee is to be paid ONCE ONLY and even entitles you to use future
  829. versions of GSZRZ.
  830.  
  831. If you pay via remittance order from abroad, please don't forget that the
  832. banks may subtract fees of up to DM 12.50. In Europe, the best way is to
  833. pay with an Euro-Cheque.
  834.  
  835.  
  836.  
  837.  
  838.  
  839. THANKS TO
  840. ---------
  841.  
  842. I would like to thank the many beta tester, especially:
  843.  
  844.   Jürgen Meyer and Carsten Meyer (Maus @HH2) for the devoted testing,
  845.  
  846.   Michael Bernards for the support by RUFUS,
  847.  
  848.   Wolfgang Wander for the support by CoNnect,
  849.  
  850.   Achim Wilhelm for supporting me in searching for bugs in the FALCON-TOS,
  851.  
  852.   Harun Scheutzow for the best RTS/CTS patch for serial devices on ATARI
  853.   computers I ever seen.
  854.  
  855.   all users of GSZRZ whose suggestions and advice on new features further
  856.   the development of the GSZRZ ZMODEM program package.
  857.  
  858.  
  859.  
  860.  
  861. UPDATE SERVICE
  862. --------------
  863.  
  864. For registered users of GSZRZ only, an update service has been installed in
  865. several bulletin board systems (BBS).
  866.  
  867. Please allow for about 2 - 3 weeks after registration until you can use
  868. this service. The files containing the registration data in the BBS are
  869. updated irregularly.
  870.  
  871. This service is free of charge. It has been established on request by BBS
  872. operators. Therefore, I cannot guarantee that this service and the latest
  873. version of the GSZRZ program package will be available at all times.
  874.  
  875. For updating, you need the serial number of your GSZRZ program package. You
  876. can find it in the file SERIAL.NUM on your registered diskette.
  877.  
  878. After logging on to the BBS, call the updater from the menu. The updater
  879. will answer with the following message in German:
  880.  
  881. >> Registering GSZRZ-Files V 2.6 (c) 1991, 1992 mz <<
  882.  
  883. A C H T U N G:  Nur für REGISTRIERTE Benutzer erlaubt!
  884. aktuelle Version x.yy downloaden ? (J/N)
  885.  
  886. Vorname:
  887. Nachname:
  888. Seriennummer:
  889.  
  890. In English, this would read:
  891.  
  892. >> Registering GSZRZ Files V 2.6 (c) 1991, 1992 mz <<
  893.  
  894. C A U T I O N:  for REGISTERED users only
  895. download current version x.yy ? (Y/N)
  896.  
  897. first name:
  898. last name:
  899. serial number:
  900.  
  901. After you have entered the data requested, the updater will produce a
  902. version registered to you, compress it and send it to you using
  903. YMODEM or ZMODEM, whatever you choose.
  904.  
  905. Please take care to enter the first and last names exactly as they are
  906. displayed in the dialog window or your request to update will be rejected.
  907.  
  908. This update service is currently offered by the following German bulletin
  909. board systems (BBS):
  910.  
  911. ------------------------------------------------------------------------
  912. BBS            :         Turbo Tron   Hamburg
  913. Baud rate      :         2400 - 14400 V32 V32bis
  914. Telephone      :         ++49 / 40 / 890 11 62
  915.  
  916. Updater        :         Enter: GSZRZ,UPDATER or GSZ
  917. Download times :         00:00 - 08:00 CET
  918. ------------------------------------------------------------------------
  919. BBS            :         Tuma Box   Augsburg
  920. Baud rate      :         1200 - 19200 V32 V32bis ZyXel-Mode
  921. Telephone      :         ++49 / 821 / 66 77 66
  922.  
  923. Updater        :         Enter: GSZRZ,UPDATER or GSZ
  924. Remarks        :         You can download one file per login,
  925.                          if you want more, you'll have to register
  926. ------------------------------------------------------------------------
  927. ADDRESS                              BANK ACCOUNT
  928. -------                              ------------
  929.  
  930. XENIA Software                       XENIA Software
  931. Michael Ziegler                      Michael Ziegler
  932. Jagdfeldring 16                      Kreissparkasse München, Germany
  933. D-85540 Haar, Germany                Bank Number: 702 501 50
  934. Telephone ++49/89/4602746            Account Number: 420354680
  935.  
  936. ----------------------------------------------------------------------
  937.  
  938.