Enterprise Manager - BBjServices: Settings

To view this topic for the preceding Enterprise Manager, see Enterprise Manager - Server Information (Environment Tab) and Session Pinning.

Description

The Enterprise Manager allows the administrator to change various BBjServices settings; the Trigger Configuration, manage Environment, view Java Virtual Machine, Operating System, Table Analysis Queue Performance, BBjServices, Thin Client Performance, BBj.properties, and Jetty Licensing Settings.

To access BBjServices settings, select BBjServices > Settings and the settings tab opens to the right.

Java Virtual Machine

64/32 Bit	Bit mode of the system.
Java Vendor	JVM vendor.
Java Version	Current Java version installed.

Logging Settings

Admin Keep Log (days)	Number of days to retain the Admin Server log files.
Admin Log	Full path and primary filename for the Admin Server log files. Filenames will be appended with a number such as AdminServer.log.0.
Admin Log Max Size(MB)	Maximum size for the Admin Server log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.
BBjServices Keep Log (days)	Number of days to retain the BBjServer log files.
BBjServices Log	Full path and primary filename for the BBjServices log files. Filenames will be appended with a number such as BBjServices.log.0.
BBjServices Log Max Size(MB)	Maximum size for the BBjServices log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.
Console Logging Config	Location of the config file if console logging is being used. (see LOGCONSOLE description)
Console Logging Host	Hostname used for console logging. (see LOGCONSOLE description)
Console Logging Port	Port number used for console logging. (see LOGCONSOLE description)
Debug Keep Log (days)	Number of days to retain the Debug log files.
Debug Log	Full path and primary filename for the Debug log files. Filenames will be appended with a number such as Debug.log.0.
Debug Log Max Size(MB)	Maximum size for the Debug log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.
File Open Statistics	Statistics of the open files.
Filesystem Debug Level	Level of debug logging to output to the Filesystem.log files.
Filesystem Keep Log (days)	Number of days to retain the Filesystem Server log files.
Filesystem Log	Full path and primary filename for the Filesystem Server log files. Filenames will be appended with a number such as FilsystemServer.log.0.
Filesystem Log Max Size(MB)	Maximum size for the Filesystem Server log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.
Mem Stats Freq (minutes)	Interval in minutes between logging of the current memory statistics. If you set it to 5 min, then it logs the current memory usage every 5 minutes. This is the information that shows up in the memory usage graph. For finer control and more detailed metrics related to memory usage and other JVM-related information in BBj 18.00+, see BBj Metrics.
PRO/5 DS Keep Log (days)	Number of days to retain the PRO/5 DS Server log files.
PRO/5 DS Log	Full path and primary filename for the PRO/5 DS Server log files. Filenames will be appended with a number such as Pro5DSServer.log.0.
PRO/5 DS Log Max Size(MB)	Maximum size for the PRO/5 DS Server log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.
SQL Engine Debug Level	Level of debugging output to display in the SQLEngineServer.log files.
SQL Engine Log Level	Level of optimization and query-related logging to display in the SQLEngineServer.log files. Note that including optimization logging will drastically increase the size of the log files. Logging levels include: Partial Optimization, Complete Optimization, and User/SQL Statement. The optimization levels include information typically useful for BASIS Support/Engineering when looking into query performance issues. User/SQL Statement logging logs all SQL statements executed and includes the user who executed the statement.
SQL Engine Keep Log (days)	Number of days to retain the SQL Engine Server log files.
SQL Engine Log	Full path and primary filename for the SQL Engine Server log files. Filenames will be appended with a number such as AdminServer.log.0.
SQL Engine Log Max Size(MB)	Maximum size for the SQL Engine Server log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.
Web Server Keep Log (days)	Number of days to retain the Jetty Web Server log files.
Web Server Log	Full path and primary filename for the Jetty Web Server log files. Filenames will be appended with a number such as Jetty.out.0
Web Server Log Level	Level of logging to include in the Jetty.out file.
Web Server Log Max Size(MB)	Maximum size for the Jetty Web Server log file before rolling over to a new file. Old files will be kept for the number of days specified in the “keep” setting.

Environment

Allow Pipes	Allow BBjServices to use pipes.
Cache Directory	Change the default location for caching.
Dump Filesystem Cause Stack	Dumps a stack trace to the debug log file.
*Exclusive File Access	Enable/disable this box to enable/disable.
*File Descriptors	Add/edit or remove file descriptors.
*Force JVM Local	Force the use of the local JVM.
Heartbeat Timeout (ms)	Set the heartbeat timeout. Default: 40000
Interpreter Debug	Enable/disable to allow interpreter debugging.
*Log Directory	Set the default log directory.
Notify On Internal Error	Send notification when an internal error occurs.
PDF Font Directory	Set the directory for PDF fonts.
Query Printers On Startup	Enable/disable to check for available printers.
Release On Lost Connection	Close open files when the connection is lost.
Replication Recopy Delay (minutes)	The number of minutes replication waits before checking to see if there are any files that need to be recopied due to changes that could not be replicated on a record by record basis.
*Replication/Audit Config Directory	The config directory for replication and auditing holds the replication/audit operations log files which contain the replication and auditing operations not yet processed by the target. These files can grow large in some cases so this setting allows that admin to place these files in an appropriate location on disk.
Required Explicit Read-Only	When set to true, the OPEN verb will only open files in read-only mode when the O_RDONLY option is explicitly specified.
Secure NTDS Encrypter	The class that is used as the secure NTDS encrypter.
*Single Threaded Interpreters SPROC/Triggers	Enable/disable single threaded interpreters.
*Skip Ident Verification	Enable/disable to skip Ident verification.
Skip Program Cache File	Enable/disable program caching.
Skip Query Analysis	Enable/disable Query Analysis on a BBjServices-global level.
Thin Client JVM Wait Time	Set the wait time for JVM thin client.
Thread Pool Size	Set thread pool size Default: -1
Use Fork On File Creation	Enable/disable fork for file creation.
*Use SSL on Filesystem	Enable/disable SSL for filesystem.
Use Windows Permissions	Enable/disable windows permissions.
User Authentication	Enable/disable user authentication.
*Web User	Set web user. Default is none.
Working Directory	Set BBjServices working directory.

* Changes to this property require the administrator to manually restart BBjServices.

Global Database Settings

System Connection User

User account used by the SQL engine for system level database access operations such as reading/writing to data dictionary files. This is typically used when using data server syntax to access data dictionary files remotely. In most cases, this setting should be left empty.

Trigger Configuration

Allow Trigger Debugging	Check this box to allow debugging of triggers.
*Config File	Set the config file for triggers.
*Password	Set the password.
*User Name	Set the user name for the trigger.
*Working Directory	Set the working directory for triggers.

* Changes to this property require the administrator to manually restart BBjServices.

BBjServices

BBj Build Date	BBj build data and time.
BBj Build ID	BBj build ID.
BBj Version	BBj version.
BBjServices Start Time	Time and date that BBj Services was started.

Lucene Settings

Max Document Size (MB)	Maximum size of the documents or records stored in a Lucene index. This include document indexes as well as FULLTEXT indexes in SQL.
Max Search Results	Maximum number of search results that a Lucene-related search can return. This applies to document indexes and FULLTEXT indexes in SQL. The larger the value, the more memory will potentially be utilized when performing searches.

3rd Party Database Special Settings

Use Java SQL Types for DATE

This is a very unusual setting but necessary for various compatibility issues. Microsoft Access deals with dates in a unique way when interacting with the BBj ODBC Driver requiring the driver to return an older integer value for DATE type columns in the metadata. This is technically not correct according to the ODBC and JDBC specifications. However, in order to function with MS Access, this value must be UNCHECKED. The default is checked because it is technically correct.

Operating System

OS Name	Name of the operating system.
OS Version	Current version of the operating system.

Table Analysis Queue Performance

Iterations Before Pause	Number of times a table is analyzed before it it is paused.
Pause Time (ms)	The length of time for each pause.

Thin Client Performance

Pin Programs and Resources	Enable/disable BBj to keep programs and resources in memory.
Pin by BBj Sesion	Enable/disable BBj to keep the session in memory.
Recheck Session Classpath	Enable/disable BBj to check the session classpath.
Send Message Responses	Enable/disable BBj to send message responses.
Suppress Client Object Errors	Enable/disable client object messages from the sysconsole.
Suppress Printer Ack Back	Enable/disable printer ack back messages from the sysconsole.
Use DVK License If Present	Enable/disable to force BBj to use a DVK license.

Jetty Licensing Settings

To access the Jetty Licensing Settings in Enterprise Manager:

Log into Enterprise Manager and connect to a BBj Services instance.
Expand the BBjServices node in the left tree.
Select the Settings node.
Scroll down until the Jetty Licence Settings section displays, as shown below:

License Attempt Timeout	Longest time to wait (in ms) for a license.
Max BBJSP Licenses	Maximum number of licenses for BBJSP applications.*
Max License Usage	Maximum number of licenses.*
Max Servlet Licenses	Maximum number of licenses for Servlets.*
Max Web Service Licenses	Maximum number of licenses for Web Services.*
Queue	How many requests can wait for a license.*
Retry Interval	Length of the pause, in milliseconds, between attempts to obtain a license.

* Items marked with an asterisk (*) denote that a zero (0) value indicates that the setting is unlimited.

When servlets are executed, licences are borrowed for the duration of the execution cycle. This can lead to license limiting factors around servlets and web services since servlets may not be able to obtain a license when under load.

In order to combat this, BASIS added new licensing settings that include:

Ability to control how many licenses are available to the web layer.
A timeout limit for how long a servlet or web service will wait for a license to become available.
The number of requests to allow to wait for a license.

If a license is not immediately available to a request, that request will wait for one to become available unless there are already the specified number of waiting requests. If a request is unable to obtain a license due to timeout waiting or no more waiting slots, then the request will receive HTTP error 503.

back to top

BBjSP Global Settings

Increment	TBD
Max Capacity	TBD
Min Capacity	TBD
Release Interval	TBD
Reserve	TBD
Retry Milliseconds	TBD
Wait Milliseconds	TBD