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_name -> 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. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.
General Properties
Name
The name of this endpoint listener.
If we are installing our own endpoint listener application, rather than one supplied with WebSphere Application Server, 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, by 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.myco.com/wsgwsoaphttp1 However, if you 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 that are available at this endpoint listener. This address comprises the root of the HTTP address at which external clients access the endpoint listener application, followed by /sibws.
If external clients access the endpoint listener through an HTTP server or server cluster, typically by using default port 80, then this URL root includes the HTTP server name and no port number. For example:
- http://www.myco.com/sibws
However, if you 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, you 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 handling the requests for this endpoint listener.
Related information:
Reference topic