Job Management - How To

From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window appears.
Right-click the job and then click Detail from the shortcut menu. The details of the job you selected are displayed.
Click OK.

If viewing the details of a job with a pending or failed status, the Reason for Job Delay field will contain an Error Code, which, if clicked, will launch the customer support website displaying troubleshooting article(s) related to the specific issue. Additionally, if cache corruption has been found, the field will also contain the information pertaining to the missing updates or service packs.

View the Events of a Job

To view events of a particular job:

From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window is displayed.
Right-click the job you want to view the events of and select View Events. The All Found Events window is displayed. Use this window to view all of the events associated with this particular job.

View the Media of a Job

Before You Begin

You can only view the media of a data protection operation.

To view the media of a data protection operation:

From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window appears.

Right-click the job and then select Detail from the shortcut menu.

Click View Media the job details dialog box that is displayed.

If the storage policy used by the subclient that you are performing a data protection operation uses magnetic media, then the List of Mount Paths dialog box is displayed.

If the storage policy used by the subclient you are performing the data protection operation uses a tape or optical library, then the Media List is displayed.
Click OK.

View the Log Files of an Active Job

Required Capability: See Capabilities and Permitted Actions

To view the log files of an active job:

From the Job Controller of the CommCell Console, right-click a job, then click View Logs from the short-cut menu.
The contents of the log file related to the selected job are displayed in the Log File for Job n window.

View the RMAN Log of an Active Job

Required Capability: See Capabilities and Permitted Actions

To view the RMan log of an active job: (applies to Oracle backup and restore jobs only)

From the Job Controller of the CommCell Console, right-click a job, then click Detail from the short-cut menu.
From the Job Details dialog box, click View Rman Log.

View Troubleshooting Article(s) Available from the Customer Support Website

Before You Begin

Verify that the proper user name and password credentials have been entered into the System (Advanced) dialog box.

To view the troubleshooting article(s) available from the customer support website:

From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window appears.
From the Job Controller window, click on any of the column headings, and enable the Error Code column from the popup menu.
Click on the code displayed in the Error Code column for a failed job. This will launch the customer support website and display the related troubleshooting article(s).

Error codes may also be obtained from several other windows and dialog boxes, including:
- The Job History windows
- The Job Summary Report
- Events
- Alerts
The Error Code field will only contain a code if a job has not completed successfully.
In the Job History windows and Job Summary Report, you can access troubleshooting articles by simply click on the linked error code.
In the Events and Alerts windows, error codes do not provide direct links to troubleshooting articles. However, you can search the customer support website for related articles by typing the appropriate error code in the search field.

Change Table Views

To change the table views for the Job Controller and Event Viewer:

From the Job Controller or Event Viewer windows in the CommCell Console, perform either of the following:
- Right-click any field within the associated window.
  OR
- Click the Table Menu icon at the upper right hand corner of the associated window.
The available options for that window are displayed.
Select or deselect the parameters you want presented in the respective window.

Open a Console Window

To open the CommCell Browser, Job Controller or Event Viewer window:

From the CommCell Console, select Tools and the desired window.
Alternatively, click the desired icon from the toolbar.

Kill a Job

Required Capability: See Capabilities and Permitted Actions

To kill a job:

From the Job Controller of the CommCell Console, right-click the job to be killed and select Kill from the shortcut menu.
If you are sure you want to kill the job, click Yes when the confirmation prompt appears. The job status may change to Kill Pending for a few moments while the operation completes. Once completed, the job status will change to Killed and it will be removed from the Job Controller window after five minutes.

Resume a Job

Required Capability: See Capabilities and Permitted Actions

To resume a job:

From the Job Controller of the CommCell Console, right-click the job to be resumed and select Resume from the shortcut menu.
As the Job Manager attempts to restart the job, the job status changes to Waiting, Pending, or Running.

Suspend a Job

Before You Begin

If you suspend a preemptible job, allow adequate time for the associated processes to stabilize before resuming the job. Resuming the job before the processes stabilize may start additional processes that could interfere with the job.

Required Capability: See Capabilities and Permitted Actions

To suspend a job:

