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:

␢ means to insert a space. There must not be a space between h: and fn.
For DBCS sessions, insert a left bracket ([) before (options.

Figure 1. MVS/TSO RECEIVE Command Syntax

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
JISCII (for Japanese DBCS sessions)
PROGRESS
QUIET
SO
TIME(n)
USER

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 or [(options (for DBCS)

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.
Converts IBM host DBCS codes to 2-byte codes.
Removes SO and SI characters from a DBCS field.

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.

JISCII

This option is valid for Japanese DBCS sessions only and performs the following:

Converts EBCDIC codes to 1-byte workstation codes.
Converts IBM kanji codes to 2-byte codes.
Removes SO and SI characters from a DBCS field.

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.

SO

This option is valid only for DBCS when used with the JISCII or ASCII option; it converts SO (hex 0E) and SI (hex 0F) to RS (hex 1E) and US (hex 1F).

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 SDLC and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).

USER

This option is valid only for DBCS when used with the JISCII, ASCII and SO options. SO (hex 0E) and SI (hex 0F) are not converted to RS (hex 1E) and US (hex 1F); they are written to a file without being converted.