Error Causes

Description

The Error Causes properties allows you to modify how this step should behave upon the occurrence of an error. The default behavior is to monitor for the occurrence of all errors, however, these properties can be set in order for this step to ignore certain errors or only react to specific errors. It also allows you to set the length of time this step should be permitted to execute before causing a time out error. If any Error Causes conditions are met during task execution, the procedures set under the On Error properties are carried out.

Practical Usage

Can be used to ignore non-critical errors to allow task execution to proceed without interruption. Can also be used to set a time out value for time-sensitive steps.

NOTE: All On Error properties are optional entries.  

Parameters

Property
Type
Default
Markup
Description

The following problems should cause this step to error

Text

All Problems

AM_ERRORS="18999,18998,20008"

Allows you to select / de-select specific errors that will cause this step to fail.

The available options are:

  • All Problems (Default) - Any problem encountered during execution of this step will cause the instructions specified in the On Error properties to be carried out.

  • Selected Problems - Only the selected errors will cause the instructions specified in the On Error properties to be carried out. Non-selected errors are ignored.

  • All except Selected - All non-selected errors will cause the instructions specified in the On Error properties to be carried out. Selected errors are ignored.

Custom problem codes

Text

(Empty)

AM_ERRORS="18999,18998,20008"

Allows a custom error code to be entered in case it does not appear in the list of errors. This parameter will adhere to the specifications set under the parameter labeled The following problems should cause this step to error. Variables can be used in this parameter.

NOTE: Use AMError to determine specific information about an error.

Timeout and error after this period of time

Number

(Empty)

AM_TIMEOUT="20" AM_TIMEOUTSCALE="seconds"

Allows you to set the total amount of time this step should be allowed to execute before generating a timeout error. For example, a SQL Query step is set to time out after 30 seconds. If the query took longer than 30 seconds to complete, the step would generate a time out error and the instructions set in the On Error properties would be carried out. This parameter is disabled by default.

See Also

Error Handling Overview

Setting Global Error Handling

Automate Event Log