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

Endpoint listener configuration details

This topic gives the configuration details for every endpoint listener that is supplied with WebSphere Application Server.

When you create or modify an endpoint listener configuration, you provide the following configuration details:
Endpoint listener name
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.
Endpoint listener URL root
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.
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. 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
This topic specifies these configuration details (endpoint listener name, endpoint listener URL root and WSDL serving HTTP URL root) for the following endpoint listeners:

SOAP over HTTP endpoint listener 1

Endpoint listener name
SOAPHTTPChannel1.
Endpoint listener URL root
The address at which external clients access the machine on which your endpoint listener application is installed, followed by the endpoint listener endpoint name. For example (for this endpoint listener):
http://www.yourcompany.com/wsgwsoaphttp1
WSDL serving HTTP URL root
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

SOAP over HTTP endpoint listener 2

Endpoint listener name
SOAPHTTPChannel2.
Endpoint listener URL root
The address at which external clients access the machine on which your endpoint listener application is installed, followed by the endpoint listener endpoint name. For example (for this endpoint listener):
http://www.yourcompany.com/wsgwsoaphttp2
WSDL serving HTTP URL root
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

Synchronous SOAP over Java Message Service (JMS) endpoint listener 1

Endpoint listener name
SOAPJMSChannel1.
Endpoint listener URL root

You specify the properties of the synchronous SOAP over JMS endpoint listener 1 endpoint by using the following syntax:

jms:/queue_or_topic_indicator?property_name=property_value and so on, separating each property using the "&" character.

For example, if you use the default values for queue destination and queue connection factory when you install the synchronous SOAP over JMS endpoint listeners, then the first part of the end point address is:
jms:/queue?destination=jms/SOAPJMSQueue1&connectionFactory=jms/SOAPJMSFactory1
For each of the synchronous SOAP over JMS endpoint listeners, here is the full list of properties that you can specify in the endpoint address:
Property name Property description
Destination-related Properties (required)  
connectionFactory The JNDI name of the queue or topic connection factory.
destination The JNDI name of the destination queue or topic.
JNDI-related Properties (optional)  
initialContextFactory The name of the initial context factory to use (this is mapped to the java.naming.factory.initial property).
jndiProviderURL The JNDI provider Web address (this is mapped to the java.naming.provider.url property).
JMS-related Properties (optional)  
deliveryMode An indication as to whether or not the request message is persistent. The valid values are 1 (non persistent) and 2 (persistent). The default value is 1.
timeToLive The lifetime (in milliseconds) of the request message. A value of 0 indicates an infinite lifetime.
priority The JMS priority associated with the request message. Valid values are 0 - 9. The default value is 4.
userid The User ID that is used to gain access to the connection factory.
password The password that is used to gain access to the connection factory.
WSDL serving HTTP URL root
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

Synchronous SOAP over JMS endpoint listener 2

Endpoint listener name
SOAPJMSChannel2.
Endpoint listener URL root

You specify the properties of the synchronous SOAP over JMS endpoint listener 2 endpoint by using the following syntax:

jms:/queue_or_topic_indicator?property_name=property_value and so on, separating each property using the "&" character.

For example, if you use the default values for queue destination and queue connection factory when you install the synchronous SOAP over JMS endpoint listeners, then the first part of the end point address is:
jms:/queue?destination=jms/SOAPJMSQueue2&connectionFactory=jms/SOAPJMSFactory2

For the full list of properties that can be specified in the endpoint address for synchronous SOAP over JMS endpoint listener 2, see the list of properties detailed above for Synchronous SOAP over JMS endpoint listener 1.

WSDL serving HTTP URL root
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
Related tasks
Configuring JMS resources for the synchronous SOAP over JMS endpoint listener
Creating a new endpoint listener configuration
Modifying an existing endpoint listener configuration
Deleting endpoint listener configurations

Reference 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\ref\rjw_epl_details.html

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