WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

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 pane in the console, click the following path:

Service integration > Buses > [Content Pane] bus_name > [Services] 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 concepts
Target services and gateway services
Related tasks
Creating a new gateway service configuration
Modifying an existing gateway service configuration
Related reference
Creating a new gateway service configuration using the wsadmin tool
Deleting a gateway service configuration using the wsadmin tool
Related information
Administrative console buttons
Administrative console preferences

Configuration tab

Configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime 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

Request mediation bus member

The optional bus member to which the request mediation is assigned.

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

Response mediation bus member

The optional bus member to which the response mediation is assigned.

Required No
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


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/sibuswsgw/WSGWGatewayService_DetailForm.html

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