Building Services that Retry
When creating a service, you can construct and configure the service to retry automatically if a transient error occurs during service execution. A transient error is an error that arises from a temporary condition that might be resolved or restored, such as the unavailability of a resource due to network issues or failure to connect to a database. The service might execute successfully if Integration Server waits a short interval of time and then retries the service.
To build a service that retries, you create it so that it catches errors and determines whether an error is transient. When the service determines that an error is transient, have it re-throw the error as an ISRuntimeException. The ISRuntimeException is the signal to
Integration Server to retry the service. For more information about how to construct the service, see
Requirements for Retrying a Service and
Example Service that Throws an Exception
for Retry.
In addition to constructing the service for retry, you also must set retry properties for the service (or the trigger calling the service) so that
Integration Server knows that it is to retry a service when an ISRuntimeException is thrown. When
Integration Server retries the service it re-executes it using the original input. For more information about how to configure a service for retry, see
About Automatic Service Retry and
Configuring Service Retry.