Tratamento do Caractere EOF (x'1A') Durante Download de Arquivo no Modo de Texto

Durante o download do arquivo, quando o Modo de Transferência é Texto, três opções controlam como o Host On-Demand trata o caractere ASCII EOF (x'1A'):

APPEND nas Opções de Texto de Recebimento
A opção HTML RemoveEOFChar
A opção HTML PreserveAppendEOFChar

O caractere EOF (x'1A') pode ocorrer como o último caractere de dois arquivos:

Como o último caractere do arquivo sendo transferido por download.
Como o último caractere do arquivo existente no qual o arquivo transferido por download está sendo anexado, se APPEND for especificado nas Opções de Texto de Recebimento.

A lista a seguir descreve brevemente o resultado de cada opção. No entanto, é necessário consultar as duas tabelas adicionais a seguir, para determinar o resultado exato da especificação de cada opção.

APPEND nas Opções de Texto de Recebimento.
(Sessão de Exibição 3270, Sessão de Exibição 5250.) Se você especificar APPEND nas Opções de Texto de Recebimento e se o último caractere do arquivo existente sendo anexado for x'1A', o Host On-Demand:
- Remove o x'1A' do final do arquivo existente antes de anexar os dados transferidos por download:
- Não inclui o x'1A' removido novamente no fim do arquivo, depois de anexar os dados transferidos por download.
Parâmetro HTML PreserveAppendEOFChar.
(Sessão de Exibição 3270, Sessão de Exibição 5250.) Esse parâmetro HTML modifica o resultado da opção APPEND nas Opções de Texto de Recebimento. Se você especificar APPEND nas Opções de Texto de Recebimento, se o último caractere do arquivo existente estiver sendo anexado for x'1A' e se você também especificar PreserveAppendEOFChar com um valor sim, o Host On-Demand:
- Remove o x'1A' do final do arquivo existente antes de anexar os dados transferidos por download.
- Também incluirá o x'1A' removido novamente no fim do arquivo depois de anexar os dados transferidos por download.
Parâmetro HTML RemoveEOFChar.
(Apenas Sessão de Exibição 3270.) Esse parâmetro HTML afeta como o Host On-Demand manipula um x'1A' quando ele ocorre como o caractere final do arquivo que está sendo transferido por download.
- Se a sessão for uma sessão de Exibição 3270, se o último caractere do arquivo sendo transferido por download for x'1A', se APPEND não for especificado nas Opções de Texto de Recebimento e se você especificar RemoveEOFChar com um valor sim, o Host On-Demand:
  - Removerá o x'1A' do final do arquivo sendo transferido por download.
- Se a sessão for uma sessão de Exibição 3270, se o último caractere do arquivo sendo transferido por download for x'1A', se APPEND não for especificado nas Opções de Texto de Recebimento, se o último caractere do arquivo existente sendo anexado for x'1A' e se você especificar RemoveEOFChar com um valor sim, o Host On-Demand:
  - Removerá o x'1A' do final do arquivo sendo transferido por download.
  - Removerá também o x'1A' do final do arquivo existente.
  RemoveEOFChar especificado com um valor sim substitui PreserveAppendEOFChar especificado com um valor sim.

As duas tabelas a seguir descrevem como essas opções operam para cada combinação de configurações. Nas tabelas:

ffff significa o arquivo existente sendo anexado.
dddd significa o arquivo sendo transferido por download.
+ significa um anexo.
==> significa "resulta em".

A primeira tabela descreve situações nas quais APPEND não está especificado:

Remover- EOFChar	Preservar- Anexar- EOFChar	Ação Tomada:
Não	(Não aplicável aqui porque APPEND não está especificado.)	Aplicado a: Sessão de Exibição 3270, sessão de Exibição 5250. Aqui, RemoveEOFChar não está especificado (ou está definido como não). Essa é a situação padrão. Se o último caractere do arquivo que está sendo transferido por download for x'1A', o Host On-Demand não o removerá. `dddd ==> dddd` `dddd@ ==> dddd@`
sim	(Não aplicável aqui porque APPEND não está especificado.)	Aplicado a: Apenas sessão de Exibição 3270. Aqui, RemoveEOFChar é especificado e definido como sim. x'1A' é excluído no final do arquivo transferido por download. `dddd ==> dddd (apenas sessão de Exibição 3270)` `dddd@ ==> dddd (apenas sessão de Exibição 3270)`

A segunda tabela descreve situações nas quais APPEND está especificado:

Remover- EOFChar	Preservar- Anexar- EOFChar	Ação Tomada:
Não	Não	Aplicado a: Sessão de Exibição 3270, sessão de Exibição 5250. Ambos os parâmetros não são especificados (ou são definidos como não). Essa é a situação padrão. -- x'1A' não é excluído no final do arquivo transferido por download. -- x'1A' é excluído no final dos dados anexados no arquivo, mas não é incluído novamente após os dados anexados. `ffff + dddd ==> ffffdddd` `ffff + dddd@ ==> ffffdddd@` `ffff@ + dddd ==> ffffdddd` `ffff@ + dddd@ ==> ffffdddd@`
Não	sim	Aplicado a: Sessão de Exibição 3270, sessão de Exibição 5250. Aqui, RemoveEOFChar não está especificado (ou está definido como não) e PreserveAppendEOFChar está especificado e definido como sim. -- x'1A' não é excluído no final do arquivo transferido por download. -- x'1A' é excluído no final dos dados anexados no arquivo e, em seguida, é incluído novamente após os dados anexados. -- Um máximo de um @ é retido no final. `ffff + dddd ==> ffffdddd` `ffff + dddd@ ==> ffffdddd@` `ffff@ + dddd ==> ffffdddd@` `ffff@ + dddd@ ==> ffffdddd@`
sim	sim ou não	Aplicado a: Sessão de Exibição 3270 e sessão de Exibição 5250. Aqui, RemoveEOFChar é especificado e definido como sim, enquanto PreserveAppendEOFChar pode ser especificado e definido como sim ou não especificado de forma alguma (ou definido como não). Sessão de Exibição 5250: Nenhum resultado. Isto é, para uma sessão de Exibição 5250, o resultado é o mesmo que se RemoveEOFChar não fosse especificado (ou se fosse definido como não). Consulte as outras duas linhas dessa tabela para obter os resultados. Sessão de Exibição 3270: O Host On-Demand desconsidera o valor de PreserveAppendEOFChar e considera as seguintes ações: -- x'1A' é excluído no final do arquivo transferido por download. -- x'1A' é excluído no final dos dados anexados no arquivo. `ffff + dddd ==> ffffdddd (apenas Exibição 3270)` `ffff + dddd@ ==> ffffdddd (apenas Exibição 3270)` `ffff@ + dddd ==> ffffdddd (apenas Exibição 3270)` `ffff@ + dddd@ ==> ffffdddd (apenas Exibição 3270)`

Tópicos Relacionados

Parâmetros HTML (PreserveAppendEOFChar)

Parâmetros HTML (RemoveEOFChar)

Opções de Texto de Recebimento (MVS/TSO e VM/CMS)

Opções de Texto de Recebimento (i5/OS e OS/400)