Email Monitor Trigger
Overview
The Email Monitor trigger allows you to trigger one or more tasks based on the status of a Mailbox Folder being monitored, as specified by a selected Email Monitor task.
Built-In Variables
The built-in variables outlined below can be used to pass data where appropriate:
Prerequisites
Before you can use a Email Monitor Trigger, you need the following:
A Windows, Linux/Unix, or z/OS agent, which will execute the Email Monitor task.
An Email Monitor task, which specifies an Email Mailbox folder to monitor.
Note
Any changes made to an Email Monitor task are not recognized by its respective Email Monitor Triggers until those Triggers are disabled and re-enabled.
Creating an Email Monitor Trigger
Step 1 | From the Automation Center navigation pane, select Triggers > File Monitor Triggers. The Email Monitor Triggers list displays. |
|---|---|
Step 2 | Enter/select Details for a new Email Monitor trigger, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
Step 3 | Click a 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).
Email Monitor Trigger Details
The following Email Monitor Trigger Details is for an existing Email Monitor trigger. See the field descriptions, below, for a description of the fields that display in the Email Monitor Trigger Details.
Email Monitor Trigger Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in the Email Monitor Trigger Details.
Field Name | Description |
|---|---|
General | This section contains general information about the trigger. |
Name |
|
Version | System-supplied; version number of the current record, which is incremented by the system every time a user updates a record. Click the Versions tab to view previous versions. For details, see Record Versioning. |
Description | Description of this record. Maximum length is 255 characters. |
Member of Business Services | User-defined; Allows you to select one or more Business Services that this record belongs to. (You also can Check All or Uncheck All Business Services for this record.) You can select up to 62 Business Services for any record type, and enter a maximum of 2048 characters for each Business Service. If the Business Service Visibility Restricted Universal Controller system property is set to true, depending on your assigned (or inherited) Permissions or Roles, Business Services available for selection may be restricted. |
Calendar |
Select a Calendar from the drop-down list of all existing Calendars. To display detailed information about a selected calendar, click the Details icon next to the Calendar field. |
Time Zone |
User-defined; allows you to specify the time zone that will be applied to the time(s) specified in the trigger. For example, if you specify 23:00 and a time zone of Canada/Central, the task will run at 11:00 p.m. Central Canada time. |
Task(s) |
Name of the task(s) being triggered when this trigger is satisfied. When selecting tasks from the Details, click on the lock icon to unlock the field and select tasks. |
Simulate | Specifies if the instances generated by this trigger should execute under simulation mode, in which none of the tasks execute. Alternatively, simulation mode can be enabled from the Trigger Now… command (see Triggering with Variables and Triggering by Date and Time). |
Purge By Retention Duration | |
Exclude Backup | |
Retention Duration | |
Retention Duration Unit | |
Execution User | |
Status | This section contains information about the current status of the trigger. |
Status | |
Next Scheduled Time | |
Enabled By | |
Disabled By | |
Enabled Time | |
Disabled Time | |
Skip Details | This section contains detailed information about skipping the trigger. |
Task Launch Skip Condition | |
Skip Restriction | |
Skip Count | |
Skip Before Date | |
Skip Before Time | |
Skip After Date | |
Skip After Time | |
Skip Date List | |
Email Monitor Details | This section contains assorted detailed information about the trigger. |
Email Monitor | |
Running Monitor | |
Restrictions | This section specifies any restrictions that apply to the trigger. |
Restrict Times | |
Enabled Start | |
Enabled End | |
Special Restriction | |
Action | |
Simple Restriction | |
Situation | |
Complex Restriction | |
Restriction Mode | |
Restriction Adjective | |
Restriction Noun(s) | |
Restriction Qualifier(s) | |
Restriction Nth Amount | |
Self-Service Options | This section contains Self-Service specifications for the trigger. |
Enforce Variables | |
Lock Variables | |
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 | |
Enable | |
Disable | |
Trigger Now... | |
Copy | Creates a copy of this trigger, which you are prompted to rename. |
Delete | |
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 | |
Instances | |
Notes | |
Versions |