Trigger

There are six pages in the Trigger Wizard.

Basic Information Page

On the first page of the Trigger Wizard you need to enter the name of the trigger and the location of the job. If the job requires parameters, you will be prompted to enter them here. In the Parameters table, the rows might appear in red or blue. Red parameters indicate a value has been supplied that is no longer required by the job, and it can be safely deleted (it will be ignored anyway). Blue parameters are required for the job and so appropriate values should be entered.

Job Schedule Page

On the Job Schedule page of the Trigger Wizard, you can schedule a job to run once only, daily, weekly, monthly, at regular intervals or controlled by a CRON expression.

For weekly events, you need to choose the day(s) of the week when the job should run. For monthly events, you need to choose the day(s) and month(s) to run the job. You can also choose specific day(s) within each month. For jobs that run daily, weekly or monthly, the job will fire at the same time on the scheduled days.

Trigger Active Period

This page of the wizard lets the user configure the absolute time range in which a trigger can fire. The actual firing time itself is governed by the values entered on the previous page - this page only indicates the earliest and latest times that it could possibly fire.

Note

By default, a trigger becomes active upon completion of the wizard and never stops. Also, when the trigger has completed the job run, it will be set to disabled automatically. If user would like to run the job again, the trigger will need to be enabled and make adjustment in Trigger Active Period.

Time Zone

This page enables you to select the time zone, which can be your current location or a different geographical location, according to where you want the job to be fired. The time zone selection is not limited by your locale. With the correct time zone selected, job firing will be accurate, which follows the rules below:

  • The time should always follow the changes of daylight saving time. Therefore 01:00 is the same whether Summer or Winter.
  • When a time doesn't exist (a gap due to the clocks moving forwards), job firing will choose the first valid time after the gap.
  • When the time exists twice, job firing will choose the first time and ignore the second.

Trigger Calendar

If you need to exclude certain periods from the trigger schedule, such as public holidays, you can mark them on a calendar and point the trigger to the calendar. The trigger will not fire during the period(s) marked in the calendar. The calendar options are discussed in Chapter 4, Calendars.

Misfire Configuration

This page allows the user to override the default job timeouts by setting start/end timeout intervals, and choose the action to be taken when a trigger fails to work the way it was supposed to.

  • Timeout for Start: Set the start timeout value for the job. If the job does not get started within the start timeout value, the trigger will be considered misfired.

  • Timeout after Start: Set the end timeout value for the job. If the job does not complete within the end timeout value, the trigger will be considered misfired.

  • Fire the trigger immediately upon detection: This option enables the trigger to fire soon after the misfire is discovered.

  • Do not fire. Wait until the next scheduled time: This option enables the trigger to fire in the next round.