Check Files Locked

Description

The Check files locked action loops over a list of files to check if they are locked by another process.

The way that it verified is by renaming a file to the same name as before.

On certain operating systems (MS Windows systems in particular) this operation will fail if the file is locked.

Options

Option Description

Action name

The name of the workflow action.

Settings: Include subfolders

Enable this option to also check files in subfolders of specified folders

Settings: Copy previous results to args?

Pass the result rows of a previous workflow action execution to the files list of this action.

Files/Folders

The files or folders to check.

Wildcard

The wildcards are Java Regular expressions. For instance .*\.txt would check any file with a .txt extension.

Result

What this action passes on to the next action. See Action results for how results travel through a workflow.

Result Value

True

No file is locked. A file or folder that does not exist is not checked and does not make the action false. With nothing to check, the action is true too.

False

A file is locked: it cannot be renamed to its own name. The action stops at the first locked file, and the number of errors is 1. The action is also false, with 1 error, when Wildcard is not a valid regular expression, or when an error stops the check.

Result files

Passed on unchanged.

Result rows

Passed on unchanged. With Copy previous results to args?, the file or folder comes from the first field and the wildcard from the second field of each result row, and the list in the dialog is not used, also when there are no result rows. A row with only one field is checked without a wildcard.

On Linux and macOS a file is reported as locked when its folder is read-only, because it cannot be renamed.