This article explains how to customize the content of the SOAP Exception returned to a Web Service Client.
Problem:
When a Container Managed service of Web Service sets a return-code that is superior to the maximum success RETURN-CODE, which indicates to Enterprise Server to Rollback, it can be useful to retrieve to the client consuming the service a detailed information about what occurred. This is the aim of the MFRHSOAP User Exit 8.
Resolution:
This sample attached to this article demonstrates a simple COBOL user exit 8 program for MFRHSOAP, the Web Services request handler for Enterprise Server. MFRHSOAP user exits can be used to manipulate the SOAP request and response messages, the parameters passed to and from the COBOL service program, and other aspects of request processing. For more information, see the Net Express or Server Express 5 documentation. In the current documentation set, information on MFRHSOAP user exits can be found in Micro Focus Server > Configuration and Administration > Reference > User Exits.
The sample user exit 8 allows you to update the content of the Soap Exception returned to the Web Service client. It includes the following files:
|
UserExit8.cbl |
Source for the user exit 8 program. |
|
legacy.cbl |
A simple web service to test the exit. |
|
WSmanageSoapExceptionDetail-app.cbl |
The generated client application for legacy |
|
WSmanageSoapExceptionDetail-proxy.cbl WSmanageSoapExceptionDetail-copy.cpy |
Additional generated sources for the client. |
|
WShelloWorldSoapException.mpr |
Service mapping for the test service. |
|
WShelloWorldSoapException.app |
Net Express 5 project file. |
