SYS(3052) - Override SET REPROCESS Locking

  • Article

Specifies whether Visual FoxPro uses the SET REPROCESS setting when attempting to lock an index or memo file.

SYS(3052, nFileType, [lHonorReprocess])

Return Values

Character

Parameters

  • nFileType
    Specifies the type of file. The following table lists the values for nType and the corresponding file type:

    nFileType File type
    1 Index
    2 Memo

  • lHonorReprocess
    Specifies whether Visual FoxPro uses the SET REPROCESS setting for unsuccessful lock attempts for index and memo files.

    Specify true (.T.) to use the SET REPROCESS setting when Visual FoxPro attempts to lock files specified with nFileType. Specify false (.F.), the default, to override the SET REPROCESS setting when Visual FoxPro attempts to lock files specified with nFileType. When set to false, Visual FoxPro waits indefinitely for locks on the specified files; this option is the same as locking behavior in previous versions of FoxPro.

    If you omit lHonorReprocess, SYS(3052) returns the current setting for the file type specified with nFileType.

Remarks

SYS(3052) provides additional control over file locking in Visual FoxPro. It's best to set lHonorReprocess to true (.T.) in order to reduce the risk of file lock contention if your application uses transaction processing.

SYS(3052) returns as a character string a numeric value of 0 (corresponding to false (.F.)) or 1 (corresponding to true (.T.)). If lHonorReprocess is included in SYS(3052), the value returned is identical to the logical value you specify for lHonorReprocess. If you omit lHonorReprocess, the value returned is the current setting for the file type specified with nFileType.

See Also

SET REPROCESS | SYS(3051) - Set Lock Retry Interval | Locking Data