Number of Retries on Failures (Environment setting)

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

Tools that honor 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, failures can be caused by third-party Python code, such as memory errors when the worker process is processing a particular section of an image.
  • Having the worker process retry a particular section can recover analysis jobs.

Dialog syntax

  • Number of Retries on Failures—The number of retries that will be attempted when a worker process fails. The default is 0.

Scripting syntax

arcpy.env.retryOnFailures = retry_on_failures

ParameterExplanation

retryOnFailures

The number of times a worker process will be retried 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