A watched directory is a specific directory that the OpenEdge Memory Profiler monitors for recording files. The default watched directory for the OpenEdge Memory Profiler is the import folder located in the <CATALINA_BASE> folder.

After you enable memory profiling on an AVM with the Profile Memory (-profileMemory) startup parameter, the memory profiler generates output recording files (.oemp) that provide detailed information about the memory usage of the ABL application for the entire run of your ABL session. These files are saved in the path that you specified for the report-dir property in the configuration file, which contains properties to initialize the AVM for memory profiling.

A recording remains incomplete while the AVM is running and actively writing snapshot data to the .oemp file. To finalize the recording session, terminate the AVM so it can write the _PreCleanup and _Exit snapshots, which indicate a normal end to memory profiling.

For more information about the configuration file properties and the Profile Memory (-profileMemory) startup parameter, see Enable the AVM for memory profiling and Profile Memory (-profileMemory) .

You need to directly copy those .oemp files to the default <CATALINA_BASE>\import watched directory so that the OpenEdge Memory Profiler can read, process, and import them.
Note:
  • Only files in the watched directory that meet all of the following criteria are eligible for automatic import:
    • Have a .oemp file extension
    • Are text files (not binary)
    • Contain a final _Exit snapshot
  • Watched directories support subfolders, and files are read recursively, but only one level deep. For example, files in /import/<subdir> are processed. Avoid placing duplicate or backup files in subfolders to prevent unintended processing.
  • Both /import and /upload directories are valid watched directories. However, the /upload directory is reserved for specialized workflows and is not part of the standard usage currently. It is recommended that you use /import as the default location.