From the Job Controller of the CommCell Console, right-click the job you want to suspend and select Suspend from the shortcut menu.
The job status may change to Suspend Pending for a few moments while the operation completes. The job status then changes to Suspended.

Commit a Job

Before You Begin

This option is available only for Silo Storage. Review Silo Storage before you proceed.

Required Capability: See Capabilities and Permitted Actions

To commit a job:

From the Job Controller of the CommCell Console, right-click the job and select Commit from the shortcut menu.
The job status may change to Interrupt Pending for a few moments while the operation completes. Once completed, the job status will change to Complete.

Start a Job in a Suspended State

Required Capability: See Capabilities and Permitted Actions

To start a job in a suspended state:

From the dialog box of the job for which you wish to start in a suspended state:
- Click Start Suspended. From the Enter Option dialog box, click the Start job in suspended state check box. Click OK. Click OK or Run to start the job.
- Click the Startup in suspended state check box from the Startup tab of the Advanced Backup/Migration/Archive Options dialog box if you are initiating a data protection operation. Click OK. Click OK from the Backup/Migration/Archive Options dialog box.
- Click the Start job in suspended state check box from the Startup tab of the Advanced Restore Options dialog box if you are initiating a data recovery operation. Click OK from the Restore Options dialog box.
The status of the job is displayed as Suspended in the Job Controller. To resume the job, right-click the job and click Resume.

Suspend, Resume, and Kill Groups of Jobs

Required Capability: When performing an action on multiple jobs in the Job Controller, you must have the correct capability and association for all of the jobs you have selected. If you do not, then you cannot perform a group action on any of these jobs. Make sure you have the correct capability and association before attempting to control groups of jobs in the Job Controller. For more information on capabilities and associations, see Capabilities and Permitted Actions.

To suspend, resume, or kill groups of jobs in the Job Controller:

From the Job Controller of the CommCell Console, right-click a job in the Job Controller, then select Multi-Job Control from the short-cut menu.
From the Multi-Job Control Dialog dialog box, select either Suspend, Resume, or Kill.
If you want to suspend, resume, or kill the jobs of clients/agents, then select All Jobs For This Client. If you want to control only the data protection/data recovery operations of a particular agent of the client, then select Only Jobs for this Agent Type.
If you want to suspend, resume, or kill the data protection operations of a MediaAgent, then select All Jobs On This MediaAgent.
Click OK.

Suspend, Resume, and Kill Selected Jobs

To suspend, resume, or kill selected jobs in the Job Controller:

From the Job Controller of the CommCell Console, highlight and right-click the appropriate jobs, then select Multi-Job Control from the short-cut menu.
From the Multi-Job Control Dialog dialog box, select either Suspend, Resume, or Kill, then select All Jobs.
Click OK.

Pause and Play Active Jobs in the Job Controller

To pause and play active jobs in the Job Controller:

From the Job Controller of the CommCell Console, click the pause or play button in the Job Controller. The pause icon will pause the Job Controller from receiving new job updates. The play icon enables the Job Controller to receive real-time job updates.

Create a Job Filter

To create a job filter for the Job Controller or Scheduled Jobs window:

From the Job Controller window, right-click any of the jobs listed, and select the Filters option.
Note: To create a filter from the Schedule Jobs window of a CommCell Console, select the button, and skip to Step 3.
From the Filter Operation dialog box, select the button.
From the Filter Definition dialog box:
- Type a name for the filter in the Name box.
- Click the checkbox next to the operation(s) to be included in this filter.
- Select the appropriate CommCell entities whose operations are to be included in this filter.
- Click OK.

The filter is created.

Apply a Job Filter

To apply a job filter for the Job Controller or Scheduled Jobs window:

From the Job Controller or from the Scheduled Jobs window of a CommCell Console, select a filter from the Filters drop-down box, and then click Apply. Note that only those operations that were selected as part of the filter will be displayed in the Job Controller or Scheduled Jobs window.

Delete a Job Filter

To delete a job filter:

From the Job Controller or from the Scheduled Jobs window of a CommCell Console, select a filter from the Filters drop-down box, and then click the button. The filter is now deleted.

Set Job Preemption Control for the CommCell

