Information Center

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 and the existing file has the EOF character x'1A' as its last character, then Host On-Demand removes x'1A' from the end of the existing file before appending the downloaded data:

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