Refresh agents on a PAS for OpenEdge Instance
- Last Updated: May 18, 2026
- 1 minute read
- OpenEdge
- Version 12.2
- Videos
This video introduces refresh agents command in PAS for OpenEdge to terminate all sessions within a multi-session agent so that updates to an ABL application can be made in real-time. The refresh agents feature is available as a TCMAN command as well as a REST and JMX API.
The refresh agents feature allows online schema updates to an application which provides high availability for a PAS for OpenEdge instance. The command may also improve memory leaks in an ABL application.
Warning: Do not use the
refresh task
while the PAS instance is serving active requests or has stuck or busy sessions.
refresh unconditionally terminates all ABL sessions in the MS
Agent immediately—any in-progress requests could be cut without a graceful drain,
which can result in data loss, transaction rollbacks, or corrupted client state.
This task is intended for code deployment during a scheduled quiet period when no
user activity is expected. Before using refresh, run the
trim tasks above to gracefully terminate any active or
lingering sessions.For more information, see Refresh agents in an ABL application.
Additionally, you can visit the following topics for usage
information:
- TCMAN Reference: Refresh agents in an ABL application (jmx refreshagents)
- OEJMX Queries: Refresh agent query and Refresh all agents query.
- REST API: Refresh all ABL sessions of one or all agents. Refresh agents is also implemented in the Swagger UI. For more information, see Use Swagger UI to explore management REST APIs