Overview

The Agent File Monitor trigger allows you to trigger one or more tasks based on the creation, deletion, or change of a file on a particular machine, as specified by a selected Agent File Monitor task, as illustrated below. For a detailed description, see Launching an Agent File Monitor Task Using an Agent File Monitor Trigger.

Note

Using an Agent File Monitor trigger to trigger an Agent File Monitor task that is monitoring for the creation of one or more files (Monitor Type = Exists) will disable the trigger. You should instead specify (Monitor Type = Create) and check Trigger on Existence.

Built-In Variables

The built-in variables outlined below can be used to pass data where appropriate:

Prerequisites

Before you can use an Agent File Monitor Trigger, you need the following:

A Windows, Linux/Unix, or z/OS agent, which will execute the Agent File Monitor task.
An Agent File Monitor task, which watches for the creation, deletion, change, existence, or non-existence of a file.

Note

Any changes made to an Agent File Monitor task are not recognized by its respective Agent File Monitor Triggers until those Triggers are disabled and re-enabled.

Creating an Agent File Monitor Trigger

Step 1	From the Automation Center navigation pane, select Triggers > Agent File Monitor Triggers. The Agent File Monitor Triggers list displays. Below the list, Agent File Monitor Trigger Details for a new Agent File Monitor trigger displays.
Step 2	Enter/select Details for a new Agent File Monitor trigger, using the field descriptions below as a guide. Required fields display an asterisk ( * ) after the field name. Default values for fields, if available, display automatically. To display more of the Details fields on the screen, you can either: Use the scroll bar. Temporarily hide the list above the Details. Click the New button above the list to display a pop-up version of the Details.
Step 3	Click a Save button. The trigger is added to the database, and all buttons and tabs in the Trigger Details are enabled.
Step 4	Enable the trigger(s) as desired.

Note

To open an existing record on the list, either:

Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).

Agent File Monitor Trigger Details

The following Agent File Monitor Trigger Details is for an existing Agent File Monitor trigger. See the field descriptions, below, for a description of the fields that display in the Agent File Monitor Trigger Details.

Agent File Monitor Trigger Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the Agent File Monitor Trigger Details.

Field Name	Description
General	This section contains general information about the trigger.
Name	Unable to render {include} The included page could not be found.
Version	Unable to render {include} The included page could not be found.
Description	Unable to render {include} The included page could not be found.
Member of Business Services	Unable to render {include} The included page could not be found.
Calendar	Unable to render {include} The included page could not be found.
Time Zone	Unable to render {include} The included page could not be found.
Task(s)	Unable to render {include} The included page could not be found.
Purge By Retention Duration	Unable to render {include} The included page could not be found.
Exclude Backup	Unable to render {include} The included page could not be found.
Retention Duration	Unable to render {include} The included page could not be found.
Retention Duration Unit	Unable to render {include} The included page could not be found.
Execution User	Unable to render {include} The included page could not be found.
Status	This section contains information about the current status of the trigger.
Status	Unable to render {include} The included page could not be found.
Next Scheduled Time	Unable to render {include} The included page could not be found.
Enabled By	Unable to render {include} The included page could not be found.
Disabled By	Unable to render {include} The included page could not be found.
Enabled Time	Unable to render {include} The included page could not be found.
Disabled Time	Unable to render {include} The included page could not be found.
Skip Details	This section contains detailed information about skipping the trigger.
Task Launch Skip Condition	Unable to render {include} The included page could not be found.
Skip Restriction	Unable to render {include} The included page could not be found.
Skip Count	Unable to render {include} The included page could not be found.
Skip Before Date	Unable to render {include} The included page could not be found.
Skip Before Time	Unable to render {include} The included page could not be found.
Skip After Date	Unable to render {include} The included page could not be found.
Skip After Time	Unable to render {include} The included page could not be found.
Skip Date List	Unable to render {include} The included page could not be found.
Agent File Monitor Details	This section contains assorted detailed information about the trigger.
Agent File Monitor	Unable to render {include} The included page could not be found.
Running Monitor	Unable to render {include} The included page could not be found.
Restrictions	This section specifies any restrictions that apply to the trigger.
Restrict Times	Unable to render {include} The included page could not be found.
Enabled Start	Unable to render {include} The included page could not be found.
Enabled End	Unable to render {include} The included page could not be found.
Special Restriction	Unable to render {include} The included page could not be found.
Action	Unable to render {include} The included page could not be found.
Simple Restriction	Unable to render {include} The included page could not be found.
Situation	Unable to render {include} The included page could not be found.
Complex Restriction	Unable to render {include} The included page could not be found.
Restriction Mode	Unable to render {include} The included page could not be found.
Restriction Adjective	Unable to render {include} The included page could not be found.
Restriction Noun	If Complex Restriction is enabled, the day(s) you want to select. Options: Sunday through Saturday Day Business Day Custom Day Example: The last Business Day and Sunday of the month.
Restriction Qualifier	If Complex Restriction is enabled, the period(s) you are selecting from. Options: Jan - Dec Month Year Week Quarter Custom period Example: The last Day of Quarter, Year, and January.
Restriction Nth Amount	Unable to render {include} The included page could not be found.
Metadata	This section contains Metadata information about this record.
UUID	Universally Unique Identifier of this record.
Updated By	Name of the user that last updated this record.
Updated	Date and time that this record was last updated.
Created By	Name of the user that created this record.
Created	Date and time that this record was created.
Buttons	This section identifies the buttons displayed above and below the Trigger Details that let you perform various actions.
Save	Saves a new task record in the Controller database.
Save & New	Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.
Save & View	Saves a new record in the Controller database and continues to display that record.
New	Displays empty (except for default values) Details for creating a new record.
Update	Unable to render {include} The included page could not be found.
Enable	Unable to render {include} The included page could not be found.
Disable	Unable to render {include} The included page could not be found.
Trigger Now...	Unable to render {include} The included page could not be found.
Copy	Creates a copy of this trigger, which you are prompted to rename.
Delete	Unable to render {include} The included page could not be found.
Refresh	Refreshes any dynamic data displayed in the Details.
Close	For pop-up view only; closes the pop-up view of this trigger.
Tabs	This section identifies the tabs across the top of the Trigger Details that provide access to additional information about the trigger.
Variables	Unable to render {include} The included page could not be found.
Instances	Unable to render {include} The included page could not be found.
Notes	Unable to render {include} The included page could not be found.
Versions	Unable to render {include} The included page could not be found.