Bookshelf v7.5: Setting Job Triggers

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

Single-Run Triggers

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

Run Now

This trigger specifies that the job will be run immediately. It will execute only once.

Run Once

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

Recurrent Triggers

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

Table 12. Recurrent Trigger Fields
Field	Description
Begin Date	This specifies the date when the first recurrent interval will be run. 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 selected.
End Date	This field becomes active when the option Has End Date is set. This specifies the date when the last recurrent interval will be run. If no end date is set, the job will run "forever."
Start Time	This specifies the lower bounds of the recurrent interval. The job's first execution for a day will occur 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 will occur 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 will start its execution on the date specified in Begin Date at 11:00 PM and will continue until 2:00 AM on the following day.
Has End Date	If this option is not selected, the job will run in perpetuity. If this option is selected, specify an End Date.
Set Start Time To Now	If this option is selected, 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 will start execution promptly at its Start Time, and will execute 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), it is possible that a long-running job could have overlapping executions. Use this field to set the number of concurrent running instances that will be allowed. To allow any number of concurrent instances, set this value to zero.

Recurrent Trigger Types

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

Table 13. Recurrent Trigger Types
Type	Description
Daily	Triggers of this type allow a job to be run 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	Triggers of this type allow a job to be run on certain 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 will occur. 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	Triggers of this type allow a job to recur on specific days of the month. The Months field specifies which months this job will execute. 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	Triggers of this type allow a job to run on specific occurrences of certain days of the week during given months. The Months field specifies which months this job will execute. The Days of the Week field specifies which days of the week the job will execute 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 will be 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.