Integration Server 10.15 | Web Services Developer’s Guide | About Handlers and Handler Services | About Response Handler Services | Response Handler Services and Status Codes
 
Response Handler Services and Status Codes
Each response handler service must return a status code. The status code is an integer from 0–3, indicates the success or failure of the response handler service, and indicates how Integration Server will proceed. The following table describes the meaning of each status code for a response handler service and the action Integration Server takes based on the status code.
Status Code
Description
0
Indicates that the response handler service executed successfully. Integration Server executes the next response handler service in the handler chain.
Consumer Side Behavior
If this is the last handler in the handler chain, Integration Server returns the SOAP response to the web service connector.
Provider Side Behavior
If this is the last handler in the handler chain, Integration Server sends the SOAP response to the web service consumer.
Note:Integration Server executes response handler services in the reverse order in which it executes request handler services.
1
Indicates that the response handler service ended in failure. Integration Server suspends execution of the handler chain.
Consumer Side Behavior
If the response handler executed for a consumer web service descriptor, Integration Server places the following exception in the fault document returned by the web service connector:
[ISS.0088.9431] Handler processing failed on the consumer. responseHandlerService
Provider Side Behavior
If the response handler executed for a provider web service descriptor, Integration Server generates a SOAP fault that contains the following information:
[ISS.0088.9431] Handler processing failed on the provider. responseHandlerService
Integration Server returns a SOAP response containing the SOAP fault to the web service consumer.
2 or 3
Indicates that the response handler service ended in failure. Integration Server suspends execution of the handler chain.
Consumer Side Behavior
If the response handler executed for a consumer web service descriptor, Integration Server places the following exception in the fault document returned by the web service connector:
[ISS.0088.9431] Handler processing failed on the consumer. faultMessage
Where faultMessage is the content of the faultMessage parameter returned by the response handler service.
Provider Side Behavior
If the response handler executed for a provider web service descriptor, Integration Server generates a SOAP fault that contains the following information:
[ISS.0088.9431] Handler processing failed on the provider: faultMessage
Where faultMessage is the content of the faultMessage parameter returned by the response handler service.
Integration Server returns a SOAP response containing the SOAP fault to the web service consumer.
Note:
For a response handler service, status codes 2 and 3 have identical behavior.