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