Running a Job Repeatedly

To run jobs automatically on a regular basis, select simple or calendar recurrence on the Schedule tab:

•

Simple recurrence repeatedly runs the job at a regular interval set in minutes, hours, days, or weeks.

•

Calendar recurrence involves more settings: time of day, days of the week, or days of the month, and months of the year.

In “Simple Recurrence Settings” you can see an example of how to set simple recurrence.

Simple Recurrence Settings

Simple recurrence options are:

•

Repeat every – The interval between jobs, in minutes, hours, days, or weeks.

•

Run a set number of times – Runs the specified number of times.

•

Run until a specified date – Runs until a calendar date is reached. Click the calendar icon, , to select the date.

•

Run indefinitely – Runs at the specified times until you delete the job.

•

Holidays – A holiday calendar specifies a list of days when the scheduled job will not run. To use a holiday calendar, select it from the drop-down list. Only one holiday calendar can be selected at a time. Holiday calendars are configured by an administrator; if no calendars are available in this list, this option has not been configured for your system.

If your server recognizes Daylight Savings Time (DST), jobs scheduled using simple recurrence may seem to occur one hour later (when DST ends) or one hour earlier (when DST begins). If you want jobs to recur at the same time of day and respect DST adjustments, use calendar recurrence.

If you set up a job with simple recurrence to start immediately, the job schedule will change after export/import. This happens because the imported job does not retain the previous run history and therefore starts immediately after successful import. To ensure a recurring schedule does not change after export/import, either use simple recurrence with a specific start time, or set up calendar recurrence.

In “Calendar Recurrence Settings” you'll see an example of calendar recurrence settings.

Calendar Recurrence Settings

Calendar recurrence options are:

•

Months – The months during which the job runs.

•

Every Month

•

Selected Months

•

Times – The time of day in minutes and hours when the job should run. The hours use 24-hour format.

You can also enter multiple minutes or hours, and ranges, separated by commas. For example, entering 0,15,30,45 for the minutes, and 9-17 for the hours, runs the report every 15 minutes from 9:00 a.m. to 5:45 p.m. Enter an asterisk (*) to run the job every minute or every hour.

•

End Date – Calendar recurrence runs until a calendar date is reached. Click to select the date.

•

Holidays – A holiday calendar specifies a list of days when the scheduled report will not run. To use a holiday calendar, select it from the drop-down list. Only one holiday calendar can be selected at a time. Holiday calendars are configured by an administrator; if no calendars are available in this list, this option has not been configured for your system.

Administrators see the chapter on scheduling in the TIBCO JasperReports Server REST API Reference for more information on configuring calendars.