Customizing Completed with Errors Condition - Online Help

Job Management (Job Status on Errors) / Specify Job Error Decision Rules

Use this dialog box to create and enable error decision and threshold rules for an agent to control the status of backup jobs that occur at the CommCell and client computer level.

Group Category

Lists the agents that support error decision and threshold rules. Click an agent for which you want to create decision or threshold rules.

Enable

When selected, the Agent will apply the decision and/or threshold rules at the end of the backup operation. It will also allow the creation of new rules.

Use the following tabs to specify the type of rule that you want to create:

Error Decision

Use this tab to view, create and edit error decision rules. These rules are useful if you want to control the error codes occurring during backup as well as the file path pattern of the data.

The decision rule parameters are displayed in a table:

  • Priority

    Indicates the precedence of the decision rule.

  • File Pattern

    Specifies the path and format of the files.

  • System Error Code

    Specifies the defined error codes.

  • On Error Mark Job as

    Specifies the status to mark the job if the decision rule is matched.

  • Enable

    Select to enable/disable the decision rule.

Add

Click to access the Add Job Error Decision Rule dialog box, which allows you to add a new decision rule for the selected agent.

Delete

Click to delete the selected decision rule.

Edit

Click to edit the selected decision rule from the Add Job Error Decision Rule dialog box.

Moves the selected rule one row up in the error decision rule list to increase its priority.

Moves the selected rule one row down in the error decision rule list to decrease its priority.

Error Threshold

Use this tab to view, create and edit error threshold rules. These rules are useful if you want to control the amount of files that failed to back up.

The threshold rule parameters are displayed in a table:

  • Count

    Indicates the number of failed backup files that will activate this rule.

  • Percentage

    Indicates the percentage of failed backup files that will activate this rule.

  • On Error Mark Job as

    Specifies the status to mark the job if the threshold rule is matched.

  • Rule for

    Indicates that the rule will be activated if any or all rule criteria is matched.

  • Enable

    Select to enable/disable the threshold rule.

Add

Click to access the Add Job Error Threshold Rule dialog box, which allows you to add a new threshold rule for the selected agent.

Delete

Click to delete the selected threshold rule.

Edit

Click to edit the selected threshold rule from the Add Job Error Threshold Rule dialog box.

Add/Edit Job Error Decision Rule

Use this dialog box to add or modify error decision rules for an agent.

Enable

When selected, the Agent will apply the decision rule at the end of the backup operation.

File Pattern

When defining a file pattern, ensure the files to be backed up do not have wildcards specified in their filenames.

  • All File Pattern

    Select this option to include all file patterns.

  • User Defined Pattern

    Clear the All File Pattern option to specify the path and format of the file(s). For example, if you want to define a file pattern for a specific file or directory:

    For Windows, enter *:\**\<name>.

    For Unix, enter /**/<name>

    You can also specify file patterns using wildcards, for example:

    •  DB*.txt, to apply the rules for any text file that starts with DB.
    •  \dir\**, to apply the rules for any under the dir directory.

    • Error decision rules do not support UNC paths.
    • The maximum number of characters for a file pattern allowed by the Windows and Unix File Systems is 1024.

System Error Code

  • All Error Codes

    Select this option to include all error codes for the decision rule.

  • From Value <n> To Value <n>

    Clear the All Error Codes option to specify an error code range e.g., from value 1 to value 10.

On Error Mark Job as

Select the status to update the job if the decision rule is matched.

Add/Edit Job Error Threshold Rule

Use this dialog box to add or modify error threshold rules for an agent.

Enable

When selected, the Agent will apply the threshold rule at the end of the backup operation.

Mark Job as

Select the status to update the job if the threshold rule is matched.

Number of failed files is more than

Specify the number of files that should fail during backup to activate this rule.

Percentage of failed files is more than

Specify the percentage of files that should fail during backup to activate this rule.

Apply threshold when n rules match

Select if the threshold rule should be activated when any or all rule criteria are matched.