Multi-Session agent initiated graceful shutdown
- Last Updated: February 11, 2026
- 1 minute read
- OpenEdge
- Version 13.0
- Documentation
If a severe error occurs, such as a worker thread crash, then the
Multi-Session agent initiates a graceful shutdown of itself. The shutdown process
causes the multi-session agent to redirect all new requests to a new multi-session
agent and records a message in the Syslog (UNIX) or Eventslog (Windows) file and
then generates Protrace. As part of the shutdown process, the multi-session agent
creates a new file, pasoe-agent-crash-trace.process-id.
The Protrace and pasoe-agent-crash-trace.process-id files are placed in the $WRKDIR/InstanceName/work directory.
The pasoe-agent-crash-trace-process-id file collects the deferred logs and ABL call stacks of
other running requests and also captures all the other information to help debug the
root cause of the failure.
When the multi-session agent initiates a graceful shutdown of itself, it waits
to complete any of the active requests. The default wait time is 600000 milliseconds
(10 minutes). You can customize the wait time by updating the completeActiveReqTimeout=600000 parameter in the openedge.properties file.