Before you can configure an endpoint listener for an application
server or cluster, you must first install the endpoint
listener application to that server or cluster as
described in SIBWS
- Completing the installation.
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 or cluster and (as part of
the configuration process) connect the endpoint listener to one or more available
service integration buses, complete the following steps:
- 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.
- If external clients access the endpoint listener through an HTTP server
or server cluster, using default port 80, then specify the HTTP
server name and no port number. For example (for SOAP over HTTP endpoint listener
1):
http://www.yourcompany.com/wsgwsoaphttp1
However,
if you allow external clients to connect direct to your application server
(for example in a development or test environment) then specify the application
server host name and port number. For example (for SOAP over HTTP endpoint
listener 1):http://yourhost:9045/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 root of the HTTP address
at which external clients access your endpoint listener application, followed
by /sibws/wsdl. For example:
http://www.yourcompany.com/sibws/wsdl
orhttp://yourhost:9045/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.