Quartz Scheduling Properties


This article is a short list of Quartz Scheduling Properties available for JasperReports Server and categorized by files in jasperserver(-pro)/WEB-INF folder. For a step by step guide to set up scheduling functions, please see Configuring the JasperReports Server Scheduling Function page.


Scheduler disabling

remove init-method="start"

<bean depends-on="reportSchedulingService"
     <property name="scheduler" ref="quartzScheduler" />


Note for WebSphere users: In JasperReports Server 3.7 and higher, a work manager class is used to run scheduled report jobs under WebSphere. The JNDI name of the work manager is configured in the WebSphere version of js.scheduling.properties. Scheduling options in WebSphere should be set via the work manager.

Instance name

Used internally by the scheduler; there is no need to modify this value


ID of current instance

Set to AUTO when JasperReports Server is clustered (that is when there are multiple JasperReports Server instances sharing the same metadata DB).


Clustered mode

Determines whether the scheduler runs in clustered mode. Set to true when JasperReports Server is clustered.


Cluster check-in interval

The interval after which a report job running on a JasperReports Server instance is considered to have failed and a different instance reattempts to run it. Report jobs that take longer than this interval to complete could be executed several times on different instances. Therefore, this value should be larger than the longest running report job.


Misfire threshold

Number of milliseconds beyond the scheduled time after which a job should be skipped. A report job might not be able to run at its scheduled time for several reasons (the server is down, there are too many jobs); if the amount of time specified by the misfire threshold passes then the job is considered misfired and JasperReports Server no longer attempts to run it. The job will run at the following fire time if it's a recurring job.


Schedule job threads per server

Integer number of concurrent threads that run report jobs. On multicore machines, the value can be increased if there are many jobs scheduled to run at the same time.


Schedule report thread priority

The priority of the Java threads that run report jobs. Values are from 1 to 10, with 10 being the highest priority. If the same JasperReports Server instance is used for both UI and scheduled jobs, it makes to use a lower value so that UI threads have precedence over scheduler threads.



Deployment uri

The URI to your JasperReports Server installation


Mail server username

Mail server account user


Mail server password

Mail server account password


Outbound mail protocol



Outbound mail server

Domain of the outbound email server


Outbound mail server port

Port that your outbound server is listening on


Sender email address


See also...