Configuring additional HTTP transport properties using the wsadmin command-line tool

You can configure additional HTTP transport properties for Java™ API for XML-based RPC (JAX-RPC) web services with the wsadmin command-line tool.

Before you begin

The WebSphere® Application Server wsadmin tool provides the ability to run scripts. You can use the wsadmin tool to manage a WebSphere Application Server installation, as well as configuration, application deployment, and server runtime operations. The WebSphere Application Server only supports the Jacl and Jython scripting languages. For more information about the wsadmin tool options, review the options for the AdminApp object install, installInteractive, edit, editInteractive, update, and updateInteractive commands information.

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
  • 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.

Configure the additional HTTP properties with the wsadmin tool by following steps provided in this task section:

Procedure

  1. Launch a scripting command.
  2. At the wsadmin command prompt, enter the command syntax.
    You can use install, installInteractive, edit, editInteractive, update, and updateInteractive commands.
  3. If you are configuring the com.ibm.websphere.webservices.http.responseContentEncoding property, use the WebServicesServerCustomProperty command option.
    Tip: This property is for JAX-RPC only, and it will not be used if it is enabled for services based on JAX-WS.
  4. Configure all other properties using the WebServicesClientCustomProperty command option.
  5. Save the configuration changes with the $AdminConfig save command.

Results

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

Example

The following illustrates an example of the Jython script syntax: 
AdminApp.edit ( 'PlantsByWebSphere', '[ -WebServicesClientCustomProperty [[PlantsByWebSphere.war "" 
service/FrontGate_SEIService FrontGate http.proxyHost+http.proxyPort myhost+80]]]') 
AdminConfig.save()  

AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty 
[[AddressBookW2JE.jarAddressBookService AddressBook http.proxyHost+http.proxyPort myhost+80]]]') 
AdminConfig.save()
The following illustrates an example of the Jacl script syntax: 
$AdminApp edit PlantsByWebSphere {  -WebServicesClientCustomProperty {{PlantsByWebSphere.war {}
service/FrontGate_SEIService FrontGate  http.proxyHost+http.proxyPort myhost+80 }}} 
$AdminConfig save

$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty {{AddressBookW2JE.jar 
AddressBookService AddressBook http.proxyHost+http.proxyPort myhost+80}}} 
$AdminConfig save
To convert these examples from edit to install, add .ear to form a file name, and add any extra keywords for deployment, like -usedefaultbindings and -deployejb.