WebSphere WebSphere Application Server Express, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Gateway services settings

A gateway service provides the configuration of the web service enablement of a service destination, along with the information that maps to one or more target destinations.

To view this administrative console page, click Service integration > Buses > [Content Pane] bus-name > Web service gateway instances > [Content Pane] instance-name > Gateway Services > [Content Pane] service-name.

When you create a gateway service, you map an existing destination that hosts a target service (either an internal service or an external Web service) to a new Web service that seems to be provided by the gateway. This approach provides the following benefits:
  • The gateway service is made available at a different Web address to the target service, so you can replace or relocate the target service without changing the details for the associated gateway service.
  • You can have more than one target service (that is, more than one implementation of the same logical service) for each gateway service.
  • The gateway service can be made available on a different service integration bus to the target service.
  • The gateway provides a common interface to the services in each set. Your gateway service users need not know where each underlying service is located, or whether the underlying service is being provided internally or sourced externally, or whether there are multiple target services available for a single gateway service.
Because you can have more than one target service, specify a default target service for use if no target has been specified for the requesting client or selected using a mediation.
Related information
Gateway services collection
Administrative console buttons
Administrative console preference settings

Configuration tab

Configuration properties for this object. These property values are preserved even if the run-time environment is stopped then restarted. Changing these property values typically has no effect until the run-time environment is restarted; for example, by stopping then restarting an application server. See the information center task descriptions for information about how to apply configuration changes to the run-time environment.

General properties

Gateway service name

The name of the gateway service.

This name must be unique, and it must obey the following syntax rules:
  • It must not start with "." (a period).
  • It must not start or end with a space.
  • It must not contain any of the following characters: \ / , # $ @ : ; " * ? < > | = + & % '
Required Yes
Data type Text

Description

An optional description of the gateway service.

Required No
Data type Text area

Gateway request destination name

The name of the service destination to be used to process request messages for this gateway service.

Required No
Data type Text

Request mediation

The optional name of the mediation that is run to process messages on the request destination.

You can use a mediation to override the default target service. For example, you can specify that requests from a particular client should always be routed to a particular target service whether or not it is the default target service.
Required No
Data type Selection list

Gateway response destination name

The name of the service destination to be used to process response messages for this gateway service.

Required No
Data type Text

Response mediation

The optional name of the mediation that is run to process messages at the response destination.

Required No
Data type Selection list

Default target service

The default target service to be selected.

You can have more than one target service (that is, more than one implementation of the same logical service) for each gateway service, and use a routing mediation to determine which target service is used in each different situation. If no mediation is defined for a given situation, then the default service is invoked.

Required Yes
Data type Selection list

Additional properties

Target services
A target service is one of a set that may be routed to from a gateway service.
Inbound web service enablement
Configure the enablement of the gateway service as a web service.

Reference topic

Terms of Use | Feedback

Last updated: 2 Aug 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.express.doc\sibuswsgw\WSGWGatewayService_DetailForm.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)