The AgentManager MBean provides comprehensive diagnostics and lifecycle management for ABL agents. Through this MBean, administrators can monitor agent health, retrieve detailed thread and session metrics, refresh agent processes, adjust dynamic session limits, capture runtime diagnostics such as stacks and profiler data, and terminate ABL sessions when required.

It has the following operations:

Operation Description Syntax
getAgents Retrieves a list of ABL agents associated with the application, including each agent’s ID, PID, and current state. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getAgents","<appName>"]}
getAgentSessions Returns detailed information about agents, including ID, PID, state, and all sessions currently associated with each agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getAgentSessions","<appName>"]}
refreshAgents Terminates all sessions across all agents for the ABL application. {"O":"PASOE:type=OEManager,name=AgentManager","M":["refreshAgents","<appName>"]}
refreshAgent Terminates all sessions associated with a specific agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["refreshAgent","<id>"]}
getAgentStatus Returns the number of threads, sessions, connections, and requests associated with the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getAgentStatus","<id>"]}
flushDeferredLog Flushes the deferred log buffer for the specified agent to the agent log file. {"O":"PASOE:type=OEManager,name=AgentManager","M":["flushDeferredLog","<appName>","<agentId>"]}
resetDeferredLog Clears the deferred log buffer for the specified agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["resetDeferredLog","<appName>","<agentId>"]}
clearAgentStatData Clears statistical data stored in the agent’s internal temp‑tables. {"O":"PASOE:type=OEManager,name=AgentManager","M":["clearAgentStatData","<id>"]}
getAgentMetrics Gets agent metrics associated with the agent ID or PID. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getAgentMetrics","<id>"]}
getThreadMetrics Retrieves metrics for all threads associated with the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getThreadMetrics","<id>"]}
getSessionMetrics Returns metrics for all ABL sessions managed by the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getSessionMetrics","<id>"]}
getSingleSessionMetrics Retrieves performance metrics for a single ABL session belonging to the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getSingleSessionMetrics","<id>",<sessionID>]}
getConnectionMetrics Retrieves metrics for client connections handled by the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getConnectionMetrics","<id>"]}
getRequestMetrics Provides metrics for requests processed by the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getRequestMetrics","<id>"]}
getAgentStacks Gets a list of all the runtime stacks for a given agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getAgentStacks","<id>"]}
getSessionStacks Gets a list of all the runtime stacks for a given ABL session running within an agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getSessionStacks","<agentID>","<sessionID>"]}
stopAgent Stops a running ABL agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["stopAgent","<agentID>",<waitToFinish>,<waitAfterStop>]}
getDynamicABLSessionLimit

Returns the dynamically configured maximum ABL session limit for the agent.

 {"O":"PASOE:type=OEManager,name=AgentManager","M":["getDynamicABLSessionLimit","<appName>","<id>"]}
resetDynamicABLSessionLimit Sets maximum sessions for the agent to maxABLSessionsPerAgent property value. {"O":"PASOE:type=OEManager,name=AgentManager","M":["resetDynamicABLSessionLimit","<appName>","<id>"]}
setDynamicABLSessionLimit Sets maximum number of ABL sessions the agent can create {"O":"PASOE:type=OEManager,name=AgentManager","M":["setDynamicABLSessionLimit","<appName>","<id>",<sessionLimit>]}
terminateABLSession Terminate an ABL session. {"O":"PASOE:type=OEManager,name=AgentManager","M":["terminateABLSession","<agentID>",<agentSessionID>,<terminateOption>]}
trackABLObjects Turns ABL object tracking on or off for the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["trackABLObjects","<agentID>",<switch>]}
trackingABLObjects Shows whether object tracking is currently active for the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["trackingABLObjects","<agentID>"]}
getABLObjectsReport Generates an object usage report for all ABL sessions within the agent. Returns null if tracking is not active or fails to generate the report. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getABLObjectsReport","<agentID>"]}
getABLSessionObjectsReport Generates an object usage report for a single ABL session. Returns null if tracking is not active or fails to generate the report. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getABLSessionObjectsReport","<agentID>",<agentSessionID>]}
trackMemoryUse Enables or disables memory usage tracking for the agent. {"O":"PASOE:type=OEManager,name=AgentManager","M":["trackMemoryUse","<agentID>",<switch>]}
trackingMemoryUse Returns whether memory use tracking is active. {"O":"PASOE:type=OEManager,name=AgentManager","M":["trackingMemoryUse","<agentID>"]}
getMemoryUseReport Generates memory usage report of the agent ABL sessions. Returns null if tracking is not active or fails to generate the report. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getMemoryUseReport","<agentID>"]}
getMemoryUseSessionReport Generates memory usage report of a specific ABL session. Returns null if tracking is not active or fails to generate the report. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getMemoryUseSessionReport","<agentID>",<agentSessionID>]}
initiateDebugger Initiates debugger. {"O":"PASOE:type=OEManager,name=AgentManager","M":["initiateDebugger","<id>","<connectString>"]}
debugTest Performs internal diagnostic operations used for debugging. {"O":"PASOE:type=OEManager,name=AgentManager","M":["debugTest","<agentID>","<operation>","<modifiers>",<iparm>,"<cparm>"]}
pushProfilerData Pushes collected profiler data to a specified URL, with optional request filters. {"O":"PASOE:type=OEManager,name=AgentManager","M":["pushProfilerData","<id>","<url>",<requestCount>,"<profilerSettings>"]}
getProfilerSettings Retrieves the agent’s active profiler settings. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getProfilerSettings","<id>"]}
dynamicPropertiesUpdate Updates agent‑level dynamic properties {"O":"PASOE:type=OEManager,name=AgentManager","M":["dynamicPropertiesUpdate","<id>","<propertiesString>"]}
getProperties Retrieves agent‑related runtime properties for the ABL service. {"O":"PASOE:type=OEManager,name=AgentManager","M":["getProperties","<appName>"]}
setProperties Sets the agent-related properties for a given ABL service. {"O":"PASOE:type=OEManager,name=AgentManager","M":["setProperties","<appName>","<PropertyName>","<PropertyValue>"]}