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

The following options are used (by default) when receiving 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 EBCDIC to ASCII. This is valid for SBCS languages, Traditional Chinese, and Korean. EBCDIC codes are converted to local 1-byte codes. For DBCS, removes shift out/shift in SO/SI characters from DBCS fields.

JISCII

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

CRLF

Carriage Return and Line Feed. The host inserts a carriage return character followed by a line feed character (x'0D0A') after each line of the downloaded file.

SO

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

USER

This option is valid only for DBCS and only when used with the ASCII (JISCII) and SO options. If USER is specified, SO (x'0E') and SI (x'OF') will not be converted to RS(x'1E') and US(x'1F').

APPEND

If a file of the same name as the downloaded file already exists in the target directory on the client workstation:

If you specify APPEND, Z and I Emulator for Web appends the downloaded file to the existing file.
If you do not specify APPEND, Z and I Emulator for Web overwrites the existing file with the downloaded file.

If you specify APPEND and the existing file has the EOF character x'1A' as its last character, then Z and I Emulator for Web removes x'1A' from the end of the existing file before appending the downloaded data:

However, by default, Z and I Emulator for Web does not add the removed x'1A' back to the end of the file after appending the downloaded data.
To have Z and I Emulator for Web add the removed x'1A' back to the end of the file after appending the downloaded data, use the PreserveAppendEOFChar HTML parameter. See HTML parameters (PreserveAppendEOFChar)

NEW

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

UNICODE (encoding)

This option is only for DBCS code pages. It allows you to receive text files saved in EBCDIC from the host and convert them to UNICODE. 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: