IBM Support

SOAP Web Service Endpoint URL Changes Between IWS v1.5 and v2.6

Troubleshooting


Problem

When a SOAP Web Service is deployed to v2.6 of the IBM IWS server, an extra layer is added to the web service endpoint URL in comparison to previous IWS server versions (1.3 and 1.5).

Symptom

When a SOAP Web Service is deployed to v2.6 of the IBM IWS server, an extra layer is added to the web service endpoint URL in comparison to previous IWS server versions (1.3 and 1.5).

Environment

IBM i OS

Resolving The Problem

When a system is upgraded to IBM i 7.1, 7.2, 7.3, or 7.4 , you might need to migrate and deploy your SOAP web services to a new IBM Integrated Web Services (IWS) server version; moving from v1.3 or v1.5 to v2.6. In deploying the web service, the endpoint URL for the SOAP web service changes.

NOTE: The URL change only affect SOAP web services.

Example:

v1.3/v1.5 URL: http://as400:20102/web/services/myService

v2.6 URL: http://as400:20102/web/services/myServiceService/myService

Where myService is the name of the SOAP web service being deployed.

As you can see, the v2.6 URL contains an extra layer in the path. The change in the URL is the result of an upgrade to the underlying application server runtime to use the WebSphere Application Server Liberty product. Unfortunately, the URL change was necessary as part of the upgrade and is working as designed.

Since the SOAP web service endpoint URL has changed, clients will need to redistribute their SOAP web service's WSDL file to their SOAP web service clients and inform the clients of the new HTTP/HTTPS Endpoint URL for the SOAP-based services after upgrading to an IWS v2.6 server.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Document Information

Modified date:
18 March 2020

UID

nas8N1020948