Enterprise Manager: BBj Services > Java Settings

To view this topic for the preceding Enterprise Manager, see EM Java App: Server Information (JVM Tab, Classpath Tab).

Description

The Enterprise Manager allows the administrator to manage the various Java virtual machine (JVM) settings for any BBj application.

To access Java-related settings, select BBjServices > Java Settings to open the Java Settings multi-tab configuration page.

Java Virtual Machine Settings

Use the JVM tab to select the JVM to use as a default for BBjServices, as well as any of the specific components (Application) of the BBjServices environment. NOTE: Any changes to these settings require restarting BBjServices before taking effect.

Application

Selects the application being configured. The Default application applies to all applications that do not otherwise provide overriding configuration changes.

Java Home

Full path to the location of the JDK to use for the selected application. This will vary based on the specific OS used by the server.

Use Default JVM

Select whether to use the Default JVM or specify a specific JVM for the selected application.

Java Args

Command line arguments to pass to the JVM at runtime. These are equivalent to the arguments passed to an invocation of java from the command line.

Use Default Args

Select whether to use the Default JVM or specify specific command line arguments for the selected application.

Java Details

Read-only summary of the information related to the selected JVM including vendor, bit mode, version, etc.

Java Classpath Settings

Use the Classpath tab to configure the default classpath for BBjServices. In addition, use this tab to configure any session-specific classpaths (SSCP) available for use by BBj programs. SSCPs provide the administrator with the ability to make different libraries available to different interpreters based on specific application requirements. See Session-Specific Classpath for more information and how to incorporate them in practice. NOTE: Any changes to the settings on this tab require restarting BBjServices before taking effect.

Classpath Names List of all the named session-specific classpaths available.
Classpath Entries The JARs, directories of JARs, and nested SSCPs (19.10+) included in the selected classpath. Make sure to include all JAR files required by any embedded Java code used by BBj programs that will utilize the classpath.

Building a Session-Specific Classpath (SSCP)

  1. Click the [Add] button located above the Classpath Names list.

  2. Specify a unique name for the classpath. This will be used when referencing and including the classpath.

  3. Select the classpath to configure.

  4. Use the [Add] button located above the Classpath Entries section to add JARs, directories, and/or other classpaths (19.10+).

  5. Save any changes using File > Save.

Notes on Adding Classpath Entries

  • BBj 19.10+ supports the inclusion of nested classpaths within session-specific classpaths. This makes it easy for administrators to build upon existing lists of resources without duplication.
  • When adding directories, in BBj 19.10+, JAR files and class files contained in the directory are included automatically in the classpath. Prior to BBj 19.10, only class files were automatically included, and JAR files located in the directory were not.
  • When adding nested classpaths (19.10+), it is not possible to create circular references. For example, if classpath B contains classpath A, classpath B cannot be added to classpath A.
  • The order of items in the classpath is usually not important. However, in cases where the order matters, use the up and down arrow buttons to arrange the classpath appropriately.

Java Options

Use the Java Options tab to configure the Java module options related to Java 11+. NOTE: Any changes to the settings on this tab require restarting BBjServices before taking effect.

Java Module Options List

As with the Java Args setting referenced in the JVM section above, the options represent options passed on the command line to the java executable. Each option should be preceded by a double hyphen (--) and include a name=value pair. Each option should be included as a separate list element and can be edited in-place via the list. Bolded options are read-only and are required by BBjServices and therefore cannot be changed or removed.

Important: JavaFX Module

In Java 11+, the JavaFX module is removed from the standard installation and is an optional feature. The JAVAFX_HTMLEDIT and JAVAFX_HTMLVIEW versions of the GUI BBjHtmlEdit and BBjHtmlView require the presence of the JavaFX library (although the CHROMIUM_HTMLVIEW and CHROMIUM_HTMLEDIT versions, used by default, do not). To use these features, download the required JavaFX library for the specific server platform used by BBjServices (Windows, Linux, macOS, etc.). To make configuration simple, click the "Add JavaFX Options" button and use the file chooser to locate the installation path to the JavaFX SDK. This immediately adds all necessary configuration options to enable JavaFX on the specific server platform used by BBjServices.

See Also

Log Files

Memory Usage

Processes

Scheduling

Servers

Settings