You are ready to test drive your perfect web service that you just spent the last few minutes constructing in Maximo.  A final comparison is performed on your test message to ensure that the structure of the XML is aligned with your object structure.  You are satisfied with the message and it is placed in SOAPUI or your favorite XML test engine.  The message is sent and the response you receive is:

Internal Error

In this example I am trying to add my labor code using an organization identifier that does not exist in my Maximo system.  The response in no way helps me understand the problem however.

Internal Error?  How “internal” should I look?  Could the message possibly be vaguer?  With a sigh it’s off to the logs in order to find more information.  All the while hoping that the message hasn’t rolled off into a backup log.

Thankfully there is a way to configure WebSphere 8.5.X and newer to display the Maximo error code in the response message.

Log in to the WebSphere Administration Console and navigate to WebSphere Application Servers.  Click on your application server.

On the right side under Server Infrastructure expand Java and Process Management and select Process Definition.


Select Java Virtual Machine.

Select Custom Properties.


Click New and enter the following information.

Name: webservices.unify.faults

Value: false

Click Apply or Ok.  Save and restart the WebSphere Application Server.  Note that all you have to do is navigate to WebSphere application servers and restart the server from there.  You do not have to restart all WebSphere services or the Cell or Node.

After the application server has restarted retry your message in SOAPUI.  You should see a Maximo error code along with a more helpful message.


The property is set to true by default in order to restrict the information that is sent as part of the error code.  Consequently, this is a property that should most likely not be available in a production setting or in an environment with sensitive data that is exposed as a web service.  However, in a development environment this setting can speed up the creation and testing of web services.

This information can also be found in the IBM Upgrade Guide Maximo Products V7.5 to V7.6.

Bob Richardson is a Maximo Analyst and IT expert. He enjoys leading Maximo projects and helping grow the careers of others who pursue a career working with Maximo or in IT. Bob holds degrees in both Computer Science and Wildlife Biology. So if you don’t find him at his desk you can probably find him outside chasing squirrels or trying to coerce bats to move into the bat house he spent an entire weekend building.

Leave a Reply

Your email address will not be published.