File Connector Guide > File Event Sources > File Read Lock Properties

File Read Lock Properties

The following table describes the file read lock properties:
Read Lock
Select a file read lock mode to avoid processing files that are in use at the same time the event source is accessing the files. The event source waits until the file lock is granted. Options:
  • - changed: Uses file length and modification timestamp to detect whether the file is currently being copied or not. This option slows processing due to the delay required to detect changes.
  • - rename: Tries to rename the file as a test to decide whether an exclusive read-lock is available for the file. Default.
  • - none: Do not use read lock.
For some connection types (like the File Connector), these read lock options are also available:
  • - markerFile: Creates a marker file and holds a lock on it.
  • - fileLock: Acquires a read lock on the file.
  • Not recommended when accessing a remote file system with a mount/share unless the file system supports distributed file locks.
Read Lock Timeout
Enter the number of seconds to wait before skipping the current file, if a read lock cannot be acquired.
During the next poll, the event source makes another attempt to process the skipped file. If set to 0, the event source waits as long as required.
Default: 10 seconds
Read Lock Check Interval
Enter the number of seconds to wait between attempts to acquire a read lock on a file.
Default: 1 second
Note: Set Read Lock Timeout to at least 3 times the value of this property to ensure that the event source can complete a file lock attempt on each file.
Read Lock Min Length
Enter the minimum file size, in bytes, that should be processed by the event source.
Note: Use this property only when Read Lock is set to changed.
Default: 1 byte
Read Lock Logging Level
Select the logging level to use when a read lock cannot be acquired: OFF, INFO, WARN, or ERROR.
Default: WARN