Troubleshooting Completed With One Or More Errors

Backup Restore Error Decision Rules  

Customizing Completed with Errors Condition

You can use error decision rules to control the status of a backup job and prevent the job from completing with errors.

Decision rules can be defined for an agent based on the following criteria:

The available job status you can select from the decision rule allows you to:

(the list below also reflects the job status priority used by the decision rules)

Once created, the agent applies the error decision rules at the end of the backup operation. During this process, the agent traverses the failures.cvf file to match the decision rules based on the priority of the rules. The failures.cvf file includes information of all the backup files that failed along with their associated error code. When a file and its error codes match a rule, the file is marked with the defined status, and the agent continues to traverse the failures.cvf file. However, if a file matches a rule that will mark the job as failed, the backup job ends immediately with the failed status. See the graph on the right to understand the process.

Here are some examples that show when it is useful to define error decision rules:

Example 1

You create a decision rule to ignore any error found in temporary files.

File Pattern: C:\temp\*

System Error Code: All Error Codes

On error mark Job as: Complete

Example 2

You create a decision rule to mark the backup job as failed when an error is found in system data files.

File Pattern: /**/*.dat

System Error Code: 1 - 10

On error mark Job as: Failed

Supported Agents

This feature is supported by the following agents:

Creating Decision Rules

Follow the steps below to add a decision rule for any errors that may occur during a backup operation:

1.
  • From the toolbar in the CommCell Console, click Control Panel.
  • Double-click Job Management.
2.
  • Click the Job Status on Errors tab.
  • From the Group Category pane, select the agent to add the decision rules for.
  • Click Add.
3.
  • By default, in the Add Job Error Decision Rule dialog box, all file patterns are considered for the new decision rule.

    You can define a file pattern by clearing the All File Pattern checkbox and entering a specific file pattern in the User Defined Pattern field.

  • From the System Error Code area:
    • If you want to include all errors, click All Error Codes.
    • If you want to define a specific set of error codes, enter the error code range.
  • Select the job status from the On Error mark Job as drop-down list to update the job if the rule is matched.
    For a SnapProtect backup job, if a decision rule with the "Completed with Errors" status is matched, the job status will be marked as "Complete".
  • Click OK.
4. Click OK.

You can add more error decision rules for the selected agent, or choose a different agent to add new decision rules.

You can also set the priority for the decision rules you created by moving a rule up (higher priority) or down (lower priority) using the arrow buttons.

Common Error Codes

The following table displays common error codes examples for Windows and Solaris computers:

Error Code Value System Error Message
1 Operation not permitted
2 No such file or directory
3 No such process
5 I/O Error
6 No such device or address
13 Permission denied
16 Mount device busy
32 Broken pipe

Please refer to the operating system vendor documentation for a comprehensive list of error codes.

Back to Top