Class: com.sybase.djc.server.ApplicationServer (Application Server) EAServer 6.3 Help
Description An application server is an operating system process that supports the execution of CORBA, EJB and web components.
Configuration See Set Properties Task.
Properties alarmMemoryLimit, allowRuntimeCompile, allowUnauthenticatedUserInvoke, captureConsoleOutput, criticalMemoryLimit, defaultCodeSet, deployConsoleOutput, disable60MinuteStatistics, disable60SecondStatistics, disableStatistics, echoLog, ejbTrace, enableDriverManagerLog, enableHttpRequestLog, enableProxiedForAddress, enableXmlEntityCache, enableXmlGrammarCache, exRef, excludeModules, featureManagerConfig, fipsEnabled, host.name, httpContexts, httpDomain, httpListeners, httpLogFile, httpLogFileArchive, httpLogFileArchiveCompress, httpLogFileArchiveName, httpLogFileMaxSize, httpLogFileMaxTime, httpLogFileReUse, httpLogFileRotation, httpLogFileRotationDaily, httpSSO, httpWebAppEventListener, iiopListeners, javaAlarmMemoryLimit, javaClassPath, javaCriticalMemoryLimit, javaStartupOptions, jmsTrace, jnfiClassName, jtdsListeners, keyStore, keyStorePassword, keyStoreType, logApplicationExceptions, logFile, logFileArchive, logFileArchiveCompress, logFileArchiveName, logFileMaxSize, logFileMaxTime, logFileReUse, logFileRotation, logFileRotationDaily, logSystemExceptions, maximumVirtualMemory, mx4jLoggingLevel, processID, proxyForwarded, reverseHostLookupEnabled, rmiListeners, rmiTrace, rmiTraceLocal, scheduledTasks, sendServerHeader, serviceComponents, sessionIDLength, singleThreadedOdbc, smAccountingPort, smAgent, smAgentDebug, smAgentPassword, smAuthenticationPort, smAuthorizationPort, smRoleDebug, smServer, smSize, smTimeout, sqlTrace, startModules, startResources, systemExcludeModules, systemStartModules, traceModules, trustStore, trustStorePassword, trustStoreType, txRef, unixGroupname, unixUsername, useTransactionLocalPools, verifyIPForSession, webTrace, workOffline, wsTypeMappingVersion
Files Repository/Instance/com/sybase/djc/server/ApplicationServer/*.properties

Property: alarmMemoryLimit (Memory Limit for Alarm (%))
Description The percentage of available virtual memory before an alarm message is logged.

Note: for this property to be active, the scheduledTasks property should include "CheckMemoryUsage".

See also: maximumVirtualMemory.

Default Value 70
Minimum Value 0
Maximum Value 100

Property: allowRuntimeCompile (Allow Runtime Compile)
Description Determines whether runtime compilation of Java source code is permitted. By default, the server will recompile code for IIOP interface stubs, SQL persistence classes and JavaServer Pages if the code has changed since the last time it was compiled. You should set allowRuntimeCompile to false if your server is running under a JRE (Java Runtime Environment, without the Java compiler). If you are using JavaServer Pages with allowRuntimeCompile set to false, your pages must be precompiled. If you define all JavaServer Pages that need to be precompiled with their own 'servlet' elements in your web.xml files, the 'deploy' tool will precompile them. IIOP interface stubs and SQL persistence classes are precompiled automatically when you deploy EJB modules. If you are running the server with allowRuntimeCompile set to false, and you change the configuration of a data source that is used by EJB entity beans, you should redeploy your EJB-JAR files before running the server. Note: the 'deploy' tool needs the Java compiler to run, so you may need to run 'deploy' on one machine and transfer the deployed configuration to the target machine which has no Java compiler. To transfer deployed configurations between machines, you can use an Export Configuration.
Default Value true
Legal Values false, true

Property: allowUnauthenticatedUserInvoke (Allow Unauthenticated User Invoke)
Description Allow unauthenticated user to invoke CORBA components.
Default Value false
Legal Values false, true

Property: captureConsoleOutput (Capture Server Console Output in Log)
Description Determines whether console output is captured. When console output is captured, it appears both on the console window and in the server log.
Default Value true
Legal Values false, true

Property: criticalMemoryLimit (Critical Memory Limit (%))
Description The percentage of available virtual memory before thread monitors are locked to minimum active threads.

Note: for this property to be active, the scheduledTasks property should include "CheckMemoryUsage".

See also: maximumVirtualMemory.

Default Value 90
Minimum Value -1
Maximum Value 100

Property: defaultCodeSet (Default Code Set)
Description Required. Default code set for CORBA C++ components.

See also: com.sybase.jaguar.component.code.set.

Default Value utf8

Property: deployConsoleOutput (Echo Deploy Log to Server Console)
Description Capture deploy log output and echo it to the server's console window (if any).
Default Value false
Legal Values false, true

Property: disable60MinuteStatistics (Disable 60 Minute Statistics)
Description Disables 60 minute statistics. When not disabled, 60 minute summary information is added to all available statistics. The additional information is:
  • For each count statistic, the delta (increment) for the last measurement interval.
  • For each range statistic, the minimum count and maximum count values for the last measurement interval.
  • For each time statistic, the delta (count increment), total time, minimum time and maximum time values for the last measurement interval.
A measurement interval lasts 60 minutes. When one measurement interval ends, a new one begins. Measurement intervals are non-overlapping. 60 minute summary information is only updated once per hour (for the previous full hour).
Default Value false
Legal Values false, true

Property: disable60SecondStatistics (Disable 60 Second Statistics)
Description Disables 60 minute statistics. When not disabled, 60 second summary information is added to all available statistics. The additional information is:
  • For each count statistic, the delta (increment) for the last measurement interval.
  • For each range statistic, the minimum count and maximum count values for the last measurement interval.
  • For each time statistic, the delta (count increment), total time, minimum time and maximum time values for the last measurement interval.
A measurement interval lasts 60 seconds. When one measurement interval ends, a new one begins. Measurement intervals are non-overlapping. 60 second summary information is only updated once per minute (for the previous full minute).
Default Value false
Legal Values false, true

Property: disableStatistics (Disable Statistics)
Description Disables all server statistics. This will improve performance, but you will have much less information available about what the server is doing. Recommendation: check what the performance advantage is, so you know if the lack of statistics is worth the extra performance that you can gain.
Default Value false
Legal Values false, true

Property: echoLog (Echo Server Log to Server Console)
Description Capture server log output and echo it to the server's console window (if any).
Default Value false
Legal Values false, true

Property: ejbTrace (Enable EJB Trace)
Description Select to trace EJB component invocations in the server log.
Default Value false
Legal Values false, true

Property: enableDriverManagerLog (Enable java.sql.DriverManager Log)
Description Enables logging by the JDBC driver manager. This may be useful if your JDBC driver logs trace/debug information when this is set.
Default Value false
Legal Values false, true

Property: enableHttpRequestLog (Enable HTTP Request Log)
Description Enables the generation of an HTTP request log. This log is written to the 'logs' directory, with file name server-name-http-YYYY-MM-DD.log
Default Value false
Legal Values false, true

Property: enableProxiedForAddress (Enable Proxy-For Address in HTTP Log)
Description Select to generate Proxied-For Address in Http Log
Default Value false
Legal Values false, true

Property: enableXmlEntityCache (Enable XML Entity Cache)
Description Enables caching of XML entities (e.g. external DTDs) used by the 'deploy' tool. XML entities are cached in file Repository/Component/com/sybase/djc/xml/XmlEntityCache.properties. You can safely delete this file to clear out the cache.
Default Value true
Legal Values false, true

Property: enableXmlGrammarCache (Enable XML Grammar Cache)
Description Enables caching of XML grammars used by the Xerces parser.
Default Value true
Legal Values false, true

Property: exRef (Generate Exception Cross Reference)
Description Enables generation of an exception cross reference. This log is written to the 'logs' directory, with file name server-name-exceptions.log. Attempts to filter out repeat exceptions and list only the distinct exceptions that are present in the server log.

Note: if many exceptions are being written to the server log, enabling this property could cause a noticeable performance degradation. It is recommended that this property only be enabled when troubleshooting.

Default Value false
Legal Values false, true

Property: excludeModules (User Exclude Modules)
Description List of deployed user modules to exclude from startup, processed after start list.
Default Value none

Property: featureManagerConfig (License Configuration)
Description Required. Indicates the license configuration to be used by the feature manager.
Default Value default

Property: fipsEnabled (FIPS Mode Enabled)
Description Enable FIPS mode.
Default Value false
Legal Values false, true

Property: host.name (Host Name)
Description Default host name used for resolving ${host.name} in listener definitions.

Property: httpContexts (HTTP Contexts)
Description Comma separated list of HTTP contexts that should be accessible in this server.
Default Value default

Property: httpDomain (Domain Name)
Description The Web server redirector's domain name.

Property: httpListeners (HTTP Listeners)
Description Comma separated list of HTTP/HTTPS listeners that the server should open, to accept requests from clients using the HTTP protocol. HTTP is typically used by web browser and web service clients.
Default Value http1

Property: httpLogFile (HTTP Log File Name)
Description Set the http log file name.
Default Value P:\/logs/default-http.log

Property: httpLogFileArchive (Archive the HTTP Log File)
Description Archive the http log file.
Default Value false
Legal Values false, true

Property: httpLogFileArchiveCompress (Compress the HTTP Log File Archive)
Description Compress the http log file archive.
Default Value false
Legal Values false, true

Property: httpLogFileArchiveName (HTTP Log File Archive Name)
Description Set the log file archive name.

Property: httpLogFileMaxSize (Maximum size of the HTTP log file)
Description Set the maximum size of the http log file.
Default Value -1

Property: httpLogFileMaxTime (Maximum time of HTTP log file(HH:MM))
Description Set the maximum time of the http log file.
Default Value 0

Property: httpLogFileReUse (Reuse the HTTP Log File)
Description Reuse the http log file.
Default Value false
Legal Values false, true

Property: httpLogFileRotation (Rotate the HTTP Log File)
Description Rotate the http log file.
Default Value false
Legal Values false, true

Property: httpLogFileRotationDaily (Rotate the HTTP Log File Daily)
Description Rotate the http log file Daily.
Default Value false
Legal Values false, true

Property: httpSSO (Single Sign On)
Description Support Single Sign On.
Default Value false
Legal Values false, true

Property: httpWebAppEventListener (Web Application Event Listener)
Description Class name for a global event listener for all configured web applications.

Property: iiopListeners (IIOP Listeners)
Description Comma separated list of IIOP/IIOPS listeners should open, to accept requests from clients using the IIOP protocol. IIOP is typically used by application clients (CORBA, EJB, JMS).
Default Value iiop1

Property: javaAlarmMemoryLimit (Java Memory Limit for Alarm (%))
Description The percentage of available Java memory before an alarm message is logged.

Note: for this property to be active, the scheduledTasks property should include "CheckMemoryUsage".

See also: maximumVirtualMemory.

Default Value 70
Minimum Value 0
Maximum Value 100

Property: javaClassPath (Java Class Path)
Description Java class path overrides for server startup, which are prefixed to the server's class path. Extension JAR files can be added to the server's lib/ext directory, where they will be appended to the server's class path. Note:
  • Class path overrides prefix the server's default classes.
  • Extension JAR files extend the server's default classes.
  • Named Class Loaders can also be configured at server, application and package level. Named class loaders are appropriate for loading classes used by EJB Modules and Web Applications. Any class needed by a user-spawned thread should be added to the server's class path using class path overrides or extension JAR files.
Class path overrides should be used with caution, as they may interfere with correct operation of the server.

Property: javaCriticalMemoryLimit (Java Critical Memory Limit (%))
Description The percentage of available Java memory before thread monitors are locked to minimum active threads.

Note: for this property to be active, the scheduledTasks property should include "CheckMemoryUsage".

See also: maximumVirtualMemory.

Default Value 90
Minimum Value -1
Maximum Value 100

Property: javaStartupOptions (Java Startup Options)
Description Command-line options for the "java" command that is used to start the server. The "-server" option is recommended for use with Sun JVMs, to activate the HotSpot Server VM.

Property: jmsTrace (Enable JMS Trace)
Description Enables tracing of JMS (Java Message Service) operation, in the server log. Execution of all public and protected JMS provider methods will be traced.
Default Value false
Legal Values false, true

Property: jnfiClassName (Java Naming Factory Initial Class Name)
Description Class name to be used for the java.naming.factory.initial system property.
Default Value com.sybase.djc.naming.InitialContextFactory

Property: jtdsListeners (JTDS Listeners)
Description Comma-separated list of JTDS listener names.
Default Value jtds

Property: keyStore (SSL Key Store)
Description The location for the store where private key and associated public key are stored.

Property: keyStorePassword (SSL Key Store Password)
Description The password for the key store.

Property: keyStoreType (SSL Key Store Type)
Description The type for the key store.

Property: logApplicationExceptions (Log Application Exceptions)
Description Enables logging of application exceptions to the server log. For each deployed module for which logging of application exceptions is required, ensure that exception logging is enabled (see the ejb.logExceptions and/or web.logExceptions properties in the XML configuration scripts).
Default Value true
Legal Values false, true

Property: logFile (Log File Name)
Description Set the log file name.
Default Value P:\/logs/default.log

Property: logFileArchive (Archive the Log File)
Description Archive the log file.
Default Value false
Legal Values false, true

Property: logFileArchiveCompress (Compress the Log File Archive)
Description Compress the log file archive.
Default Value false
Legal Values false, true

Property: logFileArchiveName (Log File Archive Name)
Description Set the log file archive name.

Property: logFileMaxSize (Maximum size of the log file)
Description Set the maximum size of the log file.
Default Value -1

Property: logFileMaxTime (Maximum time of the log file(HH:MM))
Description Set the maximum time of the log file.
Default Value 0

Property: logFileReUse (Reuse the Log File)
Description Reuse the log file.
Default Value false
Legal Values false, true

Property: logFileRotation (Rotate the Log File)
Description Rotate the log file.
Default Value false
Legal Values false, true

Property: logFileRotationDaily (Rotate the Log File Daily)
Description Rotate the log file Daily.
Default Value false
Legal Values false, true

Property: logSystemExceptions (Log System Exceptions)
Description Enables logging of system exceptions to the server log. For each deployed module for which logging of system exceptions is required, ensure that exception logging is enabled (see the ejb.logExceptions and/or web.logExceptions properties in the XML configuration scripts for the deployed modules).
Default Value true
Legal Values false, true

Property: maximumVirtualMemory (Maximum Virtual Memory)
Description The maximum number of bytes of virtual memory that the server process should use.
Default Value 0
Minimum Value 0
Maximum Value 2147483647

Property: mx4jLoggingLevel (JMX Logging Level)
Description Required. Logging level for embedded JMX management bean server.
Default Value error
Legal Values trace, debug, info, warn, error, fatal

Property: processID (Process ID)
Description A unique ID for the server instance, in the format of a dotted decimal TCP/IP address, a colon, and a port number (e.g. 10.11.12.13:2000). This unique ID is used in construction of session IDs, and needs to be unique across your network of connected servers that share the same database(s). It does not need to be globally unique. It does not need to refer to a real TCP/IP address. The default value is derived from the iiopListeners property or the httpListeners property, but the value can be specified explicitly.

Property: proxyForwarded (Default to mod_proxy_http header)
Description Default to mod_proxy_http header.
Default Value false
Legal Values false, true

Property: reverseHostLookupEnabled (Enable Reverse Host Lookup)
Description Enables the server to lookup each client's IP address to a host name. Client host names may be included in AUDIT and TRACE messages. For some systems, enabling client host name lookup can increase socket connection response times to an unacceptable level.
Default Value false
Legal Values false, true

Property: rmiListeners (RMI Listeners)
Description Comma-separated list of RMI listener names.
Default Value none

Property: rmiTrace (Enable RMI-IIOP Trace)
Description Enables tracing of remote method invocation (for IIOP and RMI-IIOP) in the server log. Caution: enabling this tracing could result in plain-text passwords appearing in the server log, depending on the authentication mechanism used by remote clients.
Default Value false
Legal Values false, true

Property: rmiTraceLocal (Enable RMI Local Trace)
Description Select to trace local method invocations (inter-component calls) in the server log.
Default Value false
Legal Values false, true

Property: scheduledTasks (Scheduled Tasks)
Description Specified which scheduled tasks should be activated in this server. Scheduled tasks must be separately configured - only their activation is specified here. Specifying "all" activates all configured scheduled tasks.
Default Value none

Property: sendServerHeader (Send the Server Version in HTTP header)
Description Support send the Server Version in HTTP header.
Default Value true
Legal Values false, true

Property: serviceComponents (Service Components)
Description Specified which service components should be activated in this server. Service components must be separately configured - only their activation is specified here. Specifying "all" activates all configured service components.
Default Value none

Property: sessionIDLength (HTTP session ID Length)
Description The length should be a multiple of 8
Default Value 64
Minimum Value 0
Maximum Value 64

Property: singleThreadedOdbc (Single Threaded ODBC Calls)
Description Server makes ODBC calls in single threaded mode.
Default Value false
Legal Values false, true

Property: smAccountingPort (SiteMinder Accounting Port)
Description SiteMinder Accounting Port.
Default Value 44441
Minimum Value 0
Maximum Value 2147483647

Property: smAgent (SiteMinder Agent Name)
Description SiteMinder Agent Name.

Property: smAgentDebug (SiteMinder Agent Debug)
Description SiteMinder Agent Debug.
Default Value false

Property: smAgentPassword (SiteMinder Agent Password)
Description SiteMinder Agent Password.

Property: smAuthenticationPort (SiteMinder Authentication Port)
Description SiteMinder Authentication Port.
Default Value 44442
Minimum Value 0
Maximum Value 2147483647

Property: smAuthorizationPort (SiteMinder Authorization Port)
Description SiteMinder Authorization Port.
Default Value 44443
Minimum Value 0
Maximum Value 2147483647

Property: smRoleDebug (SiteMinder Role Debug)
Description SiteMinder Role Debug.
Default Value false

Property: smServer (SiteMinder Server Address)
Description SiteMinder Server Address.

Property: smSize (SiteMinder Cache Size)
Description SiteMinder Cache Size.
Default Value 600
Minimum Value 0
Maximum Value 2147483647

Property: smTimeout (SiteMinder Timeout)
Description SiteMinder Timeout.
Default Value 0
Minimum Value 0
Maximum Value 2147483647

Property: sqlTrace (Enable SQL Trace)
Description Enables tracing of JDBC driver activity to the server log. This includes JDBC prepared statement operations, parameter and result information for container managed persistence operations (queries and updates), and transaction commit/rollback operations.
Default Value false
Legal Values false, true

Property: startModules (User Start Modules)
Description A comma-separated list of names of deployed modules (in the server's deploy directory) which must be started during server startup. If the list contains "all", all deployed modules are started (even if the list does not otherwise list all of the deployed modules). If the list is "none", no deployed modules are started. Otherwise the listed modules are started. Module names for this list must be in the form:
  • application-abc
  • ejbjar-abc
  • webapp-abc
Starting an application results in all of the application's EJB and web modules being started, even if they are not explicitly listed.
Default Value all

Property: startResources (Start Resources)
Description A comma-separated list of names of configured resources (JCA connection factories, JDBC data sources, JMS queues, JMS topics) which must be activated during server startup. If the list contains "all", all configured resources are started (even if the list does not otherwise list all of the configured resources). If the list is "none", no configured resources are started. Otherwise the listed resources are started. Resource names for this list must be in the form:
  • connectionFactory-abc
  • dataSource-abc
  • messageQueue-abc
  • messageTopic-abc
Resources which are not started at server startup will be activated on first use. If you are using message queues or topics with "store and forward", you should include the queues or topics in the startResources property to ensure that "store and forward" operations will be activated in a timely manner.
Default Value all

Property: systemExcludeModules (System Exclude Modules)
Description List of system modules to exclude from startup.

Property: systemStartModules (System Start Modules)
Description List of system modules to start.
Default Value all

Property: traceModules (Trace Modules)
Description List of deployed user modules to trace.
Default Value none

Property: trustStore (SSL Trust Store)
Description The location of the store where trusted certificates reside.

Property: trustStorePassword (SSL Trust Store Password)
Description The password for the trust store.

Property: trustStoreType (SSL Trust Store Type)
Description The type for the trust store.

Property: txRef (Generate Transaction Cross Reference)
Description Enables generation of a transaction cross reference every 10 minutes. This log is written to the 'logs/transactions' directory, with file name server-name-HH-MM.transactions. For each distinct transaction (business method that initiates a container managed transaction), the cross reference includes information about SQL statements and JMS operations that were executed in the transaction.
Default Value false
Legal Values false, true

Property: unixGroupname (Unix Group Name)
Description When running Unix / Linux systems, specifies the effective group name that the server should switch to upon startup. For other operating systems, this property is ignored.

Property: unixUsername (Unix User Name)
Description When running Unix / Linux systems, specifies the effective user name that the server should switch to upon startup. This is useful if the server process must be initially started with root privileges in order to be able to create network listeners on port numbers below 1000 (e.g. ports 80 and 443 for HTTP and HTTPS), but the server should not continue to run with these privileges once the listeners are active. For other operating systems, this property is ignored.

Property: useTransactionLocalPools (Use Transaction Local Pools)
Description Enables the use of transaction-local pools for component instances and database connections. Transaction-local pools are an alternative to thread-local pools, which can increase performance relative to the default global pools, and reduce resource utilization relative to thread-local pools, particularly on multi-processor systems.

To limit resource utilization when using transaction-local pools, you should set the maximumActiveThreads thread monitor property appropriately for each thread monitor that you use.

For example, if you enable transaction-local pools for a server whose components access a database, then the number of concurrent database connections will be equal to the number of threads concurrently executing transactions. By using a thread monitor to limit the number of concurrent component calls (and thereby concurrent transactions), you can effectively limit the number of database connections used.

Important Notes:

  • If you enable this property, then the maxPoolSize property for your data sources will be ignored.
  • If you enable this property, then resource utilization might be higher than it is in the default configuration.

Recommendation: on multi-processor systems, try enabling this property and configuring thread monitors appropriately to see if it improves overall server performance while keeping resource utilization to an acceptable level.

Default Value false
Legal Values false, true

Property: verifyIPForSession (Verify IP For Session)
Description Specifies what action to take in the event that the IP address where the session was created does not match the request's IP address.
Default Value invalidate
Legal Values invalidate, log, none

Property: webTrace (Enable Web Trace)
Description Select to trace web component invocations in the server log.
Default Value false
Legal Values false, true

Property: workOffline (Work Offline)
Description Determines whether JMS store and forward operations are disabled at server startup time. JMS store and forward operations can be dynamically activated or deactivated (once the server is running) from Java code by setting Java system property "jms.workOffline" to "true" or "false" respectively. The ability to disable JMS store and forward operations is most useful on mobile devices, where the running application(s) may wish to control whether background JMS operations will attempt to utilize the network.
Default Value false
Legal Values false, true

Property: wsTypeMappingVersion (WebServices Type Mapping Version)
Description WebServices Typing Mapping Version to be used.
Default Value 1.3