FileWatcher

Name

Type

Internal Field?

Description

directory

String

 

Full path of the directory to monitor

filemask

String

 

Name of the file you want to monitor. You can also enter a file name pattern

Examples:

  • Single file name (Example: myfile.txt).

  • File name pattern containing wildcard (Example: *.log to match any file with a .log extension, app-?.txt to match any .txt file that begins with app- followed by any single character)

Note: If a file mask matches multiple files, the job completes when any one of the files meet the specified criteria.

filematchall

String

 

  • Set the value to T to continue searching the directory so that the job completes when the first file that matches the specified file mask and criteria is found. The job outputs the matching file name when the job completes.

  • Set the value to F to continue searching the directory so that when the job completes after the specified Poll Duration, the job outputs all filenames matching the specified file mask and criteria

searchrecursive

String

 

If the value is T, searches all hierarchical subdirectories. If the value is F, searches only the specified directory

polllifetime

Integer

 

The maximum duration the directory should be polled. If the polllifetime expires when the job run is still active, the job completes abnormally with an error

polllifetimeunit

String

 

The polllifetime is measured in milliseconds/seconds/minutes

pollinterval

Integer

 

Specifies the time interval (milliseconds/seconds/minutes) between two consecutive polls for checking file availability and file updates

pollintervalunit

String

 

The pollinterval is measured in milliseconds/seconds/minutes

existence

String

 

The job completes normally within the specified poll duration when the condition for the existence or non-existence of a specified file is satisfied

filesizecondition

String

 

The job completes normally if one of the following criteria is met within the poll duration.

Select one of the criteria:

  • Equals – To specify the exact size that the file should have.

  • Maximum – To specify the size that the file should exceed.

  • Minimum – To specify the size that the file should not exceed

filesize

Integer

 

The job completes normally only if this criterion is met within the poll duration

fileactivity

String

 

The job completes normally within the specified poll duration when the specified file meets the specified file activity criteria.

File activity criteria:

  • File Stable for – Specifies the amount of time for which the file should be stable. The job completes normally if the file is not modified in the specified last N milliseconds/seconds/minutes.

  • File Modified in last – Specifies the recent time the file should have been modified. The job completes normally if the file is modified in the specified last N milliseconds/seconds/minutes

activitytimespan

Integer

 

Specifies the time (milliseconds/seconds/minutes) for the selected file activity

activitytimespanunit

String

 

The activitytimespan is measured in milliseconds/seconds/minutes