SOAP handler return codes
The SOAP handler
handles the following predefined return codes from the tpf_soap_handler_exit
user exit:
- TPF_CONTINUE_DO_NOT_TRANSLATE: Translation was completed by the user exit so processing continues.
- TPF_CONTINUE_DO_TRANSLATE: Translation was not completed by the user exit so the SOAP handler will attempt to translate the SOAP message.
- TPF_TRANS_FAILED_RECEIVER: The tpf_soap_handler_exit user exit determined that an error occurred that was caused by the receiver, which is the z/TPF system. The tpf_soap_build_fault C function is called and a fault message is built and returned to the client.
- TPF_TRANS_FAILED_SENDER: The tpf_soap_handler_exit user exit determined that an error occurred that was created by the sender. The tpf_soap_build_fault C function is called and a fault message is built and returned to the sending client.
The SOAP handler also handles the ErrorReplyNeeded return code, which indicates that the SOAP application encountered an error but did not create the fault message. The SOAP handler calls the tpf_soap_build_fault C function to create the fault message.
When the SOAP handler receives any other return codes from another component, it simply returns to the communications binding.
See the z/TPF C/C++ Language Support User's Guide for more information about return values associated with the tpf_soap_handler and tpf_soap_build_fault C functions.