To configure preferences of the OpenEdge Memory Profiler tool, you can use a configuration file. By default, you can import a maximum of two recordings simultaneously on a PAS for OpenEdge instance. However, to change this default behavior, you can modify the batch.config configuration file in the <WRKDIR>/oemp/openedge directory according to your requirements and available operating system (OS) resources.

To modify the batch configuration file:
  1. Locate the batch.config file in the <CATALINA_BASE>/openedge folder of your PAS for OpenEdge instance. Open the file in a text editor to make the necessary changes.

    The batch.config file opens.

    Table 1. Example batch.config file 
     {
    "watchdog": {
        "enabled": true,
        "interval": 60
    },
    "maxImports": 2,
    "stuckDelay": 120000,
    "endpoint": {
        "secure": false,
        "host": "127.0.0.1",
        "port": 8880,
        "webapp": "batch"
    },
    "locations": [{
        "path": "UPLOAD",
        "auto": false,
        "delete": false
    }, {
        "path": "CATALINA_BASE/import",
        "auto": true,
        "delete": false
    }]
}
  2. The file contains the following sections that you can modify as required:
    Table 2. batch.config sections
    Sections Description
    watchdog Manages a standalone AVM process (ABL procedure) that regularly monitors if recording files are ready for import. Valid properties of the watchdog section are:
    • enabled—Facilitates automatic import of recording files, when set to true. By default, it is set to true.
    • interval—Determines how often the watchdog process scans for available, unprocessed recording files that are ready for import. The default interval is 60 seconds (1 minute).
    maxImports Limits the total number of recording files that can be imported simultaneously, which should be determined by the OS resources available for the PAS for OpenEdge instance. For example, an OS image that has been allocated a greater amount of CPU and memory should be able to load more recording files than a virtual machine (VM) with restricted resources. The default is set to two recordings at a time.
    Note: Progress recommends that you adjust the maxImports setting to higher value only if you understand the potential performance impact based on the limitations of your system hardware.
    endpoint Establishes the APSV endpoint designated for import requests. By default, endpoint uses the same PAS for OpenEdge instance, utilizing port 8880 on the local system within the batch ABL Web Application.
    locations Specifies paths that will be scanned for .oemp files and provides the option to automatically import any unprocessed files. While every API or endpoint that requests a list of files automatically uses the specified paths, the watchdog.enabled property described previously controls the auto-import ability globally for the PAS for OpenEdge instance.
    By default, locations defines two directories used for importing data, each with specific behaviors:
    • "path": "UPLOAD"—Specifies the <CATALINA_BASE>/upload directory. The setting "auto": false indicates that the files placed in this directory are not imported automatically. This directory is reserved for API calls that upload multipart-form data to a designated location within the PAS for OpenEdge instance.
    • "path": "CATALINA_BASE/import"—Specifies the <CATALINA_BASE>/import directory. The setting "auto": true indicates that the files placed in this directory are imported automatically. This directory serves as the default location for user-supplied files intended for auto-import.
    You can configure multiple watched directories for importing .oemp files, with the flexibility to enable or disable automatic import for each location. Files placed in directories configured with "auto": true are processed automatically, while those with "auto": false must be imported manually.
    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.

    The Recordings home page displays an informational banner that presents a comma-separated list of directories configured under the locations section of the batch.config file in the <WRKDIR>/oemp/openedge directory. For more information, see Recordings.

    Note: By default, watchdog.enabled and locations.auto are set to true, which automatically imports any unprocessed files available in the CATALINA_BASE/import folder.