Endpoint listeners [Settings]

An endpoint listener receives requests from service requester applications within a specific application server or cluster.

To view this page in the console, click the following path:

Servers -> Server Types -> WebSphere application servers -> server -> Endpoint listeners -> listener_name.

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. Use this panel 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.

The endpoint listeners that we can create with WebSphere Application Server support SOAP over HTTP and SOAP over JMS bindings. Example values for these endpoint listeners are given in Example values for endpoint listener configuration.

Configuration tab

The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted.

General Properties

Name

The name of this endpoint listener.

If we are installing our own endpoint listener application, rather than one supplied with WAS, then this name must match the name given in the endpoint listener application that we have installed (that is, the display name of the endpoint module within the endpoint application EAR file).

Information	Value
Required	No
Data type	String

Description

An optional description of the endpoint listener.

Information	Value
Required	No
Data type	Text area

URL root

The root of the URL that should be used to build the endpoint addresses within WSDL documents to direct requesters to this endpoint listener.

The address at which external clients access the endpoint listener endpoint. 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 we allow external clients to connect direct to the application server (for example because it is a stand-alone server or 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

Information	Value
Required	Yes
Data type	Text

WSDL serving HTTP URL root

WSDL serving HTTP URL root

The root of the web address for the WSDL files of the inbound services 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 we allow external clients to connect direct to the 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

The WSDL serving HTTP URL root is only used internally by other components of WAS (notably the IBM UDDI registry). For all other uses, we access the WSDL file through the endpoint listener endpoint for the inbound service.

Information	Value
Required	Yes
Data type	Text

Additional Properties

Connection Properties

Connection properties define the manner in which an endpoint listener connects to the service integration bus.

The application that handles the requests for this endpoint listener.

createSIBWSEndpointListener command

deleteSIBWSEndpointListener command

connectSIBWSEndpointListener command

disconnectSIBWSEndpointListener command

Administrative console buttons

Administrative console preference settings