Refresh agents on a PAS for OpenEdge Instance
- Last Updated: May 18, 2026
- 2 minute read
- OpenEdge
- Version 13.0
- Documentation
- 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
- REST API:
- "Refresh all ABL session of one or all agents" in PAS for OpenEdge Administration Tools Reference
- Refresh agents is also implemented in the Swagger UI. For more information, see "Use Swagger UI to explore managent REST APIs" in Manage Progress Application Server (PAS) for OpenEdge.