Background Jobs

Assignments > Background jobs

The Background Jobs page allows you to monitor the status of all jobs running in the background. Depending on your privileges, you can view all background jobs (or just yours), cancel, hold, or resume jobs, or change the priority of jobs.

For each job, the columns on the Background Jobs page are described in the following table:

Column	Description
Assigned To	The engine on which a job is running, or blank if the job is still in the queue
Completion Date	For a job that has been completed, the date on which it finished running.
Creation Date	The date on which the job was submitted
Creator	The person who submitted the job
Execution Log	Click this link to see a log file showing the details of running the job. If the job is still running, the log is updated dynamically. By default, it is updated every 10 seconds, but you can change this setting on the Tools > Personal Preferences page, under How often to auto refresh pages.
Job ID	Internally assigned number identifying the job
Job Name	Descriptive name of the job
Priority	The priority of the job. By default, all jobs have priority 5. The priority can be any number, where a job with priority 1 has the highest priority, meaning that it will be selected for running before a job with a lower priority.
Status	Current status of the job, one of the following, depending on the view you have chosen: Executing – The job is currently running. Also displays the time elapsed since starting the job. In queue – The job is waiting to run. Also displays the order in which this job will be handled. On Hold – The job has been placed on hold, preventing it from starting until it is resumed. Canceled – A job that was previously submitted has been canceled, removing it from the queue. Completed – A job has finished running, and it ran successfully. Failed – A job encountered an error while running, and was terminated. Waiting to be canceled – A user has canceled a running job, and the system is in the process of shutting down the job.

Viewing Dynamic Updates to the Background Jobs Queue

By default, the Background Jobs queue displays a static snapshot of the jobs in the queue. To view continuous updates, click Turn auto refresh on. this feature allows you to watch the flow of jobs through the system.

By default, this page is updated every ten seconds. You can change the frequency of updates by going to Tools > Personal Preferences and editing the field, How often to auto refresh pages.

Working With Job Views

You can work with views of the Background Jobs queue as described in the following table. Views help you focus on a subset of all background jobs in the system.

Job View	Description
all active jobs	Displays all jobs that are in the queue and capable of running (they are not on hold), or that are running
my active jobs	Displays all jobs that you submitted that are in the queue and capable of running (they are not on hold), or that are running
all completed and canceled jobs	Displays all jobs that have completed or that have been canceled
my completed and canceled jobs	Displays all jobs that you submitted that have completed or that have been canceled
all jobs on hold	Displays all jobs that are on hold
my jobs on hold	Displays all jobs that you submitted that are on hold

Using Filters to View Specific Jobs

The Filtering feature allows you to select a subset of background tasks in the queue so that you can quickly find a job you are searching for. For example, you might want to filter on all jobs with a specific status.

To use this feature:

From the Filter list, select the category to filter on, for example, Status.
In the text box, type the value to filter on, for example, Executing.
Click Apply.