Skip to main content

Configuration

The BBj Language Support plugin for IntelliJ IDEA provides comprehensive configuration options accessible through IntelliJ's Settings UI.

Accessing Settings​

Open Settings:

  • macOS: Cmd+,
  • Windows/Linux: Ctrl+Alt+S

Navigate to: Languages & Frameworks > BBj

All BBj plugin settings are located on this single application-level settings page.

BBj Environment​

BBj Home​

Path to your BBj installation directory (e.g., /opt/bbj or C:\bbj).

Features:

  • Browse button for directory selection
  • Auto-detects BBj Home if installed in standard locations (empty field triggers auto-detection)
  • Validates path by checking for BBj.properties file in cfg/ subdirectory
  • Valid paths show no error; invalid paths display a warning about missing BBj.properties

Required for most features to work:

  • Running programs
  • Resolving libraries
  • Finding configuration files

config.bbx Path​

Optional custom path to your config.bbx file.

Default: {BBj Home}/cfg/config.bbx (used when field is empty)

When to configure: Only needed if using a non-standard config.bbx location outside the BBj installation directory.

Node.js Runtime​

Node.js Path​

Path to the Node.js executable.

Features:

  • Auto-detects from system PATH
  • Validates version 18+
  • If not found, plugin can auto-download a compatible Node.js version

Required: The language server is a Node.js application and requires Node.js to run.

Classpath​

Classpath Entry​

Dropdown populated from basis.classpath.* entries in BBj.properties.

Features:

  • Dynamically updates when BBj Home changes
  • Determines which Java classes are available for code completion
  • Must match a classpath entry defined in BBj Enterprise Manager

Troubleshooting: If dropdown is empty, verify BBj Home is set correctly and BBj.properties contains basis.classpath.* entries.

Language Server​

Log Level​

Controls the verbosity of language server output.

Options: Error, Warn, Info, Debug

Default: Info

Debug level shows:

  • Detailed information about Java class loading
  • Classpath scanning details
  • Parser analysis
  • Validation timing

Features:

  • Changes take effect immediately without restarting the language server
  • View logs in the "BBj Language Server" tool window (bottom panel)

Usage:

  1. Set Log Level to Debug in settings
  2. Open the BBj Language Server tool window to see detailed diagnostics
  3. Set back to Info when done to reduce output noise

Java Interop​

The Java interop service provides Java class introspection for code completion.

Host​

Hostname for the Java interop service.

Default: localhost

Note: The host is never auto-detected — it is always a manually edited field.

Port​

Port number for the Java interop service.

Default: 5008

Auto-detect:

  • An Auto-detect checkbox sits under the Port field, checked by default.
  • While checked, the Port field is disabled (greyed out) and shows the port read from the com.basis.languageServer.addr line in the BBj Home's cfg/BBj.properties file. That line has the form host:port:enabled.
  • A hint line under the field names where the shown value came from — or, if no port could be found in BBj.properties, that 5008 is being used as the default.
  • If the enabled segment of that line reports the Java interop service as disabled in BBjServices, the detected port is still used, and the hint says the service is disabled.
  • Unchecking Auto-detect pre-fills the field with whatever value was in effect and makes it editable. Whatever port is then applied — including 5008 — is kept exactly as entered and is never silently replaced by auto-detection. Re-checking Auto-detect discards any edit and returns the field to the detected value.
  • Validates range: 1-65535
  • Must match the port BBjServices is using for the Java interop service

Effective value: The language server's startup options, the Java interop connection-health indicator, and the Settings dialog itself all use the same effective port — whichever value Auto-detect or an explicit choice currently resolves to.

When changes take effect: A port change takes effect the next time the language server starts. Applying settings restarts the language server, so the new value is picked up immediately after Apply.

Enterprise Manager​

EM URL​

URL for BBj Enterprise Manager.

Default: http://localhost:8888 (used when field is empty)

Usage: Used for BUI and DWC web runner (launching programs in browser).

EM Token Authentication​

BUI and DWC run commands require authentication with Enterprise Manager.

Authentication Flow:

  1. Go to Tools > Login to Enterprise Manager
  2. Enter your EM username and password in the dialog
  3. Plugin stores the JWT token securely in IntelliJ's PasswordSafe (credential store)
  4. Token is used automatically for subsequent BUI/DWC runs
  5. Re-authenticate if the token expires

The stored token is managed by IntelliJ's secure credential storage and persists across IDE restarts.

Run Settings​

Auto-save before run​

Checkbox to enable automatic file saving before executing run commands.

Default: Enabled

When enabled: Automatically saves the current file before executing any run command (GUI, BUI, or DWC).

Troubleshooting Configuration​

Verify BBj Home​

Check the Settings page for validation errors on the BBj Home field:

  • Valid path: No error displayed
  • Invalid path: Warning appears about missing BBj.properties

Check Classpath​

If the Classpath Entry dropdown is empty:

  1. Verify BBj Home is set correctly
  2. Check that {BBj Home}/cfg/BBj.properties exists
  3. Verify BBj.properties contains basis.classpath.* entries

Language Server Logs​

To diagnose language server issues:

  1. Set Log Level to Debug in Settings
  2. Open the "BBj Language Server" tool window (bottom panel)
  3. Look for detailed diagnostics including:
    • Java class resolution
    • Parser warnings
    • Validation details
  4. Set Log Level back to Info when done