About jobs

A job is a project that is executing or has finished executing.

You can monitor jobs using the Home panel and the Jobs panel. In addition, you can use the Jobs panel to start jobs, view job results, and manage semaphores.

About the Home panel

The Home panel provides information about recent jobs and system messages.

To access the Home panel, in the left menu, click Home.

Screen image of the Active Runs panel

Use the Home panel to view your recent or current jobs. You also use it to view notifications and system messages. Select a menu item to view the following:

About the Jobs panel

Use the Jobs panel to work with running jobs and to view job results.

To access the Jobs panel, in the left menu, click Jobs.

Screen image shows the Completed tab in the Jobs panel

Jobs tabs

With the Jobs tabs, you can view lists of jobs by status: All, Completed, Running, Archived, or Locked.

Click a tab to view jobs by type. Each tab has different options for managing jobs in the list.

All
All running jobs are presented first, sorted by their start times. All completed jobs follow, sorted by their completion times. The check boxes are greyed. You can click any of the links. No special actions are available.
Completed
All completed jobs are presented, sorted by their start times. Running, archived, and locked jobs are not presented. You can purge or lock completed jobs. Select the check boxes for the desired jobs, and then click Purge or Lock. When a completed job is purged, it is moved to Archived if it is not completely deleted.
Running
All running jobs are presented, sorted by their start times. You can cancel one or more running jobs. Select the check boxes for the desired jobs, and then click Cancel.
Archived
All archived jobs are presented, sorted by their start times. An archived job is one for which some information has been deleted, typically from an automatic purge specified in the class definition for the job's class. You can purge archived jobs. Select the check boxes for the desired jobs, and then click Purge.
Locked
All locked jobs are presented, sorted by their start times. You can unlock one or more locked jobs. Select the check boxes for the desired jobs, and then click Unlock.
Note: You cannot delete locked jobs directly. To delete them, first unlock them, go to the Completed tab, and then use Purge.

Jobs list fields

Fields show information for each job.
The list of jobs in any tab is presented by completion time, most recent job first. For each job, the following information is shown in columns:
Tag
The build tag, shown as a link. Click it to see the logs for the job steps.
Projects and Libraries
Shown as a link. Click it to see the project used for the job.
Class
Shown as a link. Click it to see the class definition of the class used for the job.
State
One of Waiting, Running, Completed, Archived, or Locked.
  • The Waiting state means that the job has not been started, either because the Running queue is full or because the job is waiting for a semaphore. The Running queue size is defined by the system setting Run Queue Size.
  • Jobs in the Running queue normally are executing. However, if the Running queue contains multiple jobs for the same project, whether one or more of them is currently executing depends on the Run Limit property in the project. See Changing project properties.
Result
One of Passed, Failed, Failed But Continued, Warning, Stopped, or Canceled.
Date
Before the job starts: The date and time the job was requested.

After the job starts: The date and time the job was started.

Runtime
For running jobs, the current elapsed time. For completed jobs, the total elapsed time.
Owner
The user who started the job.

Filtering and sorting the jobs list

You can filter and sort the jobs list in any tab.
Filtering limits the jobs list to those that match a string you specify. Sorting orders the list by the values in any one column.
  • Filter: You can filter the list of jobs to view only those that contain a specified string. The filter is matched if the string exists in any column.
    • New filter: Type the string in the box, and then click Filter.
    • Existing filter: Click the arrow next to the box, and then select the filter string to use.
  • Sort: You can sort the jobs list by any single column's values. Click the arrows next to the column name. If you click it multiple times, the sort cycles through the following sort orders.
    1. ascending (up arrow is highlighted in the column header)
    2. descending (down arrow is highlighted in the column header)
    3. no filter

Feedback