Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Service Development | Building Services that Retry
 
Building Services that Retry
 
Requirements for Retrying a Service
Example Service that Throws an Exception for 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.