Page History

Description of JobSchedulerExistsFile - check wether a file exist

Checks for the existence of a file, a directory or for specific files inside of a directory.

Parameter used by JobSchedulerExistsFile

Parameter: file

File or Folder to watch forChecked file or directorySupports masks for substitution in the file name and directory name with format strings that are enclosed by {*} and {*} . The following format strings are supported: date format date format must be a valid Java data format string, e.g. yyyyMMddHHmmss , yyyy-MM-dd.HHmmss etc.Example: <param namh1. "file" value"sample/helloyyyyMMdd.txt" /> On 2050-12-31 the parameter file contains the value "sample/hello20501231.txt" .Supports substitution of job parameter names with their value if the job parameter name is enclosed by %  and  % .Example: <param namh1. "file" value"%scheduler_file_path%" /> During the job runtime the parameter file contains the value of the job parameter scheduler_file_path . UsingDirectory Monitoring with File Ordersthe job parameter scheduler_file_path contains automatically the path of the file that triggered the order.
The default value for this parameter is ..
This parameter is mandatory.

Parameter: file_spec

Regular Expression for file filteringRegular Expression for file filtering. The behaviour is CASE_INSENSITIVE.
Only effective if the parameter file is a directory.

Parameter: gracious

Enables or disables error messagesEnables or disables error messages that are caused by a nonexistent file or directory being specified with the parameters file and respectively file_spec .

Valid values: false, 0, off, no, n, nein, none , true, 1, on, yes, y, ja, j and all

The following rules apply when file and respectively file_spec contains an incorrect value: GRACIOUS Standalone-Job Order-Job false, 0, off, no, n, nein, noneerror log,
Task errorerror log,
set_state errortrue, 1, on, yes, y, ja, jno error log,
Task successno error log,
set_state errorallno error log,
Task successno error log,
set_state success
The default value for this parameter is false.

Parameter: max_file_age

maximum age of one or multiple filesSpecifies the maximum age of one or more files. If a file is older, then it is deemed not to exist.Possible values:0 (disabled)secondshours:minuteshours:minutes:seconds
The default value for this parameter is 0.

Parameter: max_file_size

maximum size of one or multiple filesSpecifies the maximum size of one or multiple files in bytes: should the size of one of the files exceed this value, then it is classified as non-existing.

Possible Values:
-1 (disabled)
number (Byte), e.g. 40
numberKB, e.g. 5KB (case insensitive)
numberMB, e.g. 20MB (case insensitive)
numberGB, e.g. 10GB (case insensitive)
The default value for this parameter is -1.

Parameter: min_file_age

minimum age of one or multiple filesSpecifies the minimum age of one or multiple files. If the file(s) is newer then it is classified as non-existing.

Possible values:
0 (disabled)
seconds
hours:minutes
hours:minutes:seconds
The default value for this parameter is 0.

Parameter: min_file_size

minimum size of one or multiple filesSpecifies the minimum size of one or multiple files in bytes: should the size of one of the files fall below this value, then it is classified as non-existing.

Possible Values:
-1 (disabled)
number (Byte), e.g. 40
numberKB, e.g. 5KB (case insensitive)
numberMB, e.g. 20MB (case insensitive)
numberGB, e.g. 10GB (case insensitive)
The default value for this parameter is -1.

Parameter: skip_first_files

number of files to remove from the beginning of the result-setThe number of files are removed from the beginning of the set resulting by min_file_size, min_file_age etc. These files are excluded from further operations.

The result set is sorted according to the used constraining parameters:
+ min_file_age, max_file_age: in ascending order by date of last modification, the newest file first.
+ min_file_size, max_file_size: in ascending order by file size, the smallest file first.
+ if parameters for file age as well as file size are given the set is sorted by file age.

Only either skip_first_files or skip_last_files is allowed to be set at one time.
The default value for this parameter is 0.

Parameter: skip_last_files

number of files to remove from the bottom of the result-setThe number of files are removed from the end of the set resulting by min_file_size, min_file_age etc. These files are excluded from further operations.

The result set is sorted according to the used constraining parameters:
+ min_file_age, max_file_age: in ascending order by date of last modification, the newest file first.
+ min_file_size, max_file_size: in ascending order by file size, the smallest file first.
+ if parameters for file age as well as file size are given the set is sorted by file age.

Only either skip_first_files or skip_last_files is allowed to be set at one time.
The default value for this parameter is 0.