Directory Monitor

The Directory Monitor task is a special type of task which can be used in two ways:
1) If a change is detected in this task, you can run another task, or
2) The Directory Monitor task can also be embedded within a Chain task, and is useful for conditional task processing. If a change is detected, then an exit code = -100 is thrown.  Else, an exit code = 0 is thrown.

The Directory Monitor task also outputs a variable called 'TaskTitle::Filenames".  This variable contains the list of all files that have been modified, since the last time this task was run.  The format of this variable is #file1^#file2^#file3, where file1, file2, file3, are the names of the files, that have been modified.  You can use this variable directly as the filename in other copy tasks, ftp tasks, or delete tasks, to process only these files.

Directory to Monitor
Enter the directory or file you need to monitor.

Include Subdirectories
To monitor all sub directories, select this option

Filename
Enter the filename filter for the files you wish to copy  using the following wildcard rules. This field also supports dynamic variables.  Using dynamic variables, you can select a file based on current date/time.

Task To Run
Select the desired task to run if any of the selected criteria is met.  If you want to use this task in a chain for conditional processing, select 'None'.  You can also select multiple tasks to run in sequence, or to run simultaneously. To run tasks in sequence, use taskTitle1|taskTitle2|taskTitle3. To run tasks simultaneously, use taskTitle1&taskTitle2&taskTitle3.

• Create a Directory Monitor task with the directory or file you need to monitor for changes.
• Create a Chain Task with the above "Directory Monitor" task as the 1st step.
• Use the Exit Code criteria as (Exit Code != -100 Go to Step 10) i.e. stop chain if exit code != -100
• Add a second task after this step.
• If a directory change is detected from comparison with the previous run of this task, the Directory Monitor task will exit with Exit Code = -100 and the Chain will run the 2nd task.
• If no change is detected, the Directory Monitor task will exit with Exit Code = 0 and the Chain will terminate without running the 2nd task.

Difference between Directory Change and Directory Monitor Tasks
Directory Change task keeps polling the directory for the maximum time set.  When the maximum time expires or a change is detected, this task either exits or continues polling as a daemon.  This task can only monitor single directory.
Directory Monitor task stores (in a log file), the modified date information for all files within the directory.  This log file is read and updated with every run. The Directory Monitor task compares the modified date (stored in the log file) with the actual modified date of the file.  This task can also monitor sub directories.