Monitor File

The Monitor File object triggers a Policy when files that you specify in folders and sub-folders have changed.

Note: This object replaces the Monitor File Legacy object. For more information, see the Legacy topic.

How it is used

Use the Monitor File object to monitor a file that indicates the completion of a transaction. For example, there are nightly transfers to your Action Server, and when the transfer is complete a file called "COMPLETE" is written to the folder. The Monitor File object can automatically trigger a Policy that processes all the files in the folder when the "COMPLETE" file appears.

Configuration

To configure the Monitor File object you need to know the name of the file that you are monitoring and what criteria on that file will trigger the Policy.

Details Tab

 

In folder

Type the path to the file that you are monitoring, or use the ellipsis button (...) to browse for it.

Filters

Create filters with custom criteria for the files that you want to monitor. Perform the following for each filter that you want to create: 1. Click Add. The Select Filter dialog appears. 2. From the Name drop-down list, select the criteria that you want to use. The Relation and Value items change and present custom options according to the criteria that you select from the Name drop-down list. 3. Select options from the Relation and Value items. 4. Click OK.

Triggers Tab

 

Trigger if one of the files was	Select a condition to trigger the object if the condition in the monitored file is true.
Trigger if file properties changed	Select a condition to trigger the object if the condition in the monitored file is true.

Authentication Tab

 

Username	Type the username required to access the folder if it is on a remote computer.
Password	Type the password required to access the folder if it is on a remote computer.

Available Published Data

 

Name	Description
Change type	The type of changed that was detected on the file.
Name and path of the file	The name and path of the file that was monitored.
Include sub-folders	Indicates whether the Include sub-folders check box was checked or not.
Notify if changed	Indicates whether the Changed check box was checked or not.
Notify if created	Indicates whether the Created check box was checked or not.
Notify if deleted	Indicates whether the Deleted check box was checked or not.
Notify if renamed	Indicates whether the Renamed check box was checked or not.
Folder	The folder that the monitored file was stored in.
Notify if file attributes changed	Indicates whether the Attributes check box was checked or not.
Notify if file creation time changed	Indicates whether the Creation time check box was checked or not.
Notify if file last access time changed	Indicates whether the Last access time check box was checked or not.
Notify if file last write time changed	Indicates whether the Last write time check box was checked or not.
Notify if file security changed	Indicates whether the Security check box was checked or not.
Username	The username used to access the folder if it was on a remote computer.

Common Published Data