Comando "SET REPROCESS"

Specifica quante volte o per quanto tempo bloccare un file o un record dopo un tentativo di blocco non riuscito.

Sintassi

  
SET REPROCESS TO nAttempts [SECONDS] | TO AUTOMATIC  

Argomenti

TO nAttempts[SECONDS]
Specifica il numero di volte o numero di secondi per tentare di bloccare un record o un file dopo un tentativo iniziale non riuscito. Il valore predefinito è 0; il valore massimo è 32.000.

SECONDS specifica che Visual FoxPro tenta di bloccare un file o un record per nAttempts secondi . È disponibile solo quando nAttempts è maggiore di zero.

Ad esempio, se nAttempts è 30, Visual FoxPro tenta di bloccare un record o un file fino a 30 volte. Se si includono anche SECONDS (SET REPROCESS TO 30 SECONDS), Visual FoxPro tenta continuamente di bloccare un record o un file per un massimo di 30 secondi.

Se è attiva una routine ON ERROR e se i tentativi da parte di un comando per bloccare il record o il file hanno esito negativo, viene eseguita la routine ON ERROR. Tuttavia, se una funzione tenta il blocco, una routine ON ERROR non viene eseguita e la funzione restituisce False (.F.).

Se non è attiva una routine ON ERROR, un comando tenta di bloccare il record o il file e il blocco non può essere inserito, viene generato un errore. Se una funzione tenta di posizionare il blocco, l'avviso non viene visualizzato e la funzione restituisce False (.F.).

Se nAttempts è 0 (valore predefinito) e si esegue un comando o una funzione che tenta di bloccare un record o un file, Visual FoxPro tenta di bloccare il record o il file per un periodo illimitato. Se il record o il file diventa disponibile per il blocco durante l'attesa, il blocco viene posizionato e il messaggio di sistema viene cancellato. Se una funzione ha tentato di posizionare il blocco, la funzione restituisce True (.T.).

Se è attiva una routine ON ERROR e un comando tenta di bloccare il record o il file, la routine ON ERROR ha la precedenza sui tentativi aggiuntivi di bloccare il record o il file. La routine ON ERROR viene eseguita immediatamente. Visual FoxPro non tenta blocchi di file o record aggiuntivi e non visualizza il messaggio di sistema.

Se nAttempts è 1, Visual FoxPro tenta di bloccare il record o il file per un periodo illimitato e non viene eseguita una routine ON ERROR.

Se un blocco è stato inserito da un altro utente nel record o nel file che si sta tentando di bloccare, è necessario attendere che l'utente rilasci il blocco.

TO AUTOMATIC
Specifica che Visual FoxPro tenta di bloccare il record o il file per un periodo illimitato. SET REPROCESS TO -2 è un comando equivalente.

Osservazioni:

Il primo tentativo di bloccare un record o un file non è sempre riuscito. Spesso un record o un file è bloccato da un altro utente in rete. SET REPROCESS determina se Visual FoxPro esegue ulteriori tentativi di bloccare il record o il file quando il tentativo iniziale non riesce. È possibile specificare quante volte vengono effettuati tentativi aggiuntivi o per quanto tempo vengono effettuati i tentativi. Una routine ON ERROR influisce sul modo in cui vengono gestiti i tentativi di blocco non riusciti.