Loading...

Job History - Advanced

Table of Contents

Types of Job History

View the history for job types from all levels in the CommCell hierarchy.

Admin Job History

Use the Admin Job History option to view the history of administration jobs from the CommCell and the Client levels.

From the CommCell Level

View the job history for all Data Management, Data Recovery and Content Indexing jobs in the CommCell. For a list of the job types available in the Admin Job History Filter dialog box, see Job History - Online Help - Admin Job History Filter.

Use the following steps to view the job history for admin jobs in the CommCell.

  1. From the CommCell Browser, right-click the <CommCell> node and click View | Admin Job History.
  2. From the Job Type section of the Admin Job History Filter dialog box, select:
    • All to view all job types.
    • a specific job type, for example, Data Verification.
  3. Click OK.

    The Admin Job History window displays the history for the selected job type.

From the Client Level

View the job history for install related jobs for a particular client computer. The following are the job types available in the Admin Job History Filter dialog box:

  • Install/Remove Updates
  • Download/Copy Software
  • Install/Upgrade/Remove Software
  • Virtualize Me

Use the following steps to view the job history of all admin jobs for a client computer.

  1. From the CommCell Browser, right-click the <Client> and click View | Admin Job History.
  2. From the Job Type section of the Admin Job History Filter dialog box, select:
    • All to view all job types.
    • a specific job type, for example, Install/Remove Updates.
  3. Click OK.

    The Admin Job History window displays the history for selected job type.

Backup Job History

The Backup Job History allows you to view detailed information about backup jobs and can be viewed from the iDataAgents, Instance/BackupSet and Subclient levels.

You can view the job history of the following types of backup jobs:

Backup Job Types Description
All Specifies that all backup/content indexing jobs should be included in the history window.
Full Specifies that jobs associated with full backups/full content indexing only should be included in the history window.
Synthetic Full Specifies that jobs associated with synthetic full backups only should be included in the history window.
Incremental Specifies that jobs associated with incremental backups/content index backups only should be included in the history window.
Transaction Log Specifies that jobs associated with transaction log backups only should be included in the history window.
Differential Specifies that jobs associated with differential backups only should be included in the history window.
Automated System Recovery Specifies that jobs associated with Automated System Recovery process should be included in the history window.

Use the following steps to view the job history of all backup Jobs of an Agent:

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the <Agent> and then click View | Backup History.
  3. Click OK.

    The Backup Job History window displays the history for selected job type.

Restore Job History

The Restore Job History Filter allows you to view detailed information about restore jobs and can be viewed from the Agent and Instance/BackupSet levels.

You can view the job history of the following types of restore jobs:

Level Restore Job Types
Recovery/Retrieve Specifies that only Recovery/Retrieve operations should be included in the history window.
Stub Recall Specifies that stub recall operations should be included in the history window.

Use the following steps to view the job history of all restore jobs of an Agent:

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the <Agent>and click View | Restore History.
  3. Click OK.

    The Restore Job History window displays the history for selected job type.

Archiving Job History

The Archiving Job History Filter allows you to view detailed information about archive operations for the Archiver Agents and can be viewed from the Agent, ArchiveSet and Subclient levels.

Use the following steps to view the job history of all archived jobs of an Agent:

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the <Agent> and click View | Archiving History.
  3. Click OK.

Recovery Job History

The Recovery Job History allows you to view detailed information about recovery or retrieve operations for Archiver Agents and can be viewed from Agent and ArchiveSet levels.

Use the following steps to view the job history of all recovered jobs of an Agent:

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the <Agent> and click View | Recovery History.
  3. Click OK.

Recovery Point Creation History

The Recovery Point Creation History of Data Verification jobs allows you to view detailed information about the verification jobs. This history can be viewed from the CDR Agent level.

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the Continuous Data Replicator Agent and click View | Recovery Point Creation/ Data Verification History.
  3. Click OK.

Recovery Point Copyback History

The Recovery Point Copyback History allows you to view detailed information about the replication jobs and can be viewed from the CDR Agent level.

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the Continuous Data Replicator Agent and click View | Recovery Point Copyback History.
  3. Click OK.

Viewing Job History

You can view the job history for jobs that have run within a specific time range and also as per their job status. By default, the job history displays all job status. However, you can customize and view the job history for a particular job status or time range.

For Jobs Within a Specific Time Range

