Send text options (MVS/TSO and VM/CMS)

The following options are used (by default) when sending files in text mode. For VM/CMS, remember to type an open parenthesis '(' before the first option.

Options include:

ASCII

Use this option for text files and for files that you want to be converted from ASCII to EBCDIC. This is valid for SBCS languages, Traditional Chinese, and Korean. Local 1-byte codes are converted into EBCDIC codes. For DBCS, inserts shift in/shift out (SI/SO) characters into DBCS fields.

JISCII

This option is valid for Japanese DBCS sessions only and converts 1-byte codes to EBCDIC and 2-byte codes to IBM Kanji. JISCII inserts shift in/shift out (SI/SO) characters into DBCS fields.

CRLF

Carriage Return and Line Feed. CRLF (x'0D0A') is removed from the end of each line. EOF (x'1A') is removed from the end of a file.

NOSO

This option is valid only for DBCS and only when used with the JISCII or ASCII option. NOSO prevents the conversion of SO (x'0E') and SI (x'0F') before and after the DBCS field. It also prevents the conversion of RS (x'1E') and US (x'1F') to SO (x'0E') and SI (x'0F').

APPEND

The transferred file will be appended to an existing host file that has the same name (and type and mode for VM/CMS), if one exists. If APPEND is not specified, the transferred file overwrites the existing host file.

NEW

The transfer stops if the file already exists. This option can be used to protect against accidentally erasing an existing file.

LRECL

Logical Record Length. This is not valid if APPEND is specified. Otherwise, you can choose one of the following options:

• Fixed - Specifies the number of bytes in each host record.
• Variable - The logical record length is the length of the longest record in the file; the maximum value is 32767.

The record length of a file sent from the local workstation to the host system might exceed the logical record length specified here. If so, the file transfer program divides the file by the logical record length.

To send a file containing long records to the host system, specify a length that is long enough to allow complete records to be sent.

RECFM

 

Record Format. This option is not valid when APPEND is specified. Otherwise, you can choose one of the following options:

• Default - The record format is automatically selected by the host system.
• Fixed - Specifies the number of bytes in each host record.
• Variable - When sending a file to VM/CMS, you can conserve host disk space by specifying a record format of variable.
• Undefined - This option is available for MVS/TSO only.

BLKSIZE(n)

 

This option applies only to TSO and only when you are creating a new data set. The (n) value represents the block size in bytes.

SPACE

This option applies to TSO only. This value is the amount of space to be allocated for a new TSO data set.

Quantity

Units of space to be allocated initially. You must specify this value when the SPACE parameter is used.

Increment

Units of space to be added each time new space is required.

The following parameters are only valid when the SPACE parameter is specified, and are mutually exclusive of each other.

AVBLOCK(n)

Average block length used as the unit size by the SPACE parameter. The (n) value is the block length in bytes.

TRACKS

Specifies the unit of space is a track.

CYLINDERS

Specifies the unit of space is a cylinder.

UNICODE (encoding)

This option is only for DBCS code pages. It allows you to send text files saved in UNICODE to the host and convert them to EBCDIC. Valid encoding options are UCS2 or UTF8. The default encoding option UCS2 is used if neither option is specified. The UTF-8 encoding option is the same as UTF8.

PROGRESS/NOPROGRESS

When sending or receiving files with Host File Transfer, a file progress indicator displays by default to track the progress of each file transfer.  Host On-Demand now allows you to control whether or not to display the progress indicator with the PROGRESS/NOPROGRESS options described below.

PROGRESS

Indicates that the file progress indicator will be visible for Files being sent or received from the host.

Note: If no option is entered the Progress indicator is visible for the file transfer.

NOPROGRESS

Indicates that the progress indicator will not be visible for the file transfer.

Notes:

• This option can be controlled on a per file definition.  
• If you want the NOPROGRESS option to be the default, enter this option under File Transfer Defaults.
• If an error occurs during the transmission, the File Transfer Status will be displayed.