A cláusula FILE STATUS monitora a execução de cada operação de entrada e saída do arquivo.

Quando a cláusula FILE STATUS é especificada, o sistema move um valor para o item de dados da chave de status do arquivo após cada operação de entrada e saída que se refere explícita ou implicitamente a esse arquivo.
O valor indica o status de execução da instrução.
(Consulte a descrição da chave de status do arquivo em Common processing facilities - Recursos de processamento comuns.)

data-name-1

O item de dados da chave de status do arquivo pode ser definido na WORKING-STORAGE, LOCAL-STORAGE ou LINKAGE SECTION como um dos seguintes:

• Um item de dados de dois caracteres da categoria alfanumérica
• Um item de dados de dois caracteres da categoria national
• Um item de dados de dois dígitos da categoria numérica com DISPLAY ou NATIONAL (um item de dados decimal externo)

data-name-1 não deve conter o símbolo PICTURE 'P'.

data-name-1 pode ser qualificado.

O item de dados da chave de status do arquivo não deve estar localizado de forma variável; ou seja, o item de dados não pode seguir um item de dados que contém uma cláusula OCCURS DEPENDING ON.

data-name-8

Deve ser definido como um item de grupo alfanumérico de 6 bytes na seção de armazenamento de trabalho ou na seção de ligação da divisão de dados.

Especifique data-name-8 apenas se o arquivo for um arquivo VSAM (ou seja, ESDS, KSDS, RRDS).

data-name-8 contém o código de retorno VSAM de 6 bytes, composto da seguinte maneira:

• Os primeiros 2 bytes de data-name-8 contêm o código de retorno VSAM em formato binário.
  O valor para esse código é definido (pelo VSAM) como 0, 8 ou 12.


• Os próximos 2 bytes de data-name-8 contêm o código de função VSAM em formato binário.
  O valor para este código é definido (pelo VSAM) como 0, 1, 2, 3, 4 ou 5.
• Os últimos 2 bytes de data-name-8 contêm o código de feedback do VSAM em formato binário.
  O valor do código é de 0 a 255.

Se o VSAM retornar um código de retorno diferente de zero, data-name-8 será definido.

Se FILE STATUS for retornado sem ter chamado VSAM, data-name-8 será zero.

Se data-name-1 estiver definido como zero, o conteúdo de data-name-8 será indefinido.
As informações do código de retorno do status VSAM estão disponíveis sem transformação no código COBOL FILE STATUS definido no momento.
A identificação do usuário e a manipulação de condições de exceção são permitidas no mesmo nível que o definido pelo VSAM.

O código de função e o código de feedback são definidos se e somente se o código de retorno estiver definido como um valor diferente de zero.
Se eles forem referenciados quando o código de retorno estiver definido como zero, o conteúdo dos campos não será confiável.

Os valores nos campos de código de retorno, código de função e código de feedback são definidos pelo VSAM.
Não há adições, exclusões ou modificações de COBOL nas definições do VSAM.

Para obter mais informações, consulte DFSMS Macro Instructions for Data Sets - Instruções de macro DFSMS para conjuntos de dados.