Enterprise Manager logoEM: BBjServices > Licensing

Description

When double clicked, the Licensing panel opens on the right pane. The panel displays detailed license information retrieved from the BASIS License Server (BLS) that BBjServices is communicating with. It shows installed license features, versions, count, current usage, and feature details. Users can adjust the Refresh Rate to control how frequently the license data updates and can click BLS Machine Info to view information about the license server, which may differ from the BBjServices host. Checkout activity can also be filtered using user, IP address, or connection-based criteria.

Location

EM NavigatorBBjServicesLicensing

Toolbar

Button Function
Refreshes the displayed list of applications and their status.
Duplicates the configuration or data of a selected application.

BASIS License Services (BLS)

The BASIS License Services lists each licensed feature, its version, total available license count, licenses in use, expiration status, and associated provider details. The serial number shown at the top uniquely identifies the connected BLS instance. The Auto-Refresh control sets how frequently the license data refreshes. Selecting Manual disables automatic updates until the page is manually refreshed. The BLS Machine Info button reveals server-specific license host information, distinct from the BBjServices host if configured separately.

BASIS License Services List

Setting Description
Serial Number The unique license key assigned to the BASIS License Server (BLS) that BBjServices is currently communicating with. This identifier determines which license checkouts are managed and tracked by the BLS instance.
Refresh Rate

Use this dropdown control to select the rate at which the Enterprise Manager should refresh the license checkout information shown in this tab. Select Manual to freeze the display until the Refresh button is clicked. Selecting one of the other values (sec stands for seconds) causes the Enterprise Manager to automatically refresh the display after that approximate time interval.

BLS Machine Info Provides system-level details about the BASIS License Server (BLS) supplying license features to BBjServices. When clicked, the button opens a dialog showing the BLS host’s name, IP address, operating system, architecture, and data model, which may differ from the BBjServices machine configuration.
Export

When you click the Export button License Information tab displaying all current license checkouts in Comma-Separated Values (CSV) format. This action captures a complete snapshot of active checkouts, independent of filter selections, including details such as serial number, feature, user, IP address, and session attributes.

Setting Description
Search Field Highlights all case-insensitive matches of the entered text within the displayed CSV license data. If Matches Only is checked, the view is filtered to display only rows that contain the specified text, leaving the field empty results in no highlighting or filtering.
Regular Expression
Note: The Regular Expression option is removed from the License Information tab in BBj 25.03.
Matches Only

When unchecked, the full CSV content remains visible, and any rows containing the search term are highlighted without hiding non-matching entries.

When checked, the display is filtered to show only rows that match the entered search term in the Search Field, hiding all non-matching entries.

License The name of the installed license feature.
Version The version of the license feature.
Count The maximum number of concurrent checkouts permitted for the license feature.
In Use The current number of checkouts for the license feature.
Expiration If the license feature expires then this will be the date and time it expires. If the license feature does not expire, then this will show permanent.
Features / Vendor String Any additional information provided by the feature vendor to document or explain the license and its usage.

Checkout Details

The Checkout Details section provides detailed information about license checkouts for the selected feature in the Licensing table. When active checkouts exist, each row lists the connection source and port, user name, In Use value, IP address, Per Connection setting, and Console status. When no checkouts are active, the table contains no entries. Filters above the table enable narrowing results by user name, IP address, and Per Connection setting before applying the filter.

Checkout Details List

Setting Description
User

When unchecked, the User filter is disabled and any text entered in the corresponding field is ignored.

When checked, the filter activates, and only checkout records matching the specified user name are displayed in the Checkout Details table.

IP Address

When unchecked, the IP address filter is disabled and any value entered in the associated input field is ignored.

When checked, the filter activates and narrows the Checkout Details table to entries matching the specified IP address.

Per Connection

When unchecked, the dropdown selection is disabled and the Checkout Details table ignores the Per Connection license setting when filtering results.

When checked, the filter activates and restricts the results to entries where the Per Connection value matches the selected option (Yes or No).

Yes When Yes is selected in the Per Connection dropdown, the Checkout Details table displays only checkouts that allocate a separate license for each individual connection.
No

When No is selected in the Per Connection dropdown, the Checkout Details table displays only checkouts that share a single license across multiple connections from the same user or source.

Apply Clicking the Apply button filters the Checkout Details table based on values entered in the User, IP Address, or Per Connection fields, displaying only matching records. To remove a specific filter, uncheck its corresponding box and click Apply again.
Clear Clicking the Clear button removes all active filters from the User, IP Address, and Per Connection fields, causing the Checkout Details table to refresh and show all current license checkout records without restriction.
Column Description
Connection Source / User The name of the user who checked out the license feature.
In Use The number of checkouts for the user and license feature.
IP Address The IP address of the user who checked out the license feature.
Per Connection Identifies whether multiple checkouts have been combined into a single license usage. A value of Yes confirms that collapsing has occurred, multiple sessions are sharing one license. A value of No indicates that each session is using a separate license, and no collapsing has taken place.
Console The console ID that was provided when the license feature was checked out. This is a designated value used solely to permit or deny license collapsing.

See Also

BASIS License Manager (BLM) Licensing Overview

Installing the BASIS License Service (BLS): Standalone

BASIS License Types (BLM)

Emergency Licensing (BLM & BLS)

BBjAdminBase