Number of Retries On Failures (Environment setting)

Tools that honors the Number of Retries On Failures environment will retry the same worker process a specified number of attempts when there is a failure processing a particular job.

Usage notes

  • Occasionally, failures are encountered when running parallel raster analysis jobs.
  • For example, if the tool is running with a custom Python raster function code, sometimes failures can be caused by third-party Python code, such as memory errors when the worker process is processing a particular section of a image.
  • Having the worker process retry a particular section can recover analysis jobs.

Dialog syntax

  • Number of Retries on Failures—The number of retries to attempt when a worker process fails. The default is 0.

Scripting syntax

arcpy.env.retryOnFailures = retry_on_failures



The number of retries a worker process will attempt when there is failure processing a particular job. The default is 0.

retryOnFailures syntax

Script example

import arcpy

# Set the retry on failure to 3
arcpy.env.retryOnFailures = 3

Related topics