Commvault

Job Controller

Quick Links to Topics


The Job Controller is the most effective tool for managing and troubleshooting all active jobs within the CommCell® environment. Regardless of which method is used to initiate a job (schedule, on demand or script), the job appears in the Job Controller.

Use Job Controller Options

The following actions can be performed from the Job Controller:

  • View job details
  • Change job priority
  • Apply job controller filters
  • View events
  • View logs
  • Add a job alert

The Pause/Resume/Kill options are available when right-clicking on an individual job, selecting multiple jobs or by using the Multi-Job Control option.

Work with Job Controller Fields

The Job Controller is completely customizable through the following actions:

  • Move a field – Click and drag the field to the desired location in the Job Controller
  • Resize the field – Click the outer edge of the field and drag to the desired size
  • Sort the field – Click on the field and an arrow on the right side appears. You can sort in order or reverse order for the field
  • Add/remove field – Fields can be added and removed by using the menu arrow in the upper-right corner

Add/Remove Fields

Select Chevron (double-down arrow in the upper-right corner) | choose columns | select desired column
The following fields can be added to the Job Controller:

  • Number of Readers in use – displays the number of streams per job that are being used for the operation. Note that the 'readers in use' field only displays a number during the backup phase.
  • Current throughput – displays the current throughput in gigabytes (GB) per hour.
  • Priority – displays the job priority for the operation.



View Job Details

Right-click job | Details or double-click job

Each job includes information about the job status, data path, and media usage or job errors.




To view job details

1 - Right-click on the job and select Detail or double-click the job.

2 - Details for job can be viewed
including general information, progress, streams and media usage.



Change Job Status – Single Job Control

Right-click job | Select Suspend, Resume, Commit, or Kill

A dialog box appears to confirm the status change of a job and provides an explanation dialog box. You can also view explanations for job status change in the Job Summary report.




To change a job’s status

1 - Right-click on the job.

2 - Jobs can be
suspended, resumed
or killed.

3 - Type an explanation if needed in the Reason field and click Yes to confirm to kill the job.



Change Status – Multi-Job Control

Select multiple jobs using Shift or Ctrl keys | Right-click | Select Suspend, Resume, Commit, or Kill
The status of multiple jobs can be changed by using the Shift or CTRL keys to select multiple jobs, right-clicking and selecting the 'Suspend,' 'Resume,' or 'Kill' option.




To control the job state of multiple jobs

1 - Use Shift or CTRL keys to select multiple job.

2 - Right-click and select Suspend, Resume or Kill.

3 - Type an explanation if needed in the Reason field and click Yes to confirm to kill the job.



Change Job Status for Groups of Jobs

Right-click job | Multi-job control | Select the desired group | Suspend, Resume or Kill




To control multiple job activity

1 - Right-click in the job controller and select Multi-Job Control.

2 - Selection of all jobs or specific jobs.

3 - Jobs can be suspended, resumed or killed.



Filter the Job Controller Window

Right-click in the Job Controller window | Filters

To add a new filter, select the New Filter button. To apply an existing filter, from the Filters drop-down box select the filter.




To apply job filters

1 - Apply an existing filter or ...

2 - …add, delete or edit a filter.

3 - Give a name to the filter rule.

4 - Create one or many rules and add to the list.

5 - Specify if it is required to meet  ALL or ANY of the rules created above.



Modify Job Controller Job Retention Time

From the Tools menu | Click User Preferences applet | Jobs tab
By default, a job remains in the Job Controller for five minutes after it has completed successfully, was killed by administrator or failed. This default setting is modified in the User Preferences settings.




To set job retention for the Job Controller

1 - From the Tools tab, click User Preferences.

2 - Define how long a job will appear in the Job controller after it is completed, failed or killed.



Update Job Update Status

Configuration menu | Click Job Management applet | Job Updates tab


To reduce communication traffic during normal operations, the job status in the Job Controller updates every five minutes. This value is increased or decreased in the Job Management applet in the Control Panel.
Unless required for a specific job type, it is recommended NOT to decrease these values as it could have a negative impact on backup or restore performance.

In certain situations where job status must be closely monitored, the update intervals can be modified. You can customize the status updates for different agents within the CommCell® environment.




To change job updates time

1 - Select Job Management in the Configuration tab.

2 - Update status time for protection and recovery operations can be modified for different agents from the Job Updates tab.


Copyright © 2021 Commvault | All Rights Reserved.