Use the following steps to view the job history of jobs performed within a specific time range:

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  3. Select the Specify Time Range check box.
  4. From the Time Zone list, select the backup time zone.
  5. Enter the time range in the Start Time and End Time boxes.
  6. Click OK.

For Specific Job Status

By default, the job history displays all job status. Use the following steps to view a particular job status in the job history of a client:

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. Under Job Status, select the status that you want to see in the job history:
    • Completed
    • Failed
    • Killed
  2. Click OK.

For Specific Jobs

Use this procedure when you want to view the job history of one or more jobs.

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  3. In the Job ID area, select the jobs that you want to view.
    • To view a single job, select Job ID and then type type the job ID in the box.
    • To view a sequential job range, select Job Id Range and then type the first job ID and last job ID in the boxes.
  4. Click OK.

Viewing Details of a Job

You can view detailed information about a job, such as how many files were backed up during a data protection operation, the reason an auxiliary copy job failed to start, the throughput of a backup, the job status of the job, etc. Additional job details as applicable per agent can also be viewed, such as the items that failed or were successfully protected during a data protection operation, items that were restored during a data recovery operation, associated media (of a data protection operation), job events, and the log files of the job.

Use the following steps to view the details of a job:

  1. In the CommCell Browser, right-click the appropriate entity and click View > Job History.

    The Job History Filter dialog box appears.

  2. Click OK.
  3. From the Job History window, right-click the job and then click View Job Details.

    The Job Details dialog box appears, displaying detailed job history.

  4. Click OK.

Viewing the Events of a Job

You can view the events associated with a particular job in the Job History window.

Use the following steps to view the events occurred for a specific job:

  1. In the CommCell Browser, right-click the appropriate entity and click View | Job History.
  2. Click OK.
  3. From the Job History window, right-click the job and then click View Events.
  4. The All Found Events window appears, displaying all events.
  5. Click Close.

Viewing the Logs of a Job

You can view the log files of a job in the Job History window.

Use the following steps to view the log files of a job (from the Job History window of a client, as an example):

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. Click OK.
  2. From the Job History window, right-click the job and then click View Logs.
  3. The Log File for Job n window appears, displaying the contents of the log file related to the selected Job History.
  4. Click Cancel.

Viewing the Media for a Job

You can view the media associated with a specific job in the Job History window.

Use the following steps to view the media associated with a job (from the Job History window of a client, as an example):

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. Click OK.
  2. From the Job History window, right-click the job and then click View Media.
  3. The Log File for Job n window appears, displaying the contents of the log file.

    Click Close.

Viewing Successfully Backed Up Items for a Job

You can view the list of successfully backed up or archived files and messages from the Job History window. In addition you can also perform a restore operation and/or a list media operation on the selected items that were backed up successfully.

Use the following steps to view the list of items that were successfully backed up for a job (from the Job History window of a client, as an example):

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. Click OK.
  2. From the Job History window, right-click the job and then click View Backup Items.

    The Backup File List n window appears, displaying the items that were successfully backed up.

Viewing Failed Items for a Job

You can identify the number of failed operations for a job from the Job History window. These include individual files that may fail the job even though a particular job completed successfully. Some items fail because they are locked by the operating system or application and cannot be opened at the time of the backup operation. This often occurs with certain system-related files and database application files.

Use the following steps to view the list of items that failed to backup for a job (from the Job History window of a client, as an example):

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. Click OK.
  2. From the Job History window, right-click the job and then click View Failed Items.
  3. The Unsuccessful Backup Files window appears, displaying the items that failed to backup.

    Click Close.

Viewing Items That Were Successfully Content Indexed

You can view the status of the content indexing jobs from the Job History window. The Content Indexing history can be viewed from the Agent, Instance, BackupSet and Subclient levels.

Use the following steps to view the list of items that were successfully content indexed during an Offline Content Indexing operation using the eDiscovery Exception Report.

Before You Begin

You must be able to access the Web Console to view the eDiscovery Exception Report. If you are logged in to the CommCell Console as a user with the Compliance Search and Reports Management permissions, you do not have to log in to the Web Console and will be automatically redirected to the eDiscovery Exception Report for the content indexing job.

Procedure

  1. From the CommCell Browser, right-click the CommServe icon and click View > Admin Job History.
  2. From the Admin Job History Filter click Offline Content Indexing under the Job Type.
  3. Click OK.
  4. From the Admin Job History window, right-click the job and then click View Content Index > Successful Items.
  5. If prompted, log in to the Web Console from your Web browser.

    The browser redirects to the eDiscovery Exception Report in the Web Console for the selected content indexing job.

For more information, see eDiscovery Exception Report.

Viewing Items That Failed to Content Index

To view the items that failed to be content indexed for a particular content indexing job, go to the eDiscovery Exception Report in the Web Console and perform a search query using the content indexing job ID filter (cijid). See eDiscovery Exception Report.

Viewing Recovered or Restored Items

When viewing files that are restored in the Restored Files window, each of the files is listed with the restore status level appended at the end of the file path. The possible status levels are:

  • RESTORED

    Successfully restored files will be listed with RESTORED appended to the file path.

  • FAILED

    If files are not restored/recovered due to errors, the file paths will be appended with FAILED.

  • OLDER

    Under some circumstances, the system may not restore/recover certain files because they are older versions of the same files already present in the files system; these files are appended with the word OLDER.

Use the following steps to view the restored items associated with a job:

  1. From the CommCell Browser, right-click the appropriate entity and click View > Job History.

    The Job History Filter dialog box appears.

  1. From the Job History Filter window, select Data Recovery Operations.
  2. Click OK.

  3. From the Job History window, right-click the job and then click View Restore Items | All.
  4. The Restore Files window appears, displaying the files that were restores.

    Click Close.

Viewing SAP Oracle BR Tools Logs

View SAP Oracle Backup BR Tools logs for a job. This option is available at the CommServe, MediaAgent and Client level for SAP Oracle backup jobs.

The SAP Oracle BR Tools log files for backup jobs are zipped and placed in the following directory.

$SAPDATA/logs_<timestamp>/<hostname>/SAPBACKUP_<client_id>_<SAP_INSTANCE_ID>.7z

  1. In the CommCell Browser, right-click the appropriate entity and click View | Job History.
  2. Click OK.
  1. From the Job History window, right-click a SAP Oracle backup job and then click View BR Tools Log.
  2. The Oracle Sap Backup Log dialog box appears, displaying the SAP Oracle backup BR Tools logs.
    • View the log file contents by using the Next and Prev buttons or by entering a number in the on Page box and clicking Go.
  3. Click OK.

Viewing Job Information

Information about a job is continually updated and available in the Job History window. Once a job is finished, detailed information about that job is obtainable using the Job History.

The following job information is displayed, depending on the selected Job History:

Column Name Description
Agent Type The agent that is performing the operation. (e.g., Windows 2008 File System).
Alert The name of the job-based alert, if configured for the job.
Automated Content Classification Policy Name of the Automated Content Classification Policy.
Backup Set The backup set that was protected/recovered during the operation and to which the subclient belongs.
Backup Type The type of backup that was conducted: Differential, Full, Incremental or Synthetic.
Client/Client Computer For data protection operations, the client computer to which the backup set and subclient belong. For data recovery operations, the computer from which the data originated.
Completion Time The log creation time for the last log file of max chain. This time is the client time and not the CommServe time.
Content Indexed Displays Full, Partial, or No to indicate whether content indexing was used for the operation. Operations performed with older releases of the software may display Yes or No.

Note that if a job is displayed as partially content indexed, not all of the data protected in the job was content indexed successfully. Rerun content indexing on this job so that the protected data is fully content indexed.

Delay Reason The description of the reason why the operation may be pending, waiting, or failing.
Description A brief description of the running job.
Destination Client The destination client to which the recovered data will be stored.
Drives/Mount Paths The drives/mount paths that are being used by the operation. For more information about media, see Media Operations.
End Time The date and time on the CommServe when the operation was completed.
Elapsed The duration of time consumed by the operation.
Errors Displays any errors that have occurred during the operation, such as a hardware problem or the job has run outside of an operation window. (See Viewing the Error Codes for a Job for more information.)
Error Code Error Code for job pending or job failure reason. (See Viewing the Error Codes for a Job for more information.)
Estimated Completion Time The time that the system estimates for this job to be completed.
Failed Files The number of files that were not included in the operation.
Failed Folders The number of folders that were not included in the operation.
Index Displays New Index to indicate a new index was created during the operation. If blank, a new index was not created.
Instance/Partition The instance/partition in the client computer that represents the database that was included in this operation.
Job ID A unique number allocated by the Job Manager that identifies the data protection, data recovery, or administration operation.
Job Initiation The origin of the operation: the CommCell Console (Interactive), a schedule (Scheduled), or a third party interface (Third Party).
Job Type The type of operation that is being conducted on data.
Last Update Time The last time the Job Manager received job updates for the operation.
Legal Hold Name The Name specified for the Legal Hold data.
Legal Hold Retention Time The time frame for which the Legal Hold Data will be retained.
Libraries The libraries that is being used by the operation.
Maximum Number of Readers The maximum number of readers that can be used for the operation.
Max Restarts The maximum number of times the job will be restarted after a phase of the job has failed. This is set in the Job Management (Job Restarts) tab.
MediaAgent The MediaAgent to which the operation is being directed.
Number of Readers in Use The number of readers currently in use for the operation.
Number of Objects The total number of objects including successful, failed and skipped.
Operation The type of data protection, data recovery, or administration operation being conducted.
Phase The current phase of the operation. The number of phases varies depending on the operation.
Priority The priority that is assigned to the operation. (For more information, see Job Priorities and Priority Precedence).
Primary Copy Library The library of a primary copy that is being used by the operation.
Progress A status bar indicating its progress. The progress bar is not visible for certain operations (e.g., data aging) or for the initial phases of some data protection operations.

The Job Controller progress bar will not display the progress of SAP for MAXDB backup and restore jobs accurately. This is true because SnapProtect cannot detect data or objects transferred by SAP for MAXDB due to the way SAP for MAXDB transfers these items.

Range of Log Files For DB2, the minimum and maximum log sequence backed up by the job.
Retained By The type of retention rules defined for the job, basic or extended. For more information, see Data Aging.
Restart Interval The amount of time the Job Manager will wait before restarting a job that has gone into a pending state. This is set in the Job Management (Job Restarts) tab.
Size of Application The amount of the application data that has been protected.

If job has completed with multiple attempts, the amount displayed may be larger.

Size of Backup The amount of compressed data that has been protected, which includes all application data and metadata.
Size on Media The total size of data that was transferred to the media (excluding duplicated data).

The amount displayed is the compressed amount (if compression is enabled) includes valid and invalid attempts of the backup jobs.

Start/Start Time The date and time on the CommServe when the operation started.
Status The status of the operation. For job status descriptions, see Job Status Descriptions.
Storage Policy The storage policy to which the operation is being directed.
Subclient The subclient that was protected during the operation. Note that a deleted subclient will have a Unix time stamp appended to its name in cases where another subclient is currently using the same name as the deleted subclient.
Transferred The amount of data that has been transferred for the operation at the present time.
User Name The name of the user who initiated the operation.

Resubmitting a Job

You can resubmit a job from the job history windows. This is useful if a job has failed, and you want to run it again. This removes the need to reconfigure a job with the same options. You can resubmit the same job directly from the Job History window.

Use the following steps to resubmit a job from the Job History window of a client as an example:

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. Click OK.
  2. From the Job History window, right-click the job and then click Resubmit Job.

    The job Options dialog box appears.

  3. Optional: To select job options for the job you want to restart, click Advanced, make your selections, and then click OK.
  4. Click OK to resubmit the job.

You can also resubmit a job from the command line. For instructions, see Resubmitting a Job Using the Command Line Interface.

Viewing Job History for Backup Copy Jobs

The Backup Copy Job History can be viewed from the CommServe, client, Agent, Instance, BackupSet and Subclient levels for all backup jobs. You can view detailed information about backup copy jobs in the Job History window.

The section below provides the steps to view the backup copy job history of a Client:

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the client and click View > Job History.

    The Job History Filter dialog box appears.

  1. In the Job History Filter dialog box, click Advanced.
  2. In the Data Protection History Advanced Filter dialog box, click the Include Backup Copy Jobs check box and then click OK.
  3. Click OK.
  4. From the Job History window, right-click the job and then click View Backup Copy File Listing.

    The Backup Copy File List window appears, displaying detailed job history.

Additional Job History Options

The following table describes the available additional options to further refine and view the Job History.

Option Description
Browse Data Browse provides an easy-to-use convenience to search and restore data. You can open the browse window from job history window of CommCell, Client, Agent, BackupSet or Subclient level. The example below is from the Client level.
  1. From the CommCell Browser, right-click the appropriate entity and click View > Job History.

    The Job History Filter dialog box appears.

  1. From the Job History window, right-click the job and then click Browse and Restore.
  2. Click View Content in the Browse and Restore Options dialog box.

Refer to Browse and Restore Data for more details.

Resize Columns Auto Resize All Columns option Resizes all columns in the selected window to the default size.

To auto resize all columns of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Auto Resize All Columns.

    All the windows will be resized automatically.

Horizontal Scroll Horizontal Scroll option resizes all columns to fit the data displayed in the column's fields.

To resize and view all columns in a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Horizontal Scroll.

    All the windows will be resized automatically to fit the data displayed in all the column's fields.

Choose Columns Choose Columns option provides the facility to select or deselect columns to be viewed in the selected window.

To resize and view all columns in a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Choose Column and select the columns to be displayed.
Save Data

Save option saves the status of all entities in the active window to a file. You can choose to save this information in .XLS format.

To save the contents of a window to a file:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Click Save.

    The Save dialog box is displayed.

  3. Navigate to the folder to which you wish to save the file.
  4. Choose a name and format for the file (if you do not wish to use the default name and format).
  5. Click OK.
Email Data

Email option provides the facility to create a new email message and select a file format in which the component will be attached to the message (.PDF or XLS format).

To email the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Email.
  3. Enter one or more email addresses to send the contents of the window to in the SMTP Parameters dialog box.
  4. Modify the SMTP settings, if necessary.
  5. Click OK.
Print Data

Print option prints the status of all entities in the active window.

To print the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Print.

    A dialog box with the available printers will appear.

  3. Edit the printing options as necessary.
  4. Click OK.
Find Data

Find option provides space at the bottom of the window in which you can type the entity you wish to find.

To find an entity in a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

  2. Select Find.

    A space to enter the entity you wish to find appears at the bottom of the associated window.

  3. Type the entity you wish to find in the space provided.

    If the entity exists in the associated window, it will be highlighted.

Filtering Data

Filter option provides the facility to narrow information in the active window down to a specific entity.

To filter the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

    The Filter option is displayed at the bottom of the menu.

  2. Select Filter.

    An arrow will appear in the upper right hand corner of each field in the associated window.

  3. Click on the arrow for the field containing the entities you wish to filter.

    A pull-down menu with all available entities in the associated field is displayed.

  4. Select the entity by which you wish to filter the window from the menu of available entities.

    The window is filtered by the entity selected.

Grouping Data Group By option groups entities together based on the column title selected.

To group the contents of a window:

  1. From the CommCell Console, click the Table Menu icon at the upper right hand corner of the associated window.

    The Group By option is displayed at the bottom of the menu.

  2. Select Group By and select the fields to group entities together.

    The window is grouped according to the entity selected.

Aging Job History Data

Job history data is aged according to the following criteria:

  • The job type
  • The status of the job
  • The retention rules of the corresponding storage policy copy retention criteria

The following table illustrates how job history data is aged.

Job Type Job Status When It Is Aged
All Jobs Any When the job's storage policy or storage policy copy is deleted
Data Protection Job History/Disaster Recovery Backup Job History Successful With its associated data, which is aged based on the associated storage policy copy's defined retention rules
Failed/Killed 90 Days
Data Recovery Job History (including CDR Recovery operations) Any 90 Days
Administration Job History Any 90 Days

You can change the default retention times for job history data as follows:

  1. On the ribbon in the CommCell Console, click the Storage tab, and then click Media Management.
  2. Click the Data Aging tab.
  3. Choose one of these parameters and click the Value field to change the default retention time:
    • Days to keep the successful Backup Job Histories: Records are retained 7 days.
    • Days to keep the archiver restore job histories: This setting is applicable for Exchange Compliance Archiver. All other archive restore jobs will be aged based on the Days to keep the successful backup job histories parameter. Records are retained for 0 days.

      When the value is set to 0, the retention is set to infinite and not zero days.

    • Days to keep the failed/killed backup job and other job histories: Records are retained for 90 days. Applies to auxiliary copy jobs, stub recall jobs, failed jobs, killed jobs, jobs that failed to start, and non-archive restore jobs.
    • Days to keep Data Management and Collection Job Histories: Records are retained for 90 days.
    • Days to keep job options for a completed job: Records the job options information such as job resource history, job failure reasons and so on for 30 days.
    • Days to keep Replication Backup Job Histories: Records are retained 90 days.
  4. Click OK.

Related Reports

Job Summary Report

The Job Summary Report displays all data management, data recovery, and administrative jobs that ran in the CommCell during a specified period of time. The report also includes information about all media options. Please refer Job Summary Report for details.

Use the following steps to generate Job Summary Reports:

  1. From the Reports menu in the CommCell Console, click Summary.
  2. Select suitable options and click Run.

Job Summary Report appears in your default browser.