Activity Retry Settings

BPM application substitution variables can be used to configure system-wide activity retry settings.

Substitution Variable Default Value(1) Description
pe.retryIntervalInSeconds 60 Number of seconds to wait before retrying a failed activity.
pe.retryIntervalIncrementInSeconds 0 Number of seconds by which to increase the retry interval after each retry.
pe.maxNumberOfRetries 5 Maximum number of times to retry a failed activity before placing the affected process instance in either a HALTED, SUSPENDED or FAILED state. (See Configuring Error Handling Behavior for Process Instances .)
(1) The default values shown apply to a new installation of the BPM runtime. Current values are unchanged when the BPM runtime is upgraded.

These activity retry settings affect the following process activities:

  • Service Task (of type Web Service, Database or E-Mail)
  • Send Task (one way)
  • Throw Message Intermediate/End Event (one way)
  • Decision Table task
  • Invoke-Business-Process Send Task

If one of these activities fails, it will automatically retry a number of times according to the activity retry settings. When the maximum number of retries is reached, the activity throws a Java exception. The process instance may continue processing via a catch error event, or enter a SUSPENDED, HALTED or FAILED state, according to the error handling configuration in force. See Configuring Error Handling Behavior for Process Instances for more information.

Note: Global Data service tasks can be affected by these settings if the failure is retriable - for example, when it is due to an unreachable case data database.