Web services client port information

Use this page to specify a request timeout, override an endpoint, and override a binding namespace for a web services client port.

A web service can have multiple ports. You can view and configure the port attributes for each defined web service port. The web services are listed on the web services client bindings page.

To view this page, click Applications > Application Types > WebSphere enterprise applications application_name > Manage Modules > module_instance > Web services client bindings > Edit .

This administrative console page applies to both Java API for XML-Based Web Services (JAX-WS) and Java API for XML-based RPC (JAX-RPC) web services. The Overridden endpoint URL field is the only field supported for JAX-WS clients. The other fields are not applicable for JAX-WS clients.

Port

Specifies the name of a port.

Request timeout

Specifies the time, in seconds, that a web service client waits for a request to complete on this port. If a timeout is not specified, the default request timeout for the client to wait is 300 seconds. If the value is set at 0 (zero), the timeout used is the default value for the underlying transport mechanism. This field is supported only for JAX-RPC clients.

A typical use for this setting is to customize the client's behavior when it is configured to use a JMS transport to access a web service to make it wait longer for an expected completion. Depending upon network conditions, or the nature of a web service implementation, it might be necessary to tune the timeout.

Overridden endpoint URL

Specifies the name of an endpoint that is used to override the current endpoint. A client invoking a request on this port uses this endpoint instead of the endpoint specified in the WSDL file. This field is supported for both JAX-WS and JAX-RPC clients.

If an assembled application contains a web service client that is statically bound, the client is locked into using the implementation (service end point) identified in the WSDL file used during development. Overriding the endpoint is an alternative to configuring the deployed WSDL attribute.

The overridden endpoint URI attribute is specified on a per port basis. It does not require an alternative WSDL file within the module. The overridden endpoint URI takes precedence over the deployed WSDL attribute. The client uses this value for the service end point URI or SOAP address, instead of the value in the static client bindings.

Avoid trouble Avoid trouble: You can edit this field if you have managed clients or a mixture of both managed and unmanaged clients. You cannot edit the field if you have unmanaged clients only.gotcha

If you do not want a request by an unmanaged JAX-WS client service to be sent to the endpoint URL that is specified in this field, you can specify the com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri Java virtual machine (JVM) system property. For more information about this custom property, read about the Java virtual machine custom properties.

Overridden binding

Specifies the WSDL file binding namespace URI to use with this port, instead of the namespace in the WSDL file. This binding does not need to exist in the WSDL file. A client invoking a request on this port uses this binding instead of the binding specified in the WSDL file. An overridden binding namespace cannot be specified unless an overridden endpoint is specified. This field is supported only for JAX-RPC clients.




Related tasks
Configuring web services client bindings
Related reference
Java virtual machine custom properties
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 5:16:49 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-base-iseries&topic=uwbs_portattribute
File name: uwbs_portattribute.html