Viewing the List of Scheduled Jobs

This documentation is an older version of JasperReports Server User Guide. View the latest documentation.

Scheduled jobs appear in the repository with a icon beside the report name. To view the list of scheduled jobs for a report, locate a report in the repository, click on the icon or right-click the report, and select Schedule from the context menu. The Scheduled Jobs page appears for the report.

The Scheduled Jobs Page for a Report

Typical users see only the jobs they have defined; administrators see the jobs defined by all users. In “The Scheduled Jobs Page for a Report”, jasperadmin has scheduled two jobs for the Product Results by Store Type report.

The Scheduled Jobs page shows the internal ID number of the job, the user (owner) who created the job, and the state of the job. Job states are:

•

NORMAL – The job is scheduled.

•

EXECUTING – The server is generating the report output.

•

COMPLETE – The server has finished running the job and placed output to the repository.

•

PAUSED– The job has been disabled. Click Enabled to resume the schedule.

•

ERROR – The scheduler encountered an error while scheduling or triggering the job. This doesn’t include cases where the job is successfully triggered, but an error occurs while it runs.

•

UNKNOWN – The scheduler encountered an error with the job trigger.

The Scheduled Jobs page includes these controls:

•

Enabled checkbox – When checked, the job will run at the scheduled times. When unchecked, the job is paused.

•

When the server receives a request to delete a job that is running, the server completes running the job before deleting it.

Buttons on the Scheduled Jobs page include:

Button	Description
Back	Returns to the list of reports.
Schedule Job	Opens the Schedule tab to define a new job.
Run Now	Opens the scheduler and allows you to run the job immediately. See Running a Job in the Background.
Refresh List	Refreshes the list of jobs, for example to see if a job has finished running.

Changing Schedules

If the start date for a schedule has not yet passed, you can edit the schedule. Once the start date for a schedule has passed, create a new schedule rather than changing the start date.

To edit a schedule:

Open the Scheduled Jobs page for the report, as described in Creating a Schedule.

Click

Make the changes on the Schedule, Parameters, Output, and Notifications pages.

Click Save. The update occurs immediately.

Pausing a Job

To stop a job from running without deleting it, disable the job.

To pause a scheduled job:

Open the Scheduled Jobs page for the report, as described in Creating a Schedule.

In the row of the job you want to stop, make sure Enabled is unchecked.

To resume a paused job:

Open the Scheduled Jobs page for the report, as described in Creating a Schedule.

In the row of the job you want to resume, make sure Enabled is checked. When a stopped job is re-enabled, it waits until the next scheduled time to run.