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

Creating a new endpoint listener configuration

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

  1. Start the administrative console.
  2. In the navigation pane, click one of the paths shown in the table Paths to this panel.
    Paths to this panel

    Servers > Application servers > [Content Pane] server-name > Endpoint listeners
    Servers > Clusters > [Content Pane] cluster-name > Endpoint listeners

    The endpoint listener collection form is displayed.
  3. Click New. The endpoint listener settings form is displayed.
  4. 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
  5. Click Apply. The general properties for this item are saved, and the additional properties options are made available.
  6. 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.
  7. Click New. The service integration bus connection properties settings form is displayed.
  8. 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.
  9. 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.
You are now ready to configure this endpoint listener for use with one or more secure buses as described in Configuring the SIBWS to work in a secure service integration bus, and to select this endpoint listener for use with a Web service as described in Creating a new inbound service.
Related concepts
Endpoint listeners and inbound ports - entry points to the service integration bus
Related tasks
Configuring JMS resources for the synchronous SOAP over JMS endpoint listener
Modifying an existing endpoint listener configuration
Deleting endpoint listener configurations
Related reference
Endpoint listener configuration details

Task 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\tasks\tjw_epl_new.html

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