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.
- 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.