Set Web service client port information with AdminApp

 

About this AdminApp task

Use WebServicesClientBindPortInfo to set bind attributes for Web service client ports, including...

• synchronization timeout
• overridden
• endpoint URL
• transport attributes

A typical usage scenario for this command-line option is to customize the timeout value of the client so that the client waits longer when it is configured to use a JMS transport to access a Web service.

If we have not deployed the EAR file yet, we need to have it ready or already deployed to the appserver.

 

1. Launch a scripting command.

2. Determine whether the EJB JAR version is lower than 2.1 to use the existing listener port instead of using a new activation specification.

   If an activation spec exists, the system ignores the listener port, and instead uses the activation specification.

   The system automatically uses an activation spec when specify the -usedefaultbindings option to deploy an application.

   To deploy an application with an EJB JAR version greater than or equal to 2.1 using the defined listener ports instead of a new activation specification, set...

   com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting

   ...to true in...

   PROFILE_HOME/properties/wsadmin.properties

3. Use install, installInteractive, edit or editInteractive to configure the Web service client port information...

   $AdminApp install app_name {-usedefaultbindings -deployejb -WebServicesClientBindPortInfo {{module_name EJB_name Web_service port timeout basic_authentication_id basic_authentication_password SSL_alias overridden_endpoint overridden_binding_namespace }...}}

   The previous example indicates that the port information of multiple ports can be changed using one WebServicesClientBindPortInfo command, where:

   • app_name is the application name, for example, MultiEjbJar.ear

   • module_name is the module name, for example ejbclientonly.jar

   • EJB_name is the name of the EJB not a Web module, for example, Exchange

   • Web_service is the name of the Web service, for example service/StockQuoteService

   • port is the name of the port, for example StockQuote

   • timeout specifies the number of seconds that the client waits for a response

   • basic_authentication_id is the basic authentication transport ID

   • basic_authentication_password is the basic authentication transport password

   • SSL_alias identifies the SSL alias for the port

   • overridden_endpoint is the name of the endpoint used to override the current endpoint

   • overridden_binding_namespace specifies the WSDL file binding namespace URI to use with the port

4. Save the configuration changes with the $AdminConfig save command:

 

Results

The client port information that is associated with the Web service client port are configured.

 

Example

$AdminApp installInteractive MultiEjbJar.ear {-WebServicesClientBindPortInfo {{ejbclientonly.jar Exchange service/StockQuoteService StockQuote 6000 jsmith js9password level3ssl http://fastball.houston.ibm.com/newURL http://fastball.houston.ibm.com/newBindName}} {ejbclientonly.jar Exchange service/StockQuoteService StockQuote2 9000 {}{}{}{}{}}}

 

What to do next

Now we can finish any other configurations, start or restart the application, and verify expected behavior of the Web service.

 

Related tasks

Web services client bindings
Set Web service client-preferred port mappings with wsadmin

 

Related

Options for AdminApp install, installInteractive, edit, editInteractive, update, and updateInteractive commands