Configuring additional HTTP transport properties using the JVM custom property panel in the administrative console

You can configure additional HTTP transport properties for Java™ API for XML-Based Web Services (JAX-WS) and Java API for XML-based RPC (JAX-RPC) Web services with the JVM custom properties panel in the administrative console.

About this task

This task is one of three ways that you can configure additional HTTP transport properties for a web service acting as a client to another web service. You can also configure the additional HTTP transport properties in the following ways:

If you want to programmatically configure the properties using the Java API XML-based Remote Procedure Call (JAX-RPC) programming model or the Java API for XML Web Services (JAX-WS) programming model, review the JAX-RPC or JAX-WS specifications.

For a complete list of the supported standards and specifications, see the web services specifications and API documentation.

For more information about the following HTTP properties that you can configure, read about HTTP custom properties for web services applications:
  • com.ibm.websphere.webservices.http.requestContentEncoding
  • com.ibm.websphere.webservices.http.responseContentEncoding
    Tip: This property is for JAX-RPC only, and it will not be used if it is enabled for services based on JAX-WS.
  • com.ibm.websphere.webservices.http.connectionKeepAlive
  • com.ibm.websphere.webservices.http.requestResendEnabled
  • com.ibm.websphere.webservices.http.SocketTimeout
  • com.ibm.ws.webservices.enableHTTPPrefix
  • http.proxyHost
  • http.proxyPort
  • https.proxyHost
  • https.proxyPort
  • http.nonProxyHosts - You can only configure this property as a JVM custom property. This property applies for both HTTP and HTTPS connections.

These additional properties are configured for web services applications that use the HTTP protocol. The properties affect the content encoding of the message in the HTTP request, the HTTP response, the HTTP connection persistence and the behavior of an HTTP request that is resent after a java.net.ConnectException error occurs when there is a read time-out.

Procedure

  1. Open the administrative console.
    1. Click Servers > Application Servers > server > Java and Process Management > Process Definition > Java Virtual Machine > Custom Properties.
  2. Optional: If the property is not listed, create a new property name.
  3. Enter the name and value.
  4. Optional: Accept the redirection of the HTTP request to a different URI in HTTPS.
    A redirection of the HTTP request to a different URI in HTTPS can occur if the transport guarantee of CONFIDENTIAL or INTEGRAL is configured in the application. To accept the redirection, you can do either of the following tasks:
    • Set the com.ibm.ws.webservices.HttpRedirectEnabled Java system property to true.
    • Programmatically set the com.ibm.wsspi.webservices.Constants.HTTP_REDIRECT_ENABLED property to a java.lang.Boolean object in the Stub or Call object before invoking the service. For example, use any of the following java.lang.Boolean values to set the property to true:
      • Boolean.TRUE
      • new Boolean(true)
      • new Boolean("true")

Results

You have configured HTTP transport properties for a web services application.