Information Center

Treatment of EOF character (x'1A') during file download in Text mode

During a file download, when the Transfer Mode is Text, three options control how Z and I Emulator for Web treats the ASCII EOF character (x'1A'):

The EOF character (x'1A') can occur as the last character of two files:

The following list describes the effect of each option briefly. However, you should consult the two tables further below to determine the exact outcome of specifying each option.

The following two tables describe how these options operate for each combination of settings. In the tables:

The first table describes situations in which APPEND is not specified:

Remove- EOFChar Preserve- Append- EOFChar Action Taken:
no (Not applicable here because APPEND is not specified.) Applies to: 3270 Display session, 5250 Display session.
Here RemoveEOFChar is not specified (or is set to no). This is the default situation. If the last character of the file being downloaded is x'1A', then Z and I Emulator for Web does not remove it.
dddd  ==> dddd
dddd@ ==> dddd@
yes (Not applicable here because APPEND is not specified.) Applies to: 3270 Display session only.
Here RemoveEOFChar is specified and set to yes. x'1A' at the end of the downloaded file is deleted.
dddd  ==> dddd    (3270 Display session only)
dddd@ ==> dddd    (3270 Display session only)

The second table describes situations in which APPEND is specified:

Remove- EOFChar Preserve- Append- EOFChar Action Taken:
no no Applies to: 3270 Display session, 5250 Display session.
Both parameters are not specified (or are set to no). This is the default situation.
-- x'1A' at the end of the downloaded file is not deleted.
-- x'1A' at the end of the appended to file is deleted but not added back after appended data.
ffff  + dddd  ==> ffffdddd
ffff  + dddd@ ==> ffffdddd@
ffff@ + dddd  ==> ffffdddd
ffff@ + dddd@ ==> ffffdddd@
no yes Applies to: 3270 Display session, 5250 Display session. Here RemoveEOFChar is not specified (or is set to no) and PreserveAppendEOFChar is specified and set to yes.
-- x'1A' at the end of the downloaded file is not deleted.
-- x'1A' at the end of the appended to file is deleted and then added back after the appended data.
-- A maximum of one @ is retained at the end.
ffff  + dddd  ==> ffffdddd
ffff  + dddd@ ==> ffffdddd@
ffff@ + dddd  ==> ffffdddd@
ffff@ + dddd@ ==> ffffdddd@
yes yes or no Applies to: 3270 Display session and 5250 Display session. Here RemoveEOFChar is specified and set to yes, while PreserveAppendEOFChar can be either specified and set to yes or not specified at all (or set to no).
5250 Display session: No effect. That is, for a 5250 Display session, the effect is the same as if RemoveEOFChar were not specified (or were set to no). See the other two rows of this table for the results.
3270 Display session: Z and I Emulator for Web disregards the value of PreserveAppendEOFChar and takes the following actions:
-- x'1A' at the end of the downloaded file is deleted.
-- x'1A' at the end of the appended to file is deleted.
ffff  + dddd  ==> ffffdddd   (3270 Display only)
ffff  + dddd@ ==> ffffdddd   (3270 Display only)
ffff@ + dddd  ==> ffffdddd   (3270 Display only)
ffff@ + dddd@ ==> ffffdddd   (3270 Display only)

Related topics

  • HTML parameters (PreserveAppendEOFChar)
  • HTML parameters (RemoveEOFChar)
  • Receive text options (MVS/TSO and VM/CMS)
  • Receive text options (i5/OS and OS/400)