Creating a custom error-handling rule

You can create custom rules to set retry options and final job disposition for failed or canceled jobs.

To create a custom error-handling rule or to edit error-handling rules

  1. Do one of the following:

    • On the Tools menu, click Error-Handling Rules.

    • Right-click a failed or canceled job in the Job History pane in the Job Monitor view. Click Properties, and then click Error-Handling. Go to step 4.

  2. Select the appropriate options as described in the following:

    Name

    The name of the error-handling rule.

    Type

    • Default: Predefined default error-handling rules for a category of errors. You cannot delete default rules and you cannot modify default rules to include specific error codes in a category.

    • Custom: Error-handling rules that you can create for a specific error code or codes in an error category.

    If both a custom error-handling rule and a default error-handling rule apply to a failed job, the settings in the custom rule are applied to the job.

    Job Status

    The status of the job that will activate this rule. Statuses are:

    • Error

    • Canceled

    • Failed

    Error Category

    The category of error codes that this rule applies to.

    Enabled

    • Yes: This rule is enabled. Retry options and final job disposition will be applied to jobs that failed with the error codes selected for this rule.

    • No: This rule is disabled.

  3. Do one of the following:

    • To create a new, custom error-handling rule for a specific job error, click New. Continue with step 4.

    • To delete a custom error-handling rule, select the rule, and then click Delete.

    • To update a default or custom error-handling rule, select a rule, and then click Edit. Continue with step 4.

  4. Complete the items in the Error-Handling Rule Settings dialog box as follows, and then click OK:

    Name

    Enter a new name or change the name for the error-handling rule. To add or update a custom error-handling rule, you must enter a rule name.

    Final Job Status

    The status for the job that will activate the rule. The job status can be viewed, but not modified. Statuses are:

    • Error

    • Canceled

    • Failed

    Error Category

    The category of error for which the rule will be applied.

    If you are editing a default or custom error-handling rule, the error category can be viewed, but not modified.

    If you are creating a custom error-handling rule, you must select an error category that contains the errors to apply this rule to.

    Available error categories include the following:

    • Other

    • Network

    • Server

    • Resource

    • Security

    • Backup Device

    • Backup Media

    • Job

    • System

    • Dispatch

    Enabled

    Select this check box to enable the error-handling rule, or clear the check box to disable the rule. This check box must be selected before you can set the retry options and the final job disposition options.

    Available errors

    Error codes that are not associated with a custom error-handling rule. This field will not be displayed if you are editing a default error-handling rule.

    If you are creating or editing a custom error-handling rule, you must select the check box of the error code that you want this rule to apply to. You can select up to 28 error codes.

    To change the list of available errors, select a different error category.

    Retry job

    Select this check box to allow Backup Exec to retry the job.

    Maximum retries

    Enter the number of times you want the job retried. The maximum number of times the job can be retried is 99.

    Retry interval

    Enter the number of minutes to wait before the job is retried. The maximum number of minutes is 1440.

    Place job on hold until error condition has been manually cleared

    Select this option to place the job on hold until you can manually clear the error. After you clear the error, you must remove the hold for the job.

    Reschedule for its next scheduled service

    Select this option to run the job at the next scheduled occurrence.

    Notes

    Enter any miscellaneous information for the error-handling rule.

More Information

Error-handling rules

Custom error-handling rule for recovered jobs

Cluster failover error-handling rule