Modify the configuration details for a proxy service.
About this task
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 you can override the default for a given
proxy service by supplying your 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:
Procedure
- Start the administrative console.
- In the navigation pane, click bus_nameinstance_name.
A list of proxy services is displayed in a proxy services
collection form.
- Click the name of a proxy service in the list.
The current settings for this proxy service are displayed.
- Modify the general properties. For information about each
of these properties, see Proxy services
settings.
Note:
- You 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 you have
created a mediation and deployed it to the bus, then it is
available for selection in both these lists. If you 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 you change the Request
mediation or the Response mediation property value to (none),
you should also change the corresponding bus member property value
to (none). To use a mediation, assign it to a bus
member. If you 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 you
can override the default by typing the location of your replacement
generic WSDL file in the Proxy WSDL override URL field.
- 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.
- 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.
- Save your changes to the master configuration.
Results
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
by 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
by using the following URL: jms:/queue?destination=jndi_queue&connectionFactory=jndi_factory&targetService=your_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway