RETRYTIME

Change wait time for “File in use” errors

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows

 

 

To accommodate system events that may periodically access your files (such as virus scanners), OPEN, DELET, and RENAM will attempt to retry file access for up to 5 seconds before reporting that a file is in use. The RETRYTIME environment variable changes the amount of time they will retry.

Value

The number of 1/10ths of a second to retry. The default is 50 (which is 5 seconds).

Discussion

Because a virus scanner can take several seconds to scan a file, which sometimes causes a “File in use by another user” error ($ERR_FINUSE), the OPEN statement and the DELET and RENAM routines will by default retry for up to 5 seconds (50 one‑tenth‑of‑a‑second retries) before reporting that a file is in use. You can use RETRYTIME to lower the wait time if the operations are taking too long or raise it if you’re still getting unexplained $ERR_FINUSE errors.

Setting location

The environment or the [synergy], [dbr], or [myprog] section of synergy.ini (where myprog is any .dbr file).

Used by

Runtime, linker, librarian.

Examples

The following example reduces the retry time to 1 second:

set RETRYTIME=10