Integration Server 10.3 | Web Services Developer’s Guide | About Handlers and Handler Services | About Fault Handler Services | Fault Handler Services and Status Codes
 
Fault Handler Services and Status Codes
Each fault handler service must return a status code. The status code is an integer from 0–3, indicates the success or failure of the fault handler service, and indicates how Integration Server will proceed. The following table describes the meaning of each status code for a fault handler service and the actions Integration Server takes based on the status code.
Status Code
Description
0
Indicates that the fault handler service executed successfully. Integration Server executes the next handler in the handler chain.
Consumer Side Behavior
If this is the last handler in the handler chain, Integration Server returns the SOAP fault to the web service connector.
Provider Side Behavior
If this is the last handler in the handler chain, Integration Server sends a SOAP response containing the SOAP fault to the web service consumer.
Note:Integration Server executes fault handler services in the reverse order in which it executes request handler services.
1
Indicates that the fault handler service ended in failure. Integration Server suspends execution of the handler chain.
Consumer Side Behavior
If the fault 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. faiultHandlerService
Provider Side Behavior
If the fault 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: faultHandlerService
Integration Server returns a SOAP response containing the SOAP fault to the web service consumer.
2
Indicates that the fault handler service ended in failure. Integration Server suspends execution of the handler chain.
Consumer Side Behavior
If the fault 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 fault handler service.
Provider Side Behavior
If the fault 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
Integration Server returns a SOAP response containing the SOAP fault to the web service consumer
3
Indicates that the fault handler service ended in failure. Integration Server suspends execution of the handler chain.
Consumer Side Behavior
If the fault handler executed for a consumer web service descriptor, Integration Server places the fault reason returned by the fault handler in the fault document returned by the web service connector.
Provider Side Behavior
If the fault handler executed for a provider web service descriptor, Integration Server returns a SOAP response containing the SOAP fault to the web service consumer. The SOAP fault contains the fault reason returned by the fault handler.