Bookshelf: Setting Scheduler Job Triggers

A job trigger determines when and how often it executes. Use the following fields in the Trigger area of the Add Job or Modify Job dialog box to define the actions a job performs when it executes.

Single-Run Triggers

Use the Trigger Type drop-down list to choose the trigger type. There are two single-run triggers, Run Now and Run Once.

Run Now

This trigger specifies that the job runs immediately. It executes only one time.

Run Once

Jobs of this trigger type execute at the date and time specified in the Begin Date and Start Time fields, which become active when you choose Run Once. An error occurs if the given time is in the past. If the option Set Start Time To Now is checked, this trigger is equivalent to the Run Now trigger.

Recurrent Triggers

All recurrent triggers specify that the job execute over a period of time at given intervals.

Table 13. Recurrent Trigger Fields
Field	Description
Begin Date	This specifies the date when the first recurrent interval runs. The recurrent interval is defined as the time between Start Time and End Time. This field is hidden if the option Set Start Time to Now is checked.
End Date	This field becomes active when the option Has End Date is set. This specifies the date when the last recurrent interval is run. If no end date is set, the job runs "forever."
Start Time	This specifies the lower bounds of the recurrent interval. The job's first execution for a day occurs at the time specified in this value.
End Time	This specifies the upper bounds of the recurrent interval. The job's last execution for a given day occurs at or before the time specified in this value. If this value is less than the Start Time value, the interval spans midnight of the given day. For example, a trigger with a start time of 11:00 PM and an End Time of 2:00 AM starts its execution on the date specified in Begin Date at 11:00 PM and continues until 2:00 AM on the following day.
Has End Date	If this option is not checked, the job runs in perpetuity. If this option is checked, specify an End Date.
Set Start Time To Now	If this option is checked, the Begin Date and Start Time fields are ignored and their values are populated with Siebel Analytics Scheduler's current date and time.
Interval in Minutes	During the recurrent interval, this field specifies the number of minutes between subsequent executions of a job. A job starts execution promptly at its Start Time, and executes again every n minutes, where n is the value of this field.
Maximum Concurrent Instances	If a job executes every n minutes (from the Interval in Minutes field), a long-running job may have overlapping executions. Use this field to set the number of concurrent running instances. For an unlimited number of concurrent instances, set this value to zero.

Recurrent Trigger Types

The fields described in Table 14 are the recurrent triggers available from the Trigger Type drop-down list. Depending on the trigger type you choose, additional options become active. Refer to the examples to see how these additional options can be used.

Table 14. Recurrent Trigger Types
Type	Description
Daily	Runs a job every day or every few days. The Days Interval field specifies the number of days between each subsequent recurrent interval. Examples: To run a job every hour between 8:00 AM and 5:00 PM starting on January 1, 2001 and ending on January 15, 2001, set the Begin Date to 1/1/01, the Start Time to 8:00 AM, and the End Time to 5:00 PM. Set the Has End Date flag, the End Date to 1/15/01, the Interval in Minutes to 60, and the Days Interval to 1. To run a job every five minutes forever, set the Begin Date to the desired date, the Start Time to 12:00 PM, the end time to 11:59 AM, the Interval In Minutes to 5, and the Days Interval to 1.
Weekly	Runs a job on specified days of the week. The Weeks Interval specifies the number of weeks between each execution. The Days of the Week field specifies on which days the execution occurs. Example: To run a job at noon every other week on Mondays, Wednesdays, and Fridays, set the Begin Date to the desired date, the Start Time and End Time to 12:00 PM, the Interval in Minutes to 1, the Weeks Interval to 2, and the Days of the Week to Monday, Wednesday, and Friday.
Monthly by Date	Runs a job on specific days of the month. The Months field specifies in which months this job executes. The Days field specifies which days of those months. If the given day does not exist for a given month, that day is ignored. Examples: To run a job at 5:00 PM on the 1st and 15th of January, February, and March, set the Begin Date to January 1, the Start Time and End Time to 5:00 PM, the Interval in Minutes to 1, the Months to January, February, and March, and the Days to 1 and 15. To run a job at 2:00 AM on every leap day (February 29th), set the Begin Date to January 1, the Start Time and End Time to 2:00 AM, the Interval in Minutes to 1, the Months to February, and the Days to 29.
Monthly by DOW	Runs a job on specific occurrences of specified days of the week during given months. The Months field specifies which months this job executes. The Days of the Week field specifies which days of the week the job executes during those months. The Occurrence field specifies which of those days to execute. The occurrence can be any or all of First, Second, Third, Fourth, and Last. The Last value specifies that either the fourth or fifth occurrence of a given day is used, depending on whether there are four or five occurrences during that month. Examples: To run a job on the first and third Fridays of December every hour between the hours of 4:00 AM and 8:00 PM, set the Begin Date to the desired date, the Start Time to 4:00 AM, the End Time to 8:00 PM, the Interval in Minutes to 60, the Months to December, the Days of the Week to Friday, and the Occurrence to the First and the Third. To run a job at 3:00 AM every time that Daylight Saving Time switches over to Standard Time, set the Begin Date to the desired date, the Start Time and End Time to 3:00 AM, the Months to October, the Days of the Week to Sunday, and the Occurrence to Last.