Skip to main content

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.

Note: Please reference the attached Word document for specific instructions.

Old KB# 14633

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.

Note: Please reference the attached Word document for specific instructions.

Old KB# 14633

Cannot download example .zip


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.

Note: Please reference the attached Word document for specific instructions.

Old KB# 14633

Yes, the link appears to be broken. I've seen a number of problems like this. I'll try to see if I can get someone to fix it.


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.

Note: Please reference the attached Word document for specific instructions.

Old KB# 14633

The attachments have been fixed. Thanks to Kim Groneman and Dawn Eden for helping get this resolved.