Saltar navegação

S05.g - REWRITE

Conceitos

A instrução REWRITE é utilizada para sobregravar um registro do arquivo. O registro a ser sobregravado deverá ser lido antes de ser sobregravado.

Formato 1:

REWRITE nome-de-registro FROM variavel-1.

Considerações

O modo de acesso deverá ser SEQUENTIAL.

O arquivo deverá ser aberto no modo I-O.

O registro a ser alterado deverá ser lido antes da execução da instrução REWRITE.

O tamanho do registro a ser sobregravado não poderá ser modificado.

O nome-de-registro utilizado na instrução é o nome que foi definido para o registro no nível 01 da FD.

O parâmetro FROM permite que o conteúdo de variavel-1 seja automáticamente transferido para nome-de-registro na FD antes da gravação. A variavel-1 não poderá ser a área definida na FD. O efeito é o mesmo que a combinação das instruções MOVE e WRITE.

Formato 2:

REWRITE nome-de-registro FROM variavel-1INVALID KEY declaração-imperativa.

Considerações

O modo de acesso deverá ser RANDOM ou DYNAMIC.

O arquivo deverá ser aberto no modo I-O.

O registro a ser alterado será o especificado na chave-relativa.

O tamanho do registro a ser sobregravado não poderá ser modificado.

O nome-de-registro utilizado na instrução é o nome que foi definido para o registro no nível 01 da FD.

O parâmetro FROM permite que o conteúdo de variavel-1 seja automáticamente transferido para nome-de-registro na FD antes da gravação. A variavel-1 não poderá ser a área definida na FD. O efeito é o mesmo que a combinação das instruções MOVE e WRITE.

Se o registro especificado na chave-relativa não for encontrado, a declaração-imperativa da cláusula INVALID KEY será executada.

Licença: licença proprietária