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 inicial 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 está disponível somente 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 forem bem-sucedidas, 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 arquivo indefinidamente. Se o registro ou arquivo ficar disponível para bloqueio enquanto você aguarda, o bloqueio é colocado e a mensagem do sistema é limpa. Se uma função tentar 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 arquivo, a rotina ON ERROR terá precedência sobre tentativas adicionais de bloquear o registro ou 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.)
Comentários
A primeira tentativa de bloquear um registro ou arquivo nem sempre é bem-sucedida. Frequentemente, 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 como as tentativas de bloqueio malsucedidas são tratadas.