Enterprise Manager logoEM: BBjServices > Processes

Description

The BBj Processes panel provides a real-time view of all BBj programs currently running on the server, including details such as program name, user, classpath, connection time, and IP address. Administrators can monitor execution states, apply filters, and adjust refresh intervals to quickly identify active or background processes, ensuring efficient tracking and troubleshooting of system activity.

Location

Enterprise Manager logoEM NavigatorBBjServicesProcesses

Toolbar

Button Function
Shows the call stack for the selected process (es).
Sends a message to selected process (es).
Refreshes the displayed list of applications and their status
Removes/deletes selected application(s) or files from the system.

BBj Processes: More Options Dropdown

The More Options dropdown panel in BBj Processes provides additional controls for refining and monitoring process information. Administrators can enable full path visibility, adjust the automatic refresh rate, and apply multiple user-defined filters to narrow results, ensuring precise and efficient process tracking.

More Options Settings List

Settings Description
Full Path Refresh Rate
  • When unchecked, process names are displayed without their full file paths, and the refresh interval continues to update the process list at the selected rate from the dropdown menu (10, 15, 20, 30, or 60 seconds).

  • When checked, the process list includes full file paths alongside program names, with updates applied automatically at the chosen refresh interval to ensure current process information is displayed.

Use Filter
  • When unchecked, all filter fields and conditions remain disabled, preventing the user from applying criteria to refine the process list.

  • When checked, filter fields and operators become editable, allowing specific conditions such as user, program name, or process attributes to be set for narrowing visible process results.

Value Description
User Provides a selectable field for narrowing BBj process listings by username. It allows administrators to target and display only processes initiated under a specific user account, streamlining troubleshooting and monitoring in multi-user environments.
NR The NR filter lets you narrow the BBj Processes grid to show only rows where the NR is either selected or not selected. You can apply operators like equals or not equals with values such as true/checked or false/unchecked, and combine this condition with other filters using AND/OR within the standard filtering framework.
BG Filters the BG column to show or hide processes running in the background based on the chosen condition. Accepts values like true/checked or false/unchecked and can be combined with other filters using AND/OR logic.
Line Listing The Line Listing field in the BBj Processes grid so you can filter rows by the value displayed in that column. Use the filter’s comparison operators (equals, less than, greater than) with a numeric or text value and combine it with other conditions via AND/OR in the Use Filter panel to narrow the list of processes accordingly.
Classpath Applies the Classpath column in the BBj Processes grid, letting you show only processes running under a specific classpath. Use operators such as equals, or contains and enter a classpath name (addon, bbj_default) to include or exclude matching sessions. The control uses the Enterprise Manager’s standard filtering framework, allowing conditions to be combined with AND/OR logic so multiple filters can work together across different columns.

 

Value Description
equals The equals operator restricts matches to only processes with a column/field value that matches the user-entered text exactly (no partial or case sensitive matches).
greater than The greater than operator restricts matches to only processes with a column/field value that is greater than the user-entered value.
less than The less than operator restricts matches to only processes with a column/field value that is less than the user-entered value.
contains The contains operator restricts matches to only processes with a column/field value that contains the user-entered text (a partial match).
regex The regex operator restricts matches to only processes with a column/field value that matches the user-entered regular expression. This could include partial or case sensitive matches.

 

Value Description
None The None operator restricts the process list to only those that match the column/field, operator, and value entered in the first row of filtering controls.
AND The AND operator restricts the process list to only those that match the column/field, operator, and value entered in BOTH the first row of filtering controls AND the second row of filtering controls.
OR The OR operator restricts the process list to only those that match the column/field, operator, and value entered in EITHER the first OR the second row of filtering controls OR both.
 
Value Description
Field Defines the value against which the selected column filter is applied in the BBj Processes grid, allowing results to be narrowed to only those entries that meet the specified condition.

BBj Process List

The BBj Process List panel provides a real-time table of active processes, displaying details such as program name, user, status flags (NR, BG), line listing, classpath, and connection metadata. Selecting a process in the first view and expanding it, as shown in the second screenshot, reveals additional information such as IP address and system messages, enabling administrators to monitor execution context and diagnose process behavior with precision.

BBj Process List

Column Description
INFO(3,0) The INFO(3,0) column provides the process ID generated by the BBj INFO(3,0) function, uniquely identifying each running process for monitoring and management in Enterprise Manager.
Program Name Shows the path and filename of the BBj program that the process is currently executing, enabling clear identification of the running module. Useful for monitoring and troubleshooting by distinguishing one process from another when multiple programs are active.
User The User column identifies the account under which the BBj process is executing, matching the authenticated Enterprise Manager or BBjServices login.
NR This stands for Not Responding. It is the number of seconds that the process had not been responding to queries (or empty if it was responding).
BG BG (Background) indicator showing whether a BBj process is running in the background.
Line Listing Shows the program’s current executing line for each running BBj process, enabling administrators to pinpoint where execution is in real time for monitoring and troubleshooting. See: Administration Made Easier.
Classpath The BBj classpath being used by this process when the snapshot was taken.
Connect Time The time when the process established the connection with BBjServices.
IP Address The IP address of the machine that connected to start the process.
Message Displays the informational text published by the running BBj program via STBL(!SESSIONINFO); users can set this to surface status or other context for administrators viewing the grid. When the program does not set !SESSIONINFO, the column remains empty.
Process Count Shows the total number of BBj process rows currently displayed in the grid ( after any filters are applied). Updates automatically as the list refreshes or when you change filters.

Send Process Notification

Clicking the icon in the BBj Processes toolbar opens the Send Process Notification dialog, where administrators can compose and send a custom message to one or more selected processes. The dialog provides input fields for a title and message body, ensuring that targeted notifications can be delivered directly to running sessions for user communication or system alerts.

Send Process Notification Settings

Settings Description
Title Defines the subject line for the notification delivered to the selected process(es); the default value is System Message, and any text you enter becomes the caption users see with your message.
Message Defines the body of the notification that Enterprise Manager sends to the BBj process(es) you selected in the Processes grid. The text you enter is delivered together with the Title when you click OK in the Send Process Notification dialog; Cancel closes the dialog without sending anything.

The Call Stack for Selected Process(es)

The icon in the BBj Processes panel opens the Process Detail dialog when clicked, displaying detailed runtime information for the selected process. The dialog presents attributes such as program name, class, method, physical line, and user line number, providing developers or administrators with deeper insight into process execution. This step is triggered directly from the icon in the toolbar, and the detail view appears in a new panel without affecting the main process list.

The Call Stack for Selected Process(es) Column List

Column Description
Program Name The full path to the BBj program for this entry in the call stack.
Line Listing The line of code for this entry in the call stack.
Class The BBj custom object or Java class responsible for this line of code in the call stack.
Method The method of the BBj custom object or Java class responsible for this line of code in the call stack.
Physical Line # The physical line number in the BBj program for this entry in the call stack.
User Line # The user’s PRO/5 or BBj source code line number in the program for this entry in the call stack. Source code line numbers are deprecated and unless present display as -1.

See Also

BBjAdminBase

Java Settings

Log Files

Memory Usage

Scheduling

Servers

Settings

STBL Formats - BBj

BBjAPI::killSession