Before you begin
Before you can configure an endpoint listener for an application
server , you must first install the endpoint
listener application to that server as
described in SIBWS
- Completing the installation.
Why and when to perform this task
An endpoint listener is the point (address) at which incoming
SOAP messages for a Web service are received by a service integration bus.
Each endpoint listener supports a particular binding. The endpoint listeners
that are supplied with WebSphere Application Server support SOAP over HTTP
and SOAP over JMS bindings. For more information, see Endpoint listeners and inbound ports - entry points to the
service integration bus.
To configure an endpoint listener for
an application server and (as part of
the configuration process) connect the endpoint listener to one or more available
service integration buses, complete the following steps:
Steps for this task
- Start the administrative console.
- In the navigation pane, click one of the paths shown in the table Paths to this panel.
Paths to this panel |
server-name
cluster-name
|
The endpoint
listener collection form is displayed.
- Click New. The endpoint
listener settings form is displayed.
- Type the following general properties. If you are configuring an
endpoint listener that is supplied with WebSphere Application Server, the
required values are given in Endpoint
listener configuration details.
- Name
- Type the name by which the endpoint listener is known. This name must
match the name of the endpoint listener application that you have installed.
For example, for SOAP over HTTP endpoint listener 1 the listener application
is soaphttpchannel1.ear and the endpoint listener name is SOAPHTTPChannel1.
- Description
- Type the (optional) description of the endpoint listener.
- URL Root
- Type the address at which external clients access the endpoint listener
endpoint. The URL root is the context root of the endpoint enterprise application,
and provides the root of the Web address that is used to build the endpoint
addresses within WSDL files to direct requesters to this endpoint listener.
For example (for SOAP over HTTP endpoint listener 1):
http://www.yourcompany.com/wsgwsoaphttp1
- WSDL serving HTTP URL root
- Each inbound service is described in a WSDL document. Type the root of
the Web address for the WSDL files of the inbound services that are available
at this endpoint listener. The WSDL serving HTTP URL root is used by the HTTP
and JMS endpoint listeners, and also by UDDI registries, to retrieve the WSDL
for your inbound services. This URL comprises the HTTP address at which external
clients access the machine on which your endpoint listener application is
installed, followed by /sibws/wsdl. For example:
http://www.yourcompany.com/sibws/wsdl
- Click Apply. The general
properties for this item are saved, and the additional properties options
are made available.
- Under the additional properties heading, click Connection
properties. A (currently empty) list of all the
service integration buses that are connected to this endpoint listener is
displayed in a service
integration bus connection properties collection form.
- Click New. The service
integration bus connection properties settings form is displayed.
- Under the general properties heading, choose an available service
integration bus from the selection list. The bus is selected
and the additional properties for the bus are displayed.
Note: Under the additional
properties heading there is a
service properties option.
You use this option to configure the set of custom properties that define
the manner in which the endpoint listener connects to this bus. Included in
this set is property name
com.ibm.websphere.sib.webservices.replyDestination,
which defines the reply
destination name
used by the endpoint listener. Do not modify or remove this property, which
is set automatically when the service integration bus is associated with the
endpoint listener.
- Apply the changes.
If the processing completes successfully, the list of service integration
buses that are connected to this endpoint listener is updated to include the
new bus, and the list of endpoint listeners is updated to include the new
endpoint listener. Otherwise, an error message is displayed.