Information Center

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:

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:



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.  Z and I Emulator for Web 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.