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

Modifying an existing endpoint listener configuration

Modify the configuration details for an endpoint listener that has been configured for use with inbound services.

Why and when to perform this task

To list the endpoint listeners, and to view and modify their configuration details, 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

    A list of endpoint listeners is displayed in an endpoint listener collection form.
  3. Click the name of an endpoint listener in the list. The current endpoint listener settings for this endpoint listener are displayed.
  4. Modify 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
    Modify the name by which the endpoint listener is known. This name must match the name given in the endpoint listener application (that is, the display name of the endpoint module within the endpoint application EAR file). For example, for SOAP over HTTP endpoint listener 1 the listener application is soaphttpchannel1.ear and the endpoint listener name is SOAPHTTPChannel1.
    Note: When you change an endpoint listener name, the system looks up all objects that refer to it and updates the name.
    DescriptionDescription
    Modify the (optional) description of the endpoint listener.
    URL root
    Modify the address at which external clients access the endpoint listener endpoint. The URL root is the context root of the endpoint listener 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://your.server.name:9080/wsgwsoaphttp1

    WSDL serving HTTP URL root
    Modify the root of the Web address for the WSDL files of the inbound services that are available at this endpoint listener. This address comprises the root of the HTTP address at which external clients access your endpoint listener application, followed by /sibws.
    If external clients access the endpoint listener through an HTTP server or server cluster, typically using default port 80, then this URL root includes the HTTP server name and no port number. For example:
    http://www.yourcompany.com/sibws
    However, if you allow external clients to connect direct to your application server (for example in a development or test environment) then this URL root includes the application server host name and port number. For example:
    http://your.server.name:9080/sibws
    Note: The WSDL serving HTTP URL root is only used internally by other components of IBM WebSphere Application Server (notably the IBM UDDI registry). For all other uses, you access the WSDL file through the endpoint listener endpoint for the inbound service. To get the location details for a given inbound service WSDL file, publish the WSDL file to a zip file as described in Modifying an existing inbound service configuration, then look up the location within the exported WSDL file.
  5. Under the additional properties heading, click Connection properties. A list of all the service integration buses that are currently connected to this endpoint listener is displayed in a service integration bus connection properties collection form. Add, amend or delete buses in the list of currently-connected buses. To add a new bus, complete the following steps:
    1. Click New. The service integration bus connection properties settings form is displayed.
    2. 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 connection properties for the bus there are Custom properties. These custom properties are name and value pairs that you can use to set internal system configuration properties. In each pair, the name is a property key and the value is a string value. You use custom properties to define the manner in which the endpoint listener connects to this bus. Included in this set is property name com.ibm.ws.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.
  6. Save your changes to the master configuration.

If the processing completes successfully, the list of service integration buses that are connected to this endpoint listener is updated, and the list of endpoint listeners is redisplayed. Otherwise, an error message is displayed.

You are now ready to select this endpoint listener for use with an inbound service as described in Making an internally-hosted service available as a Web service.
Related concepts
Endpoint listeners and inbound ports - entry points to the service integration bus
Related tasks
Deleting endpoint listener configurations
Related reference
Endpoint listener configuration details

Task topic

Terms of Use | Feedback

Last updated: 15 Mar 2007
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\tasks\tjw_epl_config.html

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