Network Deployment (Distributed operating systems), v8.0 > Reference > Administrator best practices
Example values for endpoint listener configuration
We can configure any number of endpoint listeners with values of your own choosing, including the example values given in this topic.
When you create an endpoint listener configuration, you provide the following configuration details:
Endpoint listener name
The name by which the endpoint listener is known.
URL root
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 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. This address comprises the root of the HTTP address at which external clients access your endpoint listener application, followed by /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.
To get the location details for a given inbound service WSDL file, publish the WSDL file to a compressed file as described in Modify an existing inbound service configuration, then look up the location within the exported WSDL file.
The rest of this topic gives example configuration details (endpoint listener name, endpoint listener URL root and WSDL serving URL root) for four endpoint listeners that you might want to create:
- SOAP over HTTP endpoint listener 1
- SOAP over HTTP endpoint listener 2
- Synchronous SOAP over JMS endpoint listener 1
- Synchronous SOAP over JMS endpoint listener 2
SOAP over HTTP endpoint listener 1
Endpoint listener name
SOAPHTTPChannel1.
URL root
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 this endpoint listener): http://www.yourcompany.com/wsgwsoap//publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/ 1 However, if you allow external clients to connect direct to your 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 this endpoint listener):
http://your.server.name:9080/wsgwsoap//publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/ 1
WSDL serving HTTP URL root
The root of the HTTP address at which external clients access your endpoint listener application, followed by /sibws. For example:
http://www.yourcompany.com/sibwsorhttp://your.server.name:9080/sibwsThe 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.
SOAP over HTTP endpoint listener 2
Endpoint listener name
SOAPHTTPChannel2.
URL root
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 this endpoint listener): http://www.yourcompany.com/wsgwsoap//publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/ 2 However, if you allow external clients to connect direct to your 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 this endpoint listener):
http://your.server.name:9080/wsgwsoap//publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/ 2
WSDL serving HTTP URL root
The root of the HTTP address at which external clients access your endpoint listener application, followed by /sibws. For example:
http://www.yourcompany.com/sibwsorhttp://your.server.name:9080/sibwsThe 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.
Synchronous SOAP over Java Message Service (JMS) endpoint listener 1
Endpoint listener name
SOAPJMSChannel1.
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/SOAPJMSFactory1For 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 descriptions. The first column of this table lists the property names, and the second column lists the property description.
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 Indicates whether 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 used to gain access to the connection factory. password The password used to gain access to the connection factory.
WSDL serving HTTP URL root
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 by using default port 80, then this URL root includes the HTTP server name and no port number. For example:
http://www.yourcompany.com/sibwsHowever, 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/sibwsThe 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.
Synchronous SOAP over JMS endpoint listener 2
Endpoint listener name
SOAPJMSChannel2.
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/SOAPJMSFactory2For 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 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 by using default port 80, then this URL root includes the HTTP server name and no port number. For example:
http://www.yourcompany.com/sibwsHowever, 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/sibwsThe 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.