Comando SET REPROCESS

Especifica quantas vezes ou por quanto tempo bloquear um arquivo ou registro após uma tentativa de bloqueio malsucedida.

Sintaxe

  
SET REPROCESS TO nAttempts [SECONDS] | TO AUTOMATIC  

Argumentos

TO nAttempts[SECONDS]
Especifica o número de vezes ou o número de segundos para tentar bloquear um registro ou arquivo após uma tentativa iniciais malsucedida. O valor padrão é 0; o valor máximo é 32.000.

SECONDS especifica que o Visual FoxPro tenta bloquear um arquivo ou registro por segundos nAttempts . Ele só está disponível quando nAttempts é maior que zero.

Por exemplo, se nAttempts for 30, o Visual FoxPro tentará bloquear um registro ou arquivo até 30 vezes. Se você também incluir SECONDS (SET REPROCESS TO 30 SECONDS), o Visual FoxPro tentará bloquear continuamente um registro ou arquivo por até 30 segundos.

Se uma rotina ON ERROR estiver em vigor e se as tentativas de um comando para bloquear o registro ou arquivo não tiverem êxito, a rotina ON ERROR será executada. No entanto, se uma função tentar o bloqueio, uma rotina ON ERROR não será executada e a função retornará False (.F.).

Se uma rotina ON ERROR não estiver em vigor, um comando tentará bloquear o registro ou o arquivo e o bloqueio não poderá ser colocado, um erro será gerado. Se uma função tentar colocar o bloqueio, o alerta não será exibido e a função retornará False (.F.).

Se nAttempts for 0 (o valor padrão) e você emitir um comando ou função que tente bloquear um registro ou arquivo, o Visual FoxPro tentará bloquear o registro ou o arquivo indefinidamente. Se o registro ou arquivo estiver disponível para bloqueio enquanto você aguarda, o bloqueio será colocado e a mensagem do sistema será desmarcada. Se uma função tentou colocar o bloqueio, a função retornará True (.T.).

Se uma rotina ON ERROR estiver em vigor e um comando estiver tentando bloquear o registro ou o arquivo, a rotina ON ERROR terá precedência sobre tentativas adicionais de bloquear o registro ou o arquivo. A rotina ON ERROR é executada imediatamente. O Visual FoxPro não tenta bloqueios de arquivo ou registro adicionais e não exibe a mensagem do sistema.

Se nAttempts for 1, o Visual FoxPro tentará bloquear o registro ou o arquivo indefinidamente e uma rotina ON ERROR não será executada.

Se um bloqueio tiver sido colocado por outro usuário no registro ou arquivo que você está tentando bloquear, você deverá aguardar até que o usuário libere o bloqueio.

PARA AUTOMÁTICO
Especifica que o Visual FoxPro tenta bloquear o registro ou o arquivo indefinidamente. (SET REPROCESS TO -2 é um comando equivalente.)

Observações

A primeira tentativa de bloquear um registro ou arquivo nem sempre é bem-sucedida. Com frequência, um registro ou arquivo é bloqueado por outro usuário na rede. SET REPROCESS determina se o Visual FoxPro faz tentativas adicionais de bloquear o registro ou o arquivo quando a tentativa inicial não é bem-sucedida. Você pode especificar quantas vezes tentativas adicionais são feitas ou por quanto tempo as tentativas são feitas. Uma rotina ON ERROR afeta a maneira como tentativas de bloqueio malsucedidas são tratadas.