Using the MVS/TSO RECEIVE Command

Use the following information when receiving a file from MVS/TSO:

Figure 1 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase letters.
Note:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 1. MVS/TSO RECEIVE Command Syntax
REQTEXT
 A 
The workstation drive and path to the directory where the file is to be stored.
 B 
The name of the workstation file to receive.
 C 
The short name of the host session, and the data set name of the file you are receiving.
 D 
The member name if the file is put in a partitioned data set.
 E 
The password of the data set, if any.
 F 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:
  • APPEND
  • ASCII
  • BLANK
  • CRLF
  • PROGRESS
  • QUIET
  • TIME(n)
The parts of the MVS/TSO RECEIVE commands are:
RECEIVE
The command.
d:
The name of the diskette or hard disk drive where the file is to be located. Use A:, B:, C:, D: through Z:. This part is optional if the file is received on the current drive.
path
The subdirectory where you want the data set located. This part is optional.
filename.ext
The name the file is to have on your diskette or hard disk. Creates a new name or uses a name that is already on your diskette or hard disk.

If you use a new name, the data set that you receive is added to your diskette or hard disk. If you use the name of an existing file, the data set that you receive either replaces or supplements the existing file. (Refer to the APPEND option on page APPEND.)

h:
The short name of the MVS/TSO session where the data set is located. If you have only one host, this part is optional. Use this option if you have more than one host. The default short name is A.
data-set-name
The name of the data set or the partitioned data set that contains the member you want to send to your workstation session. You must use the qualified name. Enclose the data set name with the member name in single quotation marks if you are using a fully qualified data set name.
(member-name)
The member name of a partitioned data set to send to your workstation session. This part is optional. Use it only if the data set is a member of a partitioned data set.
/password
The password of the data set. Use it only if the data set has a password.
(options
       These options can be specified:
APPEND
Adds the data set to the end of an existing file. Omit this part if you want the MVS/TSO data set to replace an existing workstation file.
ASCII
Performs the following:
  • Converts EBCDIC codes to 1-byte workstation codes.
BLANK
This option is valid with the option CRLF; it retains BLANK (hex 40) at the end of each line.
CRLF
Specifies the use of carriage return and line feed codes. You need ASCII and CRLF for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.
PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
TIME(n)
Specifies the length of time, in units of 30 seconds, the program waits for a response from the host before it sends an error message. Replace n with an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).