Session management
- Last Updated: February 13, 2026
- 2 minute read
- OpenEdge
- Version 13.0
- Documentation
The SessionManager MBean provides control over sessions, client
connections, active requests, and session termination. Administrators use this MBean to
diagnose performance issues, manage long‑running or idle sessions, terminate problematic
requests, and retrieve essential session‑level metrics.
It has the following operations:
| Operation | Description | Syntax |
|---|---|---|
getSessions |
Fetches a brief list of all ABL sessions associated with an ABL service. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getSessions","<appName>"]} |
getSession |
Returns detailed information about a specific ABL session identified by its session ID. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getSession","<sessionID>"]} |
getAgentConnections |
Retrieves brief list of all agent connections associated with an ABL service. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getAgentConnections","<appName>"]} |
getAgentConnection |
Returns details about the agent connection associated with a specific ABL session. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getAgentConnection","<sessionID>"]} |
getClientConnections |
Provides a detailed list of client connections across all ABL services. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getClientConnections","<appName>"]} |
getClientConnection |
Retrieves details about the client connection tied to a specific ABL session. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getClientConnection","<sessionID>"]} |
getActiveRequests |
Returns all currently active requests running on the server. Used to identify long‑running or stuck requests. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getActiveRequests","<appName>","<requestId>",<timeLimitMs>]} |
getIdleSessions |
Lists all ABL sessions that have been idle beyond a specified timeout (in milliseconds). | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getIdleSessions","<appName>",<Timeout>]} |
getHungClientConnections |
Returns client connections that have been active longer than the specified timeout. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getHungClientConnections","<appName>",<Timeout>]} |
terminateSession |
Terminates the specified broker session. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["terminateSession","<appName>","<sessionID>",<terminateOption>]} |
terminateFreeABLSessions |
Terminates free ABL sessions based on the specified parameters. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["terminateFreeABLSessions","<agentID>",<numOfSessions>]} |
terminateFreeABLSession |
Terminates ABL session, if it is not bound to a client and not running a request. Returns false if session is bound to a client or currently running a request. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["terminateFreeABLSession","<agentID>",<agentSessionID>]} |
cancelRequest |
Attempts to cancel a running request by raising the ABL STOP condition in the corresponding session. |
{"O":"PASOE:type=OEManager,name=SessionManager","M":["cancelRequest","<sessionID>","<requestID>"]} |
trimClients |
Trims or disconnects client connections that exceed a specified timeout threshold. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["trimClients",<timeOutms>]} |
getMetrics |
Retrieves session‑related runtime metrics for the ABL service. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getMetrics","<appName>"]} |
resetMetrics |
Clears the session manager metrics for a given ABL service. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["resetMetrics","<appName>"]} |
getProperties |
Retrieves the session-related properties for a given ABL service. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["getProperties","<appName>"]} |
setProperties |
Sets the session-related properties for a given ABL service. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["setProperties","<appName>","<PropertyName>","<PropertyValue>"]} |
addAgent |
Adds a new agent to the ABL application. | {"O":"PASOE:type=OEManager,name=SessionManager","M":["addAgent","<appName>"]} |