JMS entity properties  Log profile properties

Appendix B: Repository Properties Reference

Listener properties

Description

Listener property names begin with com.sybase.jaguar.listener. Listeners define the protocols, port numbers, and optional SSL security profiles for client connections to a server.

See also

Server properties




com.sybase.jaguar.listener.host

Description

Specifies the host name or IP address for the listener.

Syntax

The host name or IP address, or one of the following placeholders:

Placeholder

To indicate

${JAGUAR_HOST_NAME}

The name of the host where the server process is running.

${JAGUAR_IP_ADDRESS}

The IP address of the host where the server is running.

Use one of the placeholders if you must use the same listener configuration in multiple EAServer installations. Include the domain if your server accepts internet connections, otherwise clients outside your domain cannot connect.

If your machine supports multiple network addresses, you can enter each host name or IP address in a list separated by commas. You can also enter the special value 0.0.0.0, which causes EAServer to listen on all of the machine’s host or IP addresses. When using multiple host addresses, EAServer creates a listener for each host on the specified port.




com.sybase.jaguar.listener.http.conn.keepalive

Description

Specifies the time in seconds to keep open the server side of an idle HTTP connection.

Syntax

The time in seconds. If not specified, the default is 120.




com.sybase.jaguar.listener.http.conn.maxrequests

Description

Specifies the maximum number of HTTP requests to service before closing each connection.

Syntax

The maximum, as a positive integer. If not specified, the default is 100.




com.sybase.jaguar.listener.http.connector_events

Description

Must be set to true if you use the EAServer Web server redirector between HTTP clients and the EAServer HTTP listener.

Syntax

true or false. The default is false.

WARNING! This property must be set to true when clients connect via the Web server redirector. Otherwise, the HTTP response can be incorrect.




com.sybase.jaguar.listener.logsslerr

Description

Specifies whether to log additional SSL error information for connections handled by the listener.

Syntax

true or false. The default is false.

See also

com.sybase.jaguar.security.logsslerr




com.sybase.jaguar.listener.monitor.MaxRespTime

Description

Specifies the maximum allowable response time for each request. If the average response time rises above this limit, EAServer blocks additional connections until the average drops below the specified limit.

Syntax

The maximum allowable response time, in seconds. The default is -1, which indicates no time limit.

See also

com.sybase.jaguar.listener.monitor.MinInstance

Chapter 9, “Using the Performance Monitor,” in the EAServer Performance and Tuning Guide.




com.sybase.jaguar.listener.monitor.MinInstance

Description

When response time monitoring is in effect (com.sybase.jaguar.listener.monitor.MaxRespTime is set to a non-negative value), specifies the minimum numer of clients that must be allowed to execute regardless of observed response times.

Syntax

The minimum number of clients. The default is -1, which means no new connections are blocked by the Performance Monitor.

See also

com.sybase.jaguar.listener.monitor.MaxRespTime

Chapter 9, “Using the Performance Monitor,” in the EAServer Performance and Tuning Guide.




com.sybase.jaguar.listener.name

Description

Specifies the listener name.

Syntax

Server_listener

Where Server is the server name where this listener is installed, and listener is the unqualified listener name. For example:

Jaguar_iiops1



com.sybase.jaguar.listener.port

Description

Specifies the port number.

Syntax

The integer port number.




com.sybase.jaguar.listener.protocol

Description

Specifies the protocol for connections accepted by this listener.

Syntax

Allowable values are:




com.sybase.jaguar.listener.security

Description

For listeners that use a tunnelled SSL protocol (such as HTTPS or IIOPS), specifies the security profile used to configure the SSL session settings.

Syntax

The name of the security profile, which must match the com.sybase.jaguar.security.name property of the security profile.

See also

Security properties




com.sybase.jaguar.listener.solaris.tli.maxoutcon

Description

When running on Solaris, specifies the pool size for outstanding connection requests.

Syntax

Values must be a positive integer less than or equal to 4096. If this property is not set, the default is 128. Values greater than 4096 are truncated to 4096 to avoid excessive memory allocation at startup.

Usage

This property is used on Solaris only. When the server is very busy, all available threads may be in use when a connect request arrives. These pending connect requests are pooled until they can be handled. If the pool size is too small, client connection requests may time out before the server can handle the request.

You can configure different request pool sizes for different protocols. For example, if the server is handling mostly HTTP requests, you can increase the request pool size for the HTTP listener while leaving the IIOP request pool size at a low value.

The connection request pool size affects the server memory requirements:

mem = entries * 20K

That is, each entry requires about 20K of memory reserved at server startup.




com.sybase.jaguar.listener.type

Description

For TDS listeners, specifies whether this listener accepts Open Server client connections.

Syntax

The only allowable value for this property is os. If the property is set with no value, or not set, the listener will not accept Open Server client connections.

Usage

EAServer allows you to install Open Server event handlers so that you can migrate legacy Sybase Open Server applications to EAServer. The event handlers are called only for connections to a listener that uses the TDS protocol and that has the com.sybase.jaguar.listener.type property set to “os”. For more information on this feature, see Appendix B, “Migrating Open Server Applications to EAServer,” in the EAServer Programmer’s Guide.

See also

com.sybase.jaguar.listener.protocol





Copyright © 2005. Sybase Inc. All rights reserved. Log profile properties