Number of Retries On Failures (Environment setting)

This ArcGIS 3.0 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

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

ParameterExplanation

retryOnFailures

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