Using the MVS/TSO SEND Command

Use the following information when entering the SEND command to the MVS/TSO host:

Figure 1 shows the command and information you must provide. Enter text 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.

Figure 1. MVS/TSO SEND Command Syntax

A

The workstation drive and path of the file to send.

B

The name of the workstation file to send.

C

The short name of the host session and the data set name of the file to send.

D

The member name if the file is in a partitioned data set.

E

The password of the data set if it has one.

F

Optional changes made to the file during transfer. More than one option can be specified. Valid options are:

APPEND
ASCII
BLKSIZE(n)
CLEAR
CRLF
LRECL(n)
NOCLEAR
You must use the NOCLEAR option when you are transferring files while in ISPF command mode on the host.
PROGRESS
QUIET
RECFM(x)
SPACE(n[,n1]) unit
TIME(n)

The parts of the MVS/TSO SEND command are:

SEND: The command.
d:: The name of the diskette or hard disk drive where the file is located.
path: The path indicating the directory where the file is located.
filename.ext: The name of the file to be sent. Include the extension if the file has one.
h:: The name of the MVS/TSO host session to which you want to send the file. You can omit this name if you have only one host. If you have more than one host, this is the short name of the MVS/TSO host session. The default short name is A.
data-set-name: The data set name that the file you send is to have on your MVS/TSO volume; this name is required. Enclose the data set name with the member name in single quotation marks if you are using a fully qualified data set name.
This option creates a new name or uses a data set name already on your TSO volume. If you use a new name, the file that you send is added to your MVS/TSO volume. If you use the name of an existing data set, the file you send either replaces or supplements the existing data set. Refer to the APPEND option.
(member-name): The member name if the file is to be put into a partitioned data set. If you use member-name, you cannot use LRECL(n), BLKSIZE(n), RECFM(x), and SPACE(n,[n1]) unit.
Note: If someone else is using the partitioned data set, you cannot send a file to your MVS/TSO host.
/password: The password of the data set, if the data set has a password.

options

These options can be specified:

APPEND

Specifies that the file being sent is added to the end of an existing MVS/TSO data set. Omit this option if you want the file to replace an existing MVS/TSO data set. You cannot use LRECL(n), RECFM(x), SPACE(n[,n1]) unit, or BLKSIZE(n) options if you use the APPEND option.

Note: This option is not valid when sending data to a member of a partitioned data set.

ASCII

Performs the following:

Converts 1-byte workstation codes to EBCDIC codes.

BLKSIZE(n)

Specifies the size of the blocks of data in a new data set on your MVS/TSO volume. This part is optional. To set the block size for a new data set, replace n with the new size. If you omit this option, the block size is determined in the following manner:

If the record format is variable, the block size is 6233.
If the record format is fixed, the block size is the largest multiple of the record length that is less than 6233:
```
BLKSIZE = LRECL * (6233/LRECL)
```

If you use the (member-name) or APPEND option, do not use this option.

CLEAR

Clears the workstation window at the beginning of the file transfer.

CRLF

Specifies the global use of carriage return and line feed codes. You need to specify ASCII and CRLF options for sending text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.

LRECL(n)

Specifies the record length for a new data set on your MVS/TSO volume, where n is a whole number from 1 through 32760 representing the number of characters per record. If you want to set the record length for a new data set, replace n with the new length. If you omit this option, the record length is set to 80 for fixed-length records and to 255 for variable-length records. If you use the (member-name) or APPEND options, do not use this option.

NOCLEAR

Suppresses the sending of a Clear command at the beginning of the file transfer. This option is required for ISPF command mode.

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.

RECFM(x)

Specifies the record format for a new data set on your MVS/TSO volume, where x = V, F, or U. For variable-, fixed- or undefined-length records in the data set, replace the x with V, F, or U, respectively.

If you omit this option, the record format of the host data set is determined by the setting of the CRLF parameter: if you specify CRLF, the data set has variable-length records; if you do not specify CRLF, it has fixed-length records. If you use the (member-name) or APPEND options, do not use this option.

SPACE(n[,n1]) unit

Specifies an amount of space to be set aside for a new data set on your MVS/TSO volume. To set aside a certain number of blocks, tracks, or cylinders for the new data set:

Provide unit as the type of space you want (AVBLOCK, TRACKS, or CYLINDERS).
Give n as the amount of space that you want the data set to occupy (in the unit of measure you select).
If the data set needs more space than you ask for with n, give n,n1 where n1 is the size of additional space to be used only when necessary.

These values are similar to the values on the ALLOCATE command of MVS/TSO.

If you omit this option, you get space for one block. The length of the block is set by the BLKSIZE(n) or LRECL(n) options. If you use the (member-name) or APPEND options, do not use this option.

TIME(n)

Specifies the length of time, in units of 30 seconds, that the program waits for a response from the host before it sends an error message. The value n is 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).