rz.doc

支持ZModem协议的串口通讯程序

     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



     NNNNAAAAMMMMEEEE
	  rx, rc, rb, rz - Receive Files and Commands with X/Y/ZMODEM

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  rrrrzzzz [-	ttttvvvv]
	  rrrrbbbb [-	ttttvvvv]
	  rrrrcccc [-	ttttvvvv] _f_i_l_e
	  rrrrxxxx [-	ttttvvvv] _f_i_l_e
	  ggggzzzz _f_i_l_e ...
	  [----][vvvv]rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD

     LLLLIIIICCCCEEEENNNNSSSSEEEE AAAAGGGGRRRREEEEEEEEMMMMEEEENNNNTTTT
	  This is a Copyrighted	shareware program.  Commercial use of
	  this program is subject to licensing conditions detailed in
	  the rz.c source code.	 "Commercial Use" includes any use of
	  this program to receive files	from a commercial or shareware
	  program not published	by Omen	Technology INC.

	  Registration information is provided in the file mailer.rz.

	  Use of this program constitutes agreement to the License
	  Agreement.

     SSSSUUUUPPPPPPPPOOOORRRRTTTT
	  Unregistered users may dial 900-737-7836 (900-737-RTFM) for
	  technical assistance.	 There is a charge of $3.69 per	minute
	  to use this support line.  Callers must be 18	years or
	  older.

	  Registered users encountering	problems using this program on
	  standard serial ports	to transfer files with Professional-
	  YAM or ZCOMM may call	the support number listed in the
	  Professional-YAM/ZCOMM documentation.	 Solutions to nearly
	  all file transfer problems are described in the
	  Professional-YAM/ZCOMM documentation.

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  This program uses error correcting protocols to receive
	  files	over a dial-in serial port from	a variety of programs
	  running under	PC-DOS,	CP/M, Unix, and	other operating
	  systems.  It is invoked from a shell prompt manually,	or
	  automatically	as a result of an "sz file ..."	command	given
	  to the calling program.

	  To obtain the	maximum	performance and	full functionality of
	  this program we recommend its	use with GSZ, Professional-YAM
	  or ZCOMM.

	  This program is intended to interface	with terminal
	  programs, not	to act as one.	This program is	not designed
	  to be	called from _c_u(_1), _t_i_p(_1), or other communications
	  programs.  Unix flavors of Omen Technology's Professional-



     Page 1					     (printed 2/18/94)






     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



	  YAM communications software are suitable for dial-out
	  applications.	 Unix Professional-YAM supports	dial-out
	  applications with telephone directory, a powerful script
	  language with	learn function,	high quality multiple protocol
	  support, and UUCP port arbitration.


	  RRRRzzzz (Receive ZMODEM) receives one or more files with the
	  ZMODEM protocol.  Pathnames are supplied by the sending
	  program, and directories are made if necessary (and
	  possible).  Normally,	the "rz" command is automatically
	  issued by the	calling	ZMODEM program,	but defective ZMODEM
	  implementations may require starting _r_z manually.

	  RRRRbbbb receives file(s) with YMODEM, accepting either standard
	  128 byte sectors or 1024 byte	sectors	(Pro-YAM/ZCOMM sb ----kkkk
	  option).  The	user should determine when the 1024 byte block
	  length actually improves throughput.

	  If True YMODEM (Omen Technology trademark) file information
	  (file	length,	etc.) is received, the file length controls
	  the number of	bytes written to the output dataset, and the
	  modify time and file mode (iff non zero) are set
	  accordingly.

	  If True YMODEM file information is not received, slashes in
	  the pathname are changed to underscore, and any trailing
	  period in the	pathname is eliminated.	 This conversion is
	  useful for files received from CP/M and other	historical
	  systems.

	  RRRRcccc receives a	single _f_i_l_e with XMODEM-CRC or XMODEM-1k-CRC
	  protocol.  The user should determine when the	1024 byte
	  block	length actually	improves throughput without causing
	  problems.  The user must supply the file name	to both
	  sending and receiving	programs.  Up to 1023 garbage
	  characters may be added to the received file.

	  RRRRxxxx receives a	single _f_i_l_e with XMODEM	or XMODEM-1k protocol.
	  The user should determine when the 1024 byte block length
	  actually improves throughput without causing problems.  The
	  user must supply the file name to both sending and receiving
	  programs.  Up	to 1023	garbage	characters may be added	to the
	  received file.

	  GGGGzzzz is	a shell	script which calls _s_z to command Pro-YAM or
	  ZCOMM	to transmit the	specified files.  Pathnames used with
	  _g_z must be escaped if	they have special significance to the
	  Unix shell.
	  EXAMPLE: gz "-a C:*.c	D:*.h"

	  If invoked with a leading ``v'', _r_z will report progress to



     Page 2					     (printed 2/18/94)






     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



	  /tmp/rzlog.
	  EXAMPLE: ln rz vrz; rz=vrz; export rz

	  If the SHELL environment variable includes _r_s_h or _r_k_s_h
	  (restricted shell), _r_z will not accept absolute pathnames or
	  references to	a parent directory, will not modify an
	  existing file, and removes any files received	in error.


	  The meanings of the available	options	are:

	  ttttttttiiiimmmm Change timeout to _t_i_m tenths of seconds.
	  vvvv    Verbose causes a	list of	file names to be appended to
	       /tmp/rzlog .  More v's generate more detailed debugging
	       output.
	  (Pro-YAM command)
	  <_A_L_T-_2>
	  Pro-YAM Command: _s_z *._h *._c
	  This automatically invokes _r_z	on the connected system, and
	  sends	all .h and .c files in the current directory.

	  _s_z -_n	-_R_f .
	  This Professional-YAM	command	recursively follows the
	  current directory tree (.) (Pro-YAM -R option), sends	the
	  full relative	pathname (-f), for files that are newer	(-n)
	  than their copies on the destination system.


     DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
	  Exit status is as follows: 0 for successful transfers.  1 if
	  unrecoverable	errors are detected.  2	if syntax errors or
	  file access problems are detected.  3	if the program was
	  terminated by	a caught interrupt.


     SSSSEEEEEEEE AAAALLLLSSSSOOOO
	  Professional-YAM, ZCOMM, DSZ,	crc(omen), sz(omen),
	  usq(omen), undos(omen)

	  Compile time options required	for various operating systems
	  are described	in the source file.

     SSSSEEEERRRRVVVVEEEERRRR////NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
	  Terminals on some timesharing	systems	are connected
	  indirectly to	the host with TTTTEEEERRRRMMMMIIIINNNNAAAALLLL SSSSEEEERRRRVVVVEEEERRRRSSSS operating over
	  networks.  Terminal servers often interfere with file
	  transfers by "eating"	control	characters and/or losing data.

	  When terminal	servers	interfere with file transfers, server
	  commands are often available to help the problem.  When
	  possible, enable the server and modems for hardware flow
	  control in and out.  Set the terminal	server to telnet



     Page 3					     (printed 2/18/94)