Modify an existing proxy service configuration

Modify the configuration details for a proxy service.

A proxy service has no actual target services and therefore no WSDL that the gateway can use to configure the service invocation. A generic template WSDL file is used to configure the basic parameters for the invocation call, but we can override the default for a given proxy service by supplying our own equivalent template.

For an overview of proxy operation, see JAX-RPC handlers and proxy operation. To modify an existing proxy service configuration, complete the following steps:

Tasks

1. Start the administrative console.

2. In the navigation pane, click Service integration -> Buses -> bus_name -> [Additional Properties] Web service gateway instances -> instance_name -> Proxy Services. A list of proxy services is displayed in a proxy services collection form.

3. Click the name of a proxy service in the list. The current settings for this proxy service are displayed.

4. Modify the general properties. For information about each of these properties, see Proxy services settings.

   • We cannot modify the service name, or the request and reply destination names.

   • The lists of available mediations contain all mediations that are currently deployed to this service integration bus. If we have created a mediation and deployed it to the bus, then it is available for selection in both these lists. If we do not want to use a mediation with this proxy service, select none from either or both selection lists.
   • Bus members are application servers or clusters that are added to this bus. The Request mediation bus member and the Response mediation bus member properties define the bus members to which the corresponding mediation is assigned. If we change the Request mediation or the Response mediation property value to (none), we should also change the corresponding bus member property value to (none). To use a mediation, assign it to a bus member. If we do not do this, the administrative console displays an error message.
   • A generic proxy WSDL file is used to configure the basic parameters for the invocation call (for example which binding to use), but we can override the default by typing the location of our replacement generic WSDL file in the Proxy WSDL override URL field.

5. Under the additional properties section, click Inbound web service enablement to modify the configuration as a web service of the inbound aspect of the proxy service. The proxy service receives and sends web service requests and responses by being configured as an inbound service. For information about configuring an inbound service, see Modifying an existing inbound service configuration.

6. Under the additional properties section, click Outbound Web service enablement to modify the configuration of the outbound aspect of the proxy service. For information about configuring an outbound service, see Modifying an existing outbound service configuration but remember that, for a proxy service, there is no actual outbound service and the outbound service configuration is as defined in the proxy service template WSDL.

7. Save changes to the master configuration.

If the processing completes successfully, the list of proxy services is redisplayed. Otherwise, an error message is displayed.

What to do next

Ensure that all service requesters append an operationMode query string parameter to the address for the proxy service. The value of this parameter is either oneway or requestResponse, and the default is requestResponse. For example:

• For HTTP operation, if the web address of the proxy service is

  http://host_name:port_number/wsgwsoaphttp1/soaphttpengine
  /your_bus/ProxyService/ProxyServiceInboundPort
  

  then requesting clients indicate that they are sending a one-way request using the following URL:

  http://host_name:port_number/wsgwsoaphttp1/soaphttpengine
  /your_bus/ProxyService/ProxyServiceInboundPort?operationMode=oneway
  

• For JMS operation, if the JMS address of the proxy service is

  jms:/queue?destination=jndi_queue&connectionFactory=
  jndi_factory&targetService=your_bus/ProxyService/ProxyServiceInboundPort
  

  then requesting clients indicate that they are sending a one-way request using the following URL:

  jms:/queue?destination=jndi_queue&connectionFactory=
  jndi_factory&targetService=
  your_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway
  

Related:

JAX-RPC handlers and proxy operation

createWSGWProxyService command

deleteWSGWProxyService command

Deleting proxy service configurations

Proxy services [Settings]