FILE WATCHER

The file watcher monitors a directory for the appearance of one or files that match a defined pattern. The following parameters must be set in the config section:

• directory. The directory to monitor

• call. The job to call when file(s) are detected. This should be a configuration file name (with or without the extension) and the section within the configuration file

The file watched item parameters are:

• name. The name of this item.

• duration. How long to wait before the file watcher expires. This should be an integer concatenated with s, m, h or d for seconds, minutes, hours or days.

• file_pattern. A glob pattern.

• wait time. Time to wait between each successive poll of the directory. Defaults to one second.

• raise_no_file_error. Raise an error if no file is detected before the duration of the watcher.

• exit_on_detaction. Quit the file watcher if any files are detected.

Example

Below is an example of a complete file watcher job. Typically, a the job only has one item, the watcher itself.

    <fw_file>
        type = serial
        
        <config>
            directory = %app_root%/data/incoming
            call      = sales prep_sales_file
        </config>
        
        <process>
            <item>
                name          = Billing Watch
                type          = watch
                duration      = 5h
                file_pattern  = billing.tar.Z
            </item>
        </process>
    </fw_file>

Notes:

• If the file watcher does not exit on detection, the called job should move or delete any files that were detected, otherwise the watcher will be caught in an endless loop.

• The call to the next job is synchronous. No further watching will happen until the called job exits.

• All "next" calls are asynchronous. If the called job invokes yet another pipeline via "next", the watcher is released and can continue monitoring its directory