...
It is recommended that you use a Cron trigger, rather than a Time trigger, if you want to schedule non-standard time intervals for a triggering a task (see 63571356 Scheduling a Time Interval, below).
Cron Syntax
The Cron trigger uses standard Cron syntax. Once the Cron trigger is entered into the system, the Controller interprets it and processes it as it would any other trigger. The trigger is satisfied when the current date and time match all the values specified in the Minutes, Hours, Day of Month, Month, and Day of Week fields.
...
Field Name | Required | Allowed Values | Allowed Special Characters |
|---|---|---|---|
Minutes | Yes | 0-59 | * / , - |
Hours | Yes | 0-23 | * / , - |
Day of Month | Yes | 1-31 | * / , - |
Month | Yes | 1-12 or JAN-DEC | * / , - |
Day of Week | Yes | 0-7 or SUN (0 or 7)-SAT | * / , - |
...
| Note | ||
|---|---|---|
| ||
The day when a Cron trigger launches can be specified by two fields: 63571356 and 63571356 Day of Month and Day of Week. If both fields are restricted (that is, they both are not *), the trigger launches based on the 63571356 Day Logic field value. If 63571356 Day Logic is set to Or, when either Day field matches, the trigger can launch. For example: 30 4 1,20 * 5 would cause the trigger to launch at 4:30 a.m. on the 1st and 20th of each month, as well as on every Friday. If, however, 63571356 Day Logic is set to And, the trigger would launch at 4:30 a.m. only on days that are the 1st or 20th which are also a Friday. |
| Anchor | ||||
|---|---|---|---|---|
|
Cron Special Characters
Asterisk ( * ) | An asterisk indicates that the expression matches for all values of the field. For example, using * in the Month field indicates every month. |
|---|---|
Slash ( / ) | A slash describes an increment of ranges. For example, 5-50/15 in the Minutes field indicate the fifth minute of the hour and every 15 minutes thereafter until the 50th minute (5,20,35,50). |
Hyphen ( - ) | Defines a range of numbers, which are two numbers separated by a hyphen. The specified range is inclusive. For example, 9-17 in the Hours field means from 9 a.m. to 5 p.m., inclusive. |
Comma ( , ) | Separates items in a list. A list is a set of numbers or ranges separated by commas. For example, 1,5-9,18-20 in the Hours field indicate the following hours 1,5,6,7,8,9,18,19,20. |
| Anchor | ||||
|---|---|---|---|---|
|
Cron Criteria Examples
Cron Criteria | Description |
|---|---|
0 3 30 4,6,9,11 5 | At 3 a.m. on the 30th of the month, for months with exactly 30 days, if the 30th is a Friday. |
0 3 31 * 0 | At 3 a.m. on the 31st of the month if the 31st is a Sunday. |
0 3 22-28 * 0 | At 3 a.m. on the 4th Sunday of every month. |
0 5-19/7 * * * | Every 7 hours between 5 a.m. and 7 p.m., daily. |
0 5,12,19 * * 1,3 | Every 7 hours between 5 a.m. to 7 p.m. on Monday and Wednesday. |
0 9-17 * * Mon-Fri | Every hour between 9 a.m. and 5 p.m. from Monday to Friday. |
0 2-11/3 * * * | Every 3 hours between 2 a.m. and 11 a.m., daily. |
0 3 29 2 * | At 3 a.m. on February 29th. |
30 1-3,17 * * 1,3,5 | At 30 minutes past the hours of 1 a.m., 2 a.m., 3 a.m., and 5 p.m. on Monday, Wednesday, and Friday. |
| Anchor | ||||
|---|---|---|---|---|
|
Creating a Cron Trigger
Step 1 | From the Automation Center navigation pane, select Triggers > Cron Triggers. The Cron Triggers list displays. |
|---|---|
Step 2 | Enter/select Details for a new Cron 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 |
Step 4 | Enable the trigger(s) as desired. |
...
| Note | ||
|---|---|---|
| ||
To open an existing record on the list, either:
|
| Anchor | ||||
|---|---|---|---|---|
|
Cron Trigger Details
The following Cron Trigger Details is for an existing Cron trigger. See the field descriptions, below, for a description of the fields that display in the Cron Trigger Details.
| Anchor | ||||
|---|---|---|---|---|
|
The following table describes the fields, buttons, and tabs that display in the Cron Trigger Details.
Field Name | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
General | This section contains general information about the trigger. | ||||||||||||
Name |
| ||||||||||||
Version |
| ||||||||||||
Description |
| ||||||||||||
Member of Business Services |
| ||||||||||||
Calendar |
| ||||||||||||
|
| ||||||||||||
Task(s) |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Forecast Include Page | | IL:Forecast | IL:Forecast | Simulate Forecast | Enables the override of the Enable Trigger Simulation Universal Controller system property specification for whether or not to simulate the launching of tasks when triggers are eligible to fire. (If simulation is enabled, only the scheduled launch of the task by the trigger is inhibited.) |
| |||||||
Simulate Forecast |
| ||||||||||||
Status | This section contains information about the current status of the trigger. | ||||||||||||
Status |
| ||||||||||||
Next Scheduled Time |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
| Skip Details | This section contains detailed information about skipping the trigger. | ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Cron Details | This section contains assorted detailed information about the trigger. | ||||||||||||
Minutes |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Month |
| ||||||||||||
|
| ||||||||||||
Cron Criteria |
| ||||||||||||
|
| ||||||||||||
Restrictions | This section specifies any restrictions that apply to the trigger. | ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
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 |
| ||||||||||||
|
| ||||||||||||
|
| ||||||||||||
Trigger Now... |
| ||||||||||||
List Qualifying Times |
| ||||||||||||
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 |
| ||||||||||||
|
|
| Anchor | ||||
|---|---|---|---|---|
|
Scheduling a Time Interval
A Cron trigger lets you schedule a time interval for how often a task will be triggered. You also can select a time frame that restricts the time during which the trigger is active, so that a task will be triggered only at the time intervals within that time frame.
...
Although you also can use a Time trigger to schedule a time interval for a task to be triggered on multiple days, you should use a Cron trigger if the time interval is not one by which the 24-hour clock is even divisible (2, 3, 4, 6, 8, and 12), such as in the Cron criteria examples, above. Using a Time trigger to schedule this type of time interval could produce unexpected results, since the time interval for a Time trigger does not reset at the end of the day. It continues into the next day, regardless of the 24-hour clock (see Scheduling a Time Interval with a Time Trigger).
Conversely, if you want to trigger a task on multiple days at a time interval without regard to the time of day, and the interval is not one by which the 24-hour clock is even divisible, you must use a Time trigger, which will not reset at the end of the day. For example, if you want to trigger a task every 5 hours, from Monday to Friday, without regard to the time of day, a Time trigger will allow you to trigger the task on Monday at 12 a.m., 5 a.m., 10 a.m., 3 p.m., 8 p.m. and then next (5 hours later) on Tuesday at 1 a.m.. This time interval scheduling cannot be accomplished with a Cron trigger.
| Anchor | ||||
|---|---|---|---|---|
|
Generating a List of Qualifying Times
The Controller allows you to generate a list of future dates and times that a trigger will trigger the specified task.
Step 1 | Click the 63571356 List Qualifying Times button in the Cron Trigger Details. The List Qualifying Times Input dialog displays. |
|---|---|
Step 2 | Select a Number of Dates/Times (1 - 1000) that you want to list. The default is 30. |
Step 3 | Select a Start Date from when you want the list to begin. |
Step 4 | Click the Submit button to generate the list. For example: |
...