Required Capability: See Capabilities and Permitted Actions

To set job preemption control for the CommCell:

In the CommCell Console, click the Control Panel icon, then double-click Job Management.
In the Job Pre-Emption Control pane of the General tab of the Job Management dialog box, select any of the following:
- Restore Preempts Other Jobs
- Backups Preempts Other Backups
- Backups Preempts Auxiliary Copy
Click OK to save your changes.

Specify Preemptibility of Job Types

Required Capability: See Capabilities and Permitted Actions

To determine if a job should be Preemptible:

In the CommCell Console, click the Control Panel icon, then double-click Job Management.
In the Job Restarts tab of the Job Management dialog box, select from the Job Type list, then click the Preemptible check box.
Click OK to save your changes.

Not all job types are Preemptible.

Specify Job Restartability for the CommCell

Required Capability: See Capabilities and Permitted Actions

To specify job restartability for the CommCell:

In the CommCell Console, click the Control Panel icon, then double-click Job Management.
In the Job Restarts tab of the Job Management dialog box, select a job type from the Job Type list, and then select the Restartable check box.
To change the maximum number of times the Job Manager will try to restart a job, select a number in the Max Restarts box.
To change the time interval between attempts by the Job Manager to restart the job, select a number of minutes in the Restart Interval (Mins) box.
Click OK to save your changes.

Not all job types are restartable.

Set the Job Alive Check Interval

Before You Begin

The Job Alive Check Interval cannot be set to less than 120 seconds.

Required Capability: See Capabilities and Permitted Actions

To change the Job Alive Check Interval:

From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
Select the General tab of the Job Management dialog box.
To set the Job Alive Check Interval, click the up and down arrows, as appropriate, for the Job Alive Check Interval (Mins) box.
Click OK to save your changes.

Set the Job Update Interval

Required Capability: See Capabilities and Permitted Actions

To set the Job Update Interval:

From the CommCell Browser, right-click the CommServe icon, click Control Panel, and then click Job Management.
From the Job Updates tab of the Job Management dialog box,
- In the Protection (Mins) and/or the Recovery (Mins) column, click the integer in the column to change the time.
- In the State update interval for ContinuousDataReplicator and/or the State update interval for Data Classification fields, click the integer in the box to change the time.
Click OK to save your changes.

Set the Total Running Time for a Job

Required Capability: See Capabilities and Permitted Actions

To set the total time a job can run before it is killed:

From the CommCell Browser, initiate a Data Aging, Data Protection, Data Recovery, Auxiliary Copy, or Disaster Recovery Backup operation.
From the Job Retry tab of the appropriate dialog box, select one or both of the following options:
- Select Total Running Time and specify the number of hours and minutes.
- Optionally select Kill running jobs when total running time expires.
Click OK to save your changes.

Queue Jobs if Other Conflicting Jobs are Active

Required Capability: See Capabilities and Permitted Actions

To queue jobs when other conflicting jobs are active in the Job Controller:

From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
From the General tab of the Job Management dialog box, select the Queue jobs if other conflicting jobs are active check box.
Click OK to save your changes.

Jobs that are in conflict with other active jobs will remain in the Job Controller in a Queued state until the conflict is resolved.
On Demand Data Protection jobs will always queue because the directive and content files can change with every run.

Queue Jobs if Activity Control is Disabled

Required Capability: See Capabilities and Permitted Actions

To queue jobs if activity control for the job type(s) is disabled:

From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
From the General tab of the Job Management dialog box, select the Queue jobs if activity is disabled check box.
Click OK to save your changes.

Jobs will remain in the Job Controller in a Queued state until activity control for the job type(s) is enabled.

Queue Scheduled Jobs

Required Capability: See Capabilities and Permitted Actions

To queue scheduled jobs in the Job Controller until their scheduled time:

From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
From the General tab of the Job Management dialog box, select the Queue Scheduled Jobs check box.
Click OK to save your changes.

Jobs scheduled after the Queue Scheduled Jobs option is enabled will be started in the Job Controller with a Queued status at their scheduled time. Such jobs will resume if the Queued Scheduled Jobs option is disabled, or a user manually resumes the job using the Resume option.