Skip to content

Background Jobs Manager

Use Background Jobs Manager to search, review, and manage domain background jobs. This is the main operational page for administrators when a job is stuck, failing, or needs to be re-queued or aborted.

The screen has two parts: Filter and Results.

Typical Workflow

  1. Choose a job type, time period, job state, or instance number.
  2. Search for the affected jobs.
  3. Review the result list and identify jobs in Waiting, Processing, Error, Completed, or Aborted state.
  4. Open a job state button to inspect the full record in Job Details.
  5. Re-queue or abort the job only after confirming the cause.

Filter

Use the filter area to narrow the result set before you make state changes.

Background jobs filter with work type, date, log text, instance number, and state options.

Work Type
Select the type of background job.

Date Start
Choose the time period that should include the job start date.

Log Text Content
Search by text found in the job execution log.

Instance Number
Search by workflow instance number to find the jobs related to one workflow instance.

Show
Filter the list by job state.

Results

The results grid lists the jobs that match the current filters.

Background jobs results list with batch actions and state buttons.

The list includes work type, started at, completed at, duration, number, and state.

Select to perform batch operation
Use the batch actions to change all currently listed jobs:

  • Set all to waiting changes the listed jobs to Waiting so they can be executed again.
  • Set all to aborted changes the listed jobs to Aborted so they will not be executed.

Search
Use the search box to filter inside the listed results.

State Meanings

State Meaning
Waiting The job is queued and pending execution.
Processing The job is currently being executed by an agent.
Error The job failed and needs investigation or retry handling.
Completed The job finished successfully.
Aborted The job was cancelled and will not be executed.

Selecting the coloured state button opens the detail window for that job. The available actions in that window depend on the current state.

State Actions

Action Effect
Waiting Moves the job back to Waiting so it can be executed again.
Aborted Moves the job to Aborted so it will not be executed.