Job History - Advanced
- Types of Job History
- Admin Job History
- Backup Job History
- Restore Job History
- Archiving Job History
- Recovery Job History
- Recovery Point Creation History
- Recovery Point Copy Back History
- Viewing Job History
- Viewing Details of a Job
- Viewing the Events of a Job
- Viewing the Logs of a Job
- Viewing the Media for a Job
- Viewing Successfully Backed Up Items for a Job
- Viewing Failed Items for a Job
- Viewing Items That Were Successfully Content Indexed
- Viewing Items That Failed to Content Index
- Viewing Recovered or Restored Items
- Viewing Job Information
- Resubmitting a Job
- Viewing Job History for Backup Copy Jobs
- Additional Job History Options
- Aging Job History Data
- Related Reports
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.
- From the CommCell Browser, right-click the <CommCell> node and click View | Admin Job History.
- 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.
- 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.
- From the CommCell Browser, right-click the <Client> and click View | Admin Job History.
- 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.
- 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 | All backup/content indexing jobs should be included in the history window. |
Full | Jobs associated with full backups/full content indexing only should be included in the history window. |
Synthetic Full | Jobs associated with synthetic full backups only should be included in the history window. |
Incremental | Jobs associated with incremental backups/content index backups only should be included in the history window. |
Transaction Log | Jobs associated with transaction log backups only should be included in the history window. |
Differential | Jobs associated with differential backups only should be included in the history window. |
Automated System Recovery | 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 for an agent:
- From the CommCell Browser, navigate to Client Computers > client.
- Right-click the agent and then click View > Backup History.
The Backup History Filter dialog box appears.
- Click OK.
The Backup Job History window displays the history for the selected agent.
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:
- From the CommCell Browser, navigate to Client Computers | <Client>.
- Right-click the <Agent>and click View | Restore History.
- 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:
- From the CommCell Browser, navigate to Client Computers | <Client>.
- Right-click the <Agent> and click View | Archiving History.
- 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:
- From the CommCell Browser, navigate to Client Computers | <Client>.
- Right-click the <Agent> and click View | Recovery History.
- 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.
- From the CommCell Browser, navigate to Client Computers | <Client>.
- Right-click the Continuous Data Replicator Agent and click View | Recovery Point Creation/ Data Verification History.
- 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.
- From the CommCell Browser, navigate to Client Computers | <Client>.
- Right-click the Continuous Data Replicator Agent and click View | Recovery Point Copyback History.
- 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:
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Select the Specify Time Range check box.
- Select the Time Zone.
- Enter the time range in the Start Time and End Time boxes.
- 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:
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Under Job Status, select the status that you want to see in the job history:
- Completed
- Failed
- Killed
- Click OK.
Viewing Details of a Job
You can view detailed information about a job, for example, 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, and the job status of the job. 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:
- In the CommCell Browser, right-click the appropriate entity and click View > Job History.
The Job History Filter dialog box appears.
- Click OK.
- 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.
- 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:
- In the CommCell Browser, right-click the appropriate entity and click View | Job History.
- Click OK.
- From the Job History window, right-click the job and then click View Events.
- The All Found Events window appears, displaying all events.
- 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):
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Click OK.
- From the Job History window, right-click the job and then click View Logs.
The Log File for Job n window appears displaying the contents of the log file related to the selected job.
- 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):
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Click OK.
- From the Job History window, right-click the job and then click View Media.
The Media Used by Job ID window appears displaying the media used by the selected job.
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 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):
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Click OK.
- 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):
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Click OK.
- From the Job History window, right-click the job and then click View Failed Items.
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:
- From the CommCell Browser, right-click the CommServe icon and click View > Admin Job History.
- From the Admin Job History Filter click Offline Content Indexing under the Job Type.
- Click OK.
- From the Admin Job History window, right-click the job and then click View Content Index > Successful Items.
The Search Successful Items for Job n window appears displaying the items that were successfully content indexed.
- Click Close.
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:
- From the CommCell Browser, right-click the appropriate entity and click View > Job History.
The Job History Filter dialog box appears.
- Select Data Recovery Operations.
- Click OK.
- From the Job History window, right-click the job and then click View Restore Items > All.
The Restore Files window appears displaying the files that were restored.
- Click Close.
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:
Job Information Types | Description |
---|---|
Job ID | A unique number allocated by the Job Manager that identifies the data protection, data recovery, or administration operation. |
Operation | The type of data protection, data recovery, or administration operation being conducted. |
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. |
Destination Client | The destination client to which the recovered data will be stored. |
Agent Type | The agent that is performing the operation. (e.g., Windows 2008 File System). |
Instance/Partition | The instance/partition in the client computer that represents the database that was included in this operation. |
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. |
Job Type | The type of operation that is being conducted on data. |
Backup Type | The type of backup that was conducted: Differential, Full, Incremental or Synthetic. |
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. |
Range of Log Files | For DB2, the minimum and maximum log sequence backed up by the job. |
Failed Folders | The number of folders that were not included in the operation. |
Failed Files | The number of files that were not included in the operation. |
Storage Policy | The storage policy to which the operation is being directed. |
MediaAgent | The MediaAgent to which the operation is being directed. |
Status | The status of the operation. For job status descriptions, see Viewing Job Status. |
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. |
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.) |
Backup Set | The backup set that was protected/recovered during the operation and to which the subclient belongs. |
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. |
Phase | The current phase of the operation. The number of phases varies depending on the operation. |
User Name | The name of the user who initiated the operation. |
Priority | The priority that is assigned to the operation. (For more information, see Job Priorities and Priority Precedence). |
Start/Start Time | The date and time on the CommServe when the operation started. |
End Time | The date and time on the CommServe when the operation was completed. |
Elapsed | The duration of time consumed by the operation. |
Libraries | The libraries that is being used by the operation. |
Drives/Mount Paths | The drives/mount paths that are being used by the operation. For more information about media, see Media Operations. |
Last Update Time | The last time the Job Manager received job updates for the operation. |
Transferred | The amount of data that has been transferred for the operation at the present time. |
Estimated Completion Time | The time that the system estimates for this job to be completed. |
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. |
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. |
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. |
Alert | The name of the job-based alert, if configured for the job. |
Job Initiation | The origin of the operation: the CommCell Console (Interactive), a schedule (Scheduled), or a third party interface (Third Party). |
Maximum Number of Readers | The maximum number of readers that can be used for the operation. |
Automated Content Classification Policy | Name of the Automated Content Classification Policy. |
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. |
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. |
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. |
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. |
Error Code | Error Code for job pending or job failure reason. (See Viewing the Error Codes for a Job for more information.) |
Retained By | The type of retention rules defined for the job, basic or extended. For more information, see Data Aging. |
Description | A brief description of the running job. |
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:
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- Click OK.
- From the Job History window, right-click the job and then click Resubmit Job.
The job Options dialog box appears.
- Optional: To select job options for the job you want to restart, click Advanced, make your selections, and then click OK.
- Click OK to resubmit the job.
You can also resubmit a job from the command line. For instructions, see Command Line Interface - Resubmitting a Job.
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:
- From the CommCell Browser, navigate to Client Computers.
- Right-click the client and click View > Job History.
The Job History Filter dialog box appears.
- In the Job History Filter dialog box, click Advanced.
- In the Data Protection History Advanced Filter dialog box, click the Include Backup Copy Jobs check box and then click OK.
- Click OK.
- 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.
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:
|
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:
|
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:
|
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:
|
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:
|
Print Data | Print option prints the status of all entities in the active window. To print the contents of a window:
|
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:
|
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:
|
Grouping Data | Group By option groups entities together based on the column title selected. To group the contents of a window:
|
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:
- On the ribbon in the CommCell Console, click the Storage tab, and then click Media Management.
- Click the Data Aging tab.
- 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.
- 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:
- From the Reports menu in the CommCell Console, click Summary.
- Select suitable options and click Run.
Job Summary Report appears in your default browser.