Job Management - How To

Topics | How To | Support | Related Topics


Viewing Job Information

View the Details of a Job

View the Events of a Job

View the Media of a Job

View the Log Files of an Active Job

View the RMAN Log of an Active Job

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

Change Table Views

Open a Console Window

Controlling Jobs

Kill a Job

Resume a Job

Suspend a Job

Commit a Job

Start a Job in a Suspended State

Suspend, Resume, and Kill Groups of Jobs

Suspend, Resume, and Kill Selected Jobs

Pause and Play Active Jobs in the Job Controller

Disabling Backups for Disabled Clients

Job Filters

Create a Job Filter

Apply a Job Filter

Delete a Job Filter

Job Preemption

Set Job Preemption Control for the CommCell

Specify Preemptibility of Job Types

Restarting Jobs

Specify Job Restartability for the CommCell

Job Alive Check Interval

Set the Job Alive Check Interval

Job Update Interval

Set the Job Update Interval

Job Running Time

Set the Total Running Time for a Job

Job Queuing

Queue Jobs if Other Conflicting Jobs are Active

Queue Jobs if Activity Control is Disabled

Queue Scheduled Jobs

Job Phases

File System iDataAgent

Oracle iDataAgent

Sybase iDataAgent

NAS iDataAgent

SQL Server iDataAgent

Exchange Database iDataAgent

Job States


View the Details of a Job

To view the details of a job:

  1. From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window appears.
  2. Right-click the job and then click Detail from the shortcut menu. The details of the job you selected are displayed.
  3. Click OK.
note.gif (292 bytes) 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:

  1. From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window is displayed.
  2. 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:

  1. From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window appears.
  2. Right-click the job and then select Detail from the shortcut menu.
  3. Click View Media the job details dialog box that is displayed.
  4. Click OK.


View the Log Files of an Active Job

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To view the log files of an active job:

  1. From the Job Controller of the CommCell Console, right-click a job, then click View Logs from the short-cut menu.
  2. 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

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

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

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

Before You Begin

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

  1. From the CommCell Console, click the Job Controller icon (or select Job Controller from the Tools menu). The Job Controller window appears.
  2. From the Job Controller window, click on any of the column headings, and enable the Error Code column from the popup menu.
  3. 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).
note.gif (292 bytes)
  • 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:

  1. From the Job Controller or Event Viewer windows in the CommCell Console, perform either of the following:

    The available options for that window are displayed.

  2. 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:

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

Kill a Job

Required Capability: See Capabilities and Permitted Actions

To kill a job:

  1. From the Job Controller of the CommCell Console, right-click the job to be killed and select Kill from the shortcut menu.
  2. 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

  1. If needed, from the CommCell Console select Job Controler from the Tools menu to open the Job Controller window.
  2. 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

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

Required Capability: See Capabilities and Permitted Actions

  1. If needed, from the CommCell Console select Job Controler from the Tools menu to open the Job Controller window.
  2. Right-click the job you want to suspend and select Suspend from the shortcut menu.

The job status changes to Suspended; however the status may change to Suspend Pending for a few moments while the operation completes.


Commit a Job

Before You Begin

This option is available only for Silo Storage. Review Getting Started - Deduplication to Tape (Silo Storage) before you proceed.

Required Capability: See Capabilities and Permitted Actions

To commit a job:

  1. From the Job Controller of the CommCell Console, right-click the job and select Commit from the shortcut menu.
  2. 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:

  1. From the dialog box of the job for which you wish to start in a suspended state:
  2. 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:

  1. 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.
  2. From the Multi-Job Control Dialog dialog box, select either Suspend, Resume, or Kill.
  3. 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.
  4. If you want to suspend, resume, or kill the data protection operations of a MediaAgent, then select All Jobs On This MediaAgent.
  5. Click OK.

Suspend, Resume, and Kill Selected 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, see Capabilities and Permitted Actions.

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

  1. 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.
  2. From the Multi-Job Control Dialog dialog box, select either Suspend, Resume, or Kill, then select All Jobs.
  3. 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.


Disabling Backups for Disabled Clients

Required Capability: See Capabilities and Permitted Actions

To disable jobs  associated with disabled clients:

  1. In the CommCell Console, click the Control Panel icon, then double-click Job Management.
  2. In the Job Pre-Emption Control pane of the General tab of the Job Management dialog box, select the Do not start backups on disabled client option.
  3. Click OK to save your changes.

Create a Job Filter

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

  1. 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.

  2. From the Filter Operation dialog box, select the button.

  3. From the Filter Definition dialog box:

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:

  1. In the CommCell Console, click the Control Panel icon, then double-click Job Management.
  2. In the Job Pre-Emption Control pane of the General tab of the Job Management dialog box, select any of the following:
  3. 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:

  1. In the CommCell Console, click the Control Panel icon, then double-click Job Management.
  2. In the Job Restarts tab of the Job Management dialog box, select from the Job Type list, then click the Preemptible check box.
  3. Click OK to save your changes.
note.gif (292 bytes) 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:

  1. In the CommCell Console, click the Control Panel icon, then double-click Job Management.
  2. 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.
  3. To change the maximum number of times the Job Manager will try to restart a job, select a number in the Max Restarts box.
  4. 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.
  5. Click OK to save your changes.
note.gif (292 bytes) 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:

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

Set the Job Update Interval

Required Capability: See Capabilities and Permitted Actions

To set the Job Update Interval:

  1. From the CommCell Browser, right-click the CommServe icon, click Control Panel, and then click Job Management.
  2. From the Job Updates tab of the Job Management dialog box,
  3. 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:

  1. From the CommCell Browser, initiate a Data Aging, Data Protection, Data Recovery, Auxiliary Copy, or Disaster Recovery Backup operation.
  2. From the Job Retry tab of the appropriate dialog box, select one or both of the following options:
  3. 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:

  1. From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
  2. From the General tab of the Job Management dialog box, select the Queue jobs if other conflicting jobs are active check box.
  3. Click OK to save your changes.
note.gif (292 bytes)
  • 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:

  1. From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
  2. From the General tab of the Job Management dialog box, select the Queue jobs if activity is disabled check box.
  3. Click OK to save your changes.
note.gif (292 bytes) 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:

  1. From the CommCell Browser, right-click the CommCell icon, click Control Panel, and then click Job Management.
  2. From the General tab of the Job Management dialog box, select the Queue Scheduled Jobs check box.
  3. Click OK to save your changes.
note.gif (292 bytes) 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.

Job Phases

All possible job phases for different iDataAgents are described below.

File System iDataAgent

All possible phases for File System iDataAgent backup and their descriptions are as follows:

Phase

Description

Backup Type

Finish Synthetic Full

This phase is run for the first backup job after synthetic full. Full, Incremental

Index Restore

If the index from full backup is not in index cache directory, this optional phase is run to restore the index. Incremental

Pre Scan

This phase is run to execute Pre Scan operation based on subclient option Pre Scan. Full, Incremental

Scan*

During this phase the backup file list is generated and stored in collect files. Full, Incremental

Post Scan

This phase is run to execute post scan operation based on subclient option Post Scan. Full, Incremental

Pre Backup

This phase is run to execute Pre Backup operation based on subclient option Pre Backup. Full, Incremental

Backup*

The content is actually backed up to media. Full, Incremental

Post Backup

This phase is run to execute Post Backup operation based on subclient option Post Backup. Full, Incremental

Archive Index*

Index Cache for the backup job is backedup to media. Full, Incremental

Import Analytics

SRM analytics are collected if SRM option is selected in subclient options. Full, Incremental

Stubbing

Generates stubs during turbo archiving backup job. Full, Incremental

All possible phases for File System iDataAgent restore and their descriptions are as follows:

Phase

Description

Comments

Pre Restore

This phase is run to execute pre restore operations based upon restore options. Not Applicable

Restore*

The selected content will be restored to the destination client and path.Not Applicable

Cleanup

This phase is run to cleanup restore task entries if the original restore job fails. Not Applicable

Post Restore

This phase is run to execute post restore operations based upon restore options. Not Applicable

* are mandatory phases

Oracle iDataAgent

All possible phases for Oracle iDataAgent backup and their descriptions are as follows:

Phase

Description

Backup Type

Discover

Discover phase is run for Oracle RAC backup to calculate the number of streams available for backup. Oracle RAC agent FULL and Incremental.

Index Restore

Index restore phase is run during incremental job, which is collecting table meta data and the index from previous full is not in index cache directory. Incremental

Pre Backup

This phase is run to execute pre backup command based on subclient option. Full, Incremental

Database Backup*

Rman is executed to backup the database. Full, Incremental

Logs Backup*

Rman is executed to backup the archive logs. Full, Incremental

Post Backup

This phase is run to execute post backup command based on subclient option. Full, Incremental

Archive index

Archives index. Full, Incremental

All possible phases for Oracle iDataAgent restore and their descriptions are as follows:

Phase

Description

Comments

Pre Restore

This phase is run to execute pre restore operations based upon restore options.  

Control Restore*

Rman is executed to restore the control file. If “Control File” is not chosen in restore options, this phase is skipped.

Data Restore*

Rman is executed to restore and recover the data. If “Database” content is not selected or “recovery” options are not selected, this phase is skipped.

Post Restore

This phase is run to execute post restore operations based upon restore options.  

* are mandatory phases

Sybase iDataAgent

All possible phases for Sybase iDataAgent backup and their descriptions are as follows:

Phase

Description

Backup Type

Pre Backup

This phase is run to execute pre backup command based on subclient option. Full, Incremental

Transaction Log Backup*

Rman is executed to backup the archive logs. Incremental/Transaction Logs Backup

Database Backup*

Rman is executed to backup the database. Full

Post Backup

This phase is run to execute post backup command based on subclient option. Full, Incremental

All possible phases for Sybase iDataAgent restore and their descriptions are as follows:

Phase

Description

Comments

Pre Restore

This phase is run to execute pre restore operations based upon restore options.  

Data Restore*

Selected databases will be restored and brought online.  

Post Restore

This phase is run to execute post restore operations based upon restore options.  

* are mandatory phases

NAS iDataAgent

All possible phases for NAS iDataAgent backup and their descriptions are as follows:

Phase

Description

Backup Type

Index Restore

Restores index from previous full for incremental backups if not available in cache directory. Incremental

Create Index*

Initializes Index for the backup job. Full, Incremental

Pre Backup

Runs any defined pre backup script as defined in subclient properties. Full, Incremental

Backup*

Runs the backup. The file server will determine what it needs to backup and will send the NAS Backup process a list of the files it backs up. Full, Incremental

Post Backup

Runs any defined post backup script as defined in subclient properties. Full, Incremental

Archive Index*

Index Cache for the backup job is backed-up to media. Full, Incremental

Import Analytics

SRM analytics are collected if SRM option is selected in subclient options. Full, Incremental

All possible phases for NAS iDataAgent restore and their descriptions are as follows:

Phase

Description

Comments

Pre Restore

Runs and pre-restore script from restore options.  

Restore*

Runs the restore. Restore list is sent to the file server – the file servers requests reads of the data.  

Cleanup

Cleanup is run to free task entries when the restore job fails.  

Post Restore

Runs and post-restore script from restore options.  

* are mandatory phases

SQL Server  iDataAgent

All possible phases for SQL Server iDataAgent backup and their descriptions are as follows:

Phase

Description

Backup Type

Pre Backup

Runs any defined pre backup script as defined in subclient properties. Full, Transaction Logs Backup

Transaction Logs*

Backs up transaction logs. Transaction Logs Backup

Differential Backup*

Backs-up all the changes from previous full backup job. Differential Backup

Database Backup*

Runs the database backup. Full

Post Backup

Runs any defined post backup script as defined in subclient properties. Full, Incremental

All possible phases for SQL Server iDataAgent restore and their descriptions are as follows:

Phase

Description

Comments

Pre Restore

Runs and pre-restore script from restore options.  

Restore

Runs the restore. Restore list is sent to the file server – the file servers requests reads of the data.  

Post Restore

Runs and post-restore script from restore options.  

* are mandatory phases

Exchange Database iDataAgent

All possible phases for Exchange Database iDataAgent backup and their descriptions are as follows:

Phase

Description

Backup Type

Discover

Discovers the databases and nodes available for DAG backups. Full, Incremental

Pre Backup

Runs any defined pre backup script as defined in subclient properties. Full, Incremental

Database Backup*

Runs the backup of database. Full, Incremental

Post Backup

Runs any defined post backup script as defined in subclient properties. Full, Incremental

All possible phases for Exchange Database iDataAgent restore and their descriptions are as follows:

Phase

Description

Comments

Pre Restore

Runs and pre-restore script from restore options.  

Restore*

Runs the restore. Restore list is sent to the file server – the file servers requests reads of the data.  

Post Restore

Runs and post-restore script from restore options.  

* are mandatory phases

Job States

All possible states for a Backup/Restore Job and their descriptions are listed as follows:

Phase

Description

Waiting

A job can be in waiting state for the following reasons:
  1. Waiting for Storage Resources.
  2. Number of jobs have exceeded high water mark limit configuration.

Running*

Job is currently in Progress.

Completed*

Job has successfully run.

Completed With Errors*

Job has completed with PARTIAL SUCCESS. It has encountered one or more errors.

PARTIAL SUCCESS job does not guarantee full recovery of the application.

Running (cannot be verified)

Job is has been started on the client but Job Manager can not verify the job status. The reason could be network connectivity between client and CS or client process is not responding to Job manager requests.

Queued

Job is Queued because of dependent operation/Job is in progress.

Pending

Job has encountered a recoverable error and can be resumed. Check Job Pending reason and associated event messages. User needs to take care of appropriate action based upon Job Pending Reason.

Failed

Job is Failed
  1. It has encountered unrecoverable error.
  2. Exceeded Maximum allowed number of restart attempts.

* are mandatory phases

Back to Top