Service-location details for web-service deployment

Before you deploy a web service, make sure that you know the details of the deployment.

For application servers that are compliant with Java™ EE

For an application server that is compliant with Java™ EE, the web service is deployed to a web archive (WAR) file, and this URI pattern is used:
http://domain:portNumber/contextRoot/serviceConstant/serviceName
domain:portNumber
The domain value is the IP address of the server to which the project is deployed. The colon (:) and subsequent portNumber value is the port, as determined by the application-server configuration.

When you are using IBM® WebSphere® Application Server, the value is localhost:9080 by default. However, your installation of that product can access a different port. This situation might occur if you previously installed WebSphere® Application Server on the same machine.

To change the domain and port number that are included in the WSDL file generated with a SOAP service, see Setting preferences for service generation.

contextRoot
The context root to which the service is deployed. By default, this value is the project name.
To override the default:
  1. Right-click the project.
  2. Click Properties to display the Properties page.
  3. Click Web project settings and type a new context root.
  4. Click OK.
serviceConstant
One of two values: 
  • For a SOAP service:services
  • For an EGL REST-RPC service:restservices
serviceName
For a SOAP service, serviceName is the value of the name field in the @xml complex property. By default, the value of that field is the name of the Service part, not the name of the alias property.
For a REST service, serviceName is the value of the URI text box on the Web Service Deployment tab of the Deployment Descriptor editor. If that text box is blank, the value is the following concatenation:
  • The package name, with an underscore (_) in place of every period
  • An underscore (_)
  • The service name

For a CICS® server

For a CICS® server, the web service is deployed to the CICS® transaction that is specified in the deployment descriptor.

The default URI is the same as the URI specified for an application server that is compliant withJava™ EE. However, if you specify a value in the CICS URI text box on the Web Service Deployment tab of the Deployment Descriptor editor, the following URI pattern is used, with no space between the first and second components:
http://domain:portNumberURIvalue
domain:portNumber
The domain value is the IP address of the server to which the project is deployed. The colon (:) and subsequent portNumber value is the port, as determined by the CICS® server configuration.

To change the domain and port number that are included in the WSDL file generated with a SOAP service, see Setting preferences for service generation.

URIvalue
The value that you specify in the CICS URI text box on the Web Service Deployment tab of the Deployment Descriptor editor.