EM: BBjServices > Event Handlers

Description

In BBj 16.11 and higher, BBjServices Event Handlers allows administrators to manage and automate system event responses using configurable BBj programs and email notifications. Handles events related to replication issues, memory conditions, and process activity. Provides options to define notification settings, select an email service, and assign a BBj program to respond automatically. Enables proactive monitoring and maintenance of BBjServices stability through customizable event-driven actions.

Location

EM Navigator → BBjServices → Event Handlers

Toolbar

Button	Function
	Refreshes the displayed Event Handlers.

Event Handlers Settings List

Settings	Description
Notification Email Service	Uses the configured Email Service (from the Email Services node) to send Event Handlers notifications.
Recipient TO List	List of comma separated email addresses to notify when an enabled event occurs.
Notification Intervals(sec.)	Specifies the time interval (default is 600 seconds) that the system waits before sending another notification of the same event type, preventing excessive email alerts during frequent event occurrences.
Handler Program	Fully qualified filesystem path to the BBj program the Event Handlers service executes when an enabled event fires; the program must be reachable by BBjServices on the host.
Handler User	User account under which the handler program executes when an enabled event occurs, determining the permissions and environment used for the handler run.
Handler Password	Password for the user if a user is specified and if a password is required.
Handler Config	Full path to the config.bbx file to use when running the handler program.
Handler Working Dir	Full path to the working directory when running the handler program.
Handler Classpath	BBj-specific classpath name to use when running the handler program.

Event Handlers: Column Settings

Lists all available event categories and their corresponding properties, values, and descriptions, enabling configuration of monitored entities such as replication, licensing, memory usage, and BBj process events.

Event Handlers: Column Settings List

Column	Description
Catogory/Entity	Groups event sources (e.g., processes, replication, licensing, disk, memory) to scope which events you’re configuring.
Property	Names the specific condition within the selected category that can trigger a handler.
Value	Sets the numeric or text parameter used by that property as the trigger threshold/setting.
Description	Explains what the property does and how its value influences the event trigger.

Category/ Entity: Types of Events

Events are grouped together under categories. When the system triggers an event, it sends an email notification to the recipients (if configured) and/or executes the BBj handler program.  Email messages contain information relevant to the type of event being reported.

Types of Events List

Events	Description
Asynchronous Triggers	Handles event notifications initiated independently of standard processes, allowing real-time asynchronous system monitoring responses. See: Asynchronous Triggers.
BBj Processes	Monitors running BBj processes for performance, responsiveness, and status to trigger event-based administrative notifications accurately. See: Processes. Value Description Process Count Exceeds (# processes) Event triggered when the specified number of processes is reached or exceeded. 0 indicates disabled. Unresponsive Process Indication (sec.) Specifies the number of seconds a process must remain unresponsive before a notification is sent or the handler program is invoked. 0 indicates disabled. Note: Brief unresponsiveness of one or two seconds is common and does not necessarily indicate a problem with the process.
Disk Related	Triggers a notification or handler action when available disk space falls below the specified gigabyte threshold to prevent storage-related issues. 0 indicates disabled. Value Description Free Disk Space Low Threshold in gigabytes that triggers notifications/handlers when server free disk space drops below configured limit.
Licensing	Manages license-related event monitoring, including checkout failures, low available license counts, and license expiration alerts. Enables proactive notification or automated response when licensing issues occur. See: Licensing. Value Description License Checkout Failure Determines whether license checkout failure monitoring is active. Enabled triggers alerts; Disabled prevents notifications and handler execution for license issues. Available Licenses Too Low Triggers an event when the number of available licenses for specific products, such as BBj, BARISTA, WEBFORJ, WebUI, or SOFTWARE ASSET MANAGEMENT etc. falls below the defined threshold, alerting administrators to potential license shortages. 0 indicates disabled. License Expiring Monitors upcoming expiration date for active licenses such as BARISTA, BBJ, WebUI, FEATURE1, FEATURE2, etc. Triggers notifications or handler actions when license renewal thresholds are reached.
Memory Usage	Monitors JVM free memory thresholds and triggers notifications or handlers when available memory drops below. Value Description Free Memory Low(MB) Triggers an event when the free memory reported by the JVM falls below the specified amount in megabytes (MB). Due to the JVM’s garbage collection mechanism, memory usage may appear to increase even when unused objects are pending collection. 0 indicates disabled. Note: A temporary low level of free memory is normal and not necessarily indicative of a problem.
Replication	Triggers notifications or handler programs when replication issues occur, such as errors, problem files, state changes, or synchronization discrepancies between replicated systems. See: Replication

See Also

BBjAdminBase

Processes

Licensing

Log Files

Replication

Email Services