You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 50 Next »

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.

Job Example:

  <job ordeh1. 'no' >
     <params>
       <param name"file" valuh1. "." />
       <param name"file_spec" valuh1. "" />
       <param name"gracious" valuh1. "false" />
       <param name"max_file_age" valuh1. "0" />
       <param name"max_file_size" valuh1. "-1" />
       <param name"min_file_age" valuh1. "0" />
       <param name"min_file_size" valuh1. "-1" />
       <param name"skip_first_files" valuh1. "0" />
       <param name"skip_last_files" valuh1. "0" />
     </params>
     <script language"java" java_clash1. "sos.scheduler.file.JobSchedulerExistsFile" />
  </job>

Parameter used by JobSchedulerExistsFile

Name

title

mandatory

default

file

File or Folder to watch for

true

.

file_spec

Regular Expression for filename filtering

false

 

gracious

Enables or disables error messages

false

false

max_file_age

maximum age of one or multiple files

false

0

max_file_size

maximum size of one or multiple files

false

-1

min_file_age

minimum age of one or multiple files

false

0

min_file_size

minimum size of one or multiple files

false

-1

skip_first_files

number of files to remove from the beginning of the result-set

false

0

skip_last_files

number of files to remove from the bottom of the result-set

false

0

Parameter: <span id"file">file<span> File or Folder to watch for


File or Folder to watch for

Checked file or directory

Supports 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: 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/hello[date:yyyyMMdd].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 . Using Directory Monitoring with File Orders the 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: <span ih1. "file_spec">file_spec<span> Regular Expression for filename filtering


Regular Expression for filename filtering

Regular Expression for file filtering. The behaviour is CASE_INSENSITIVE.

Only effective if the parameter file is a directory.

Parameter: <span id"gracious">gracious<span> Enables or disables error messages


Enables or disables error messages

Enables 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, none

error log, Task error

error log, set_state error

true, 1, on, yes, y, ja, j

no error log, Task success

no error log, set_state error

all

no error log, Task success

no error log, set_state success

The default value for this parameter is false.

Parameter: <span ih1. "max_file_age">max_file_age<span> maximum age of one or multiple files


maximum age of one or multiple files

Specifies the maximum age of one or more files. If a file is older, then it is deemed not to exist.

Possible values:

0 (disabled)

seconds

hours:minutes

hours:minutes:seconds

The default value for this parameter is 0.

Parameter: <span id"max_file_size">max_file_size<span> maximum size of one or multiple files


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: <span ih1. "min_file_age">min_file_age<span> minimum age of one or multiple files


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: <span id"min_file_size">min_file_size<span> minimum size of one or multiple files


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: <span ih1. "skip_first_files">skip_first_files<span> number of files to remove from the beginning of the result-set


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: <span id"skip_last_files">skip_last_files<span> number of files to remove from the bottom of the result-set


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.

  • No labels