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, Host On-Demand appends the downloaded
file to the existing file.
-
If you do not specify APPEND, Host On-Demand 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 Host On-Demand removes x'1A' from the end of the existing file
before appending the downloaded data:
-
However, by default, Host On-Demand
does not add the removed x'1A' back to the end of the file
after appending the downloaded data.
-
To have Host On-Demand
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.
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.