Enterprise Manager: BBjServices > Settings
To view this topic for the preceding Enterprise Manager, see EM Java App: Server Information (Environment Tab) and EM Java App: 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 default user for use with BUI. Default is "nobody". |
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
Java Date Types (Uncheck for MS Access) |
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 Session |
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, licenses 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.
BBj.properties Tab
Select the BBj.properties tab at the bottom of the BBjServices Settings page to display a read-only version of the current contents of the BBj.properties file. This may be useful for displaying properties that exist in the file, but not standard and thus not configurable from the Enterprise Manager UI.