During a file download, when the Transfer Mode is Text, three options control how Host On-Demand 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:
ffff
signifies the existing file being appended to.
dddd
signifies the file being downloaded.
+
signifies an append.
==>
signifies "results in".
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 Host On-Demand 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: Host On-Demand 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)
|