Activity Retry Settings

System-wide activity retry settings can be configured using BPM properties in the bx.properties file.

BPM Property Default Value Description
retryIntervalInSeconds 60 Number of seconds to wait before retrying a failed activity.
retryIntervalIncrementInSeconds 0 Number of seconds by which to increase the retry interval after each retry.
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.
maxNumberOfInMemoryRetries 0 This is the in-memory instance processing equivalent of maxNumberOfRetries (see above).

For information about the location of the properties files, see BPM Properties Files.

The default values shown in the table 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 Configuration of Error Handling Behavior for Process Instances for more information.

Activity retry settings can also be defined on a per-activity basis in TIBCO Business Studio. Those settings take precedence over system-wide activity retry settings in the event of a conflict. For more information, see Configuration of Per-Activity Retry Settings in TIBCO Business Studio.

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