Use Profile Memory (-profileMemory) to enable memory profiling for an ABL application during an OpenEdge client session (that is, for an ABL client or a Progress Application Server (PAS) for OpenEdge agent).

Operating system and syntax UNIX / Windows -profileMemory config-file
Use with Maximum value Minimum value Single-user default Multi-user default
Client Session — — — —
config-file
The configuration file containing properties used to initialize memory profiling. Unless an absolute path is given, the AVM looks for the configuration file in the current working directory. A config-file is required.

The memory profiling properties supported in a config-file are listed in the following table:

Table 1. Configuration file properties
Property Default Description
cadence N 10 seconds Specifies how often (in seconds) to take a regular snapshot. N is a non-negative value indicating the number of seconds between snapshot generations.

If N is non-zero, a snapshot is generated at least N seconds after the previous snapshot generation. However, a snapshot is not generated if there are no changes to the memory profile since the prior snapshot (for example, when the application is paused or waiting for user input).

If N is set to 0, then there is no regular snapshot generation. In this case, the only snapshots are those generated programmatically and those generated by the system.

Note: System-generated snapshots include the _AUTO, _EndOfRequest, _PreCleanUp, and _Exit snapshots.
Description string Empty string ("") Can be used to distinguish one .oemp report from another and/or provide useful information about the origin of the .oemp file. string is a user defined description. It can be a single token or a quoted string. The maximum length retained is 80 characters. Anything beyond that is truncated. The provided description is output as a field in the header of the .oemp file.
report-dir directory Current working directory The path to a directory where memory profile snapshots are written to an output recording file. The path can be absolute or relative. If it is a relative path, it is relative to the current working directory.

If directory is not specified, the current working directory is used.
SnapshotEndOfRequest R 10
Note: Applies to Progress Application Server (PAS) for OpenEdge only.

R is a non-negative value indicating the frequency with which to generate an _EndOfRequest snapshot.

For example, if R is 5, an _EndOfRequest snapshot is generated at the end of every 5th request. If R is 1, then an _EndOfRequest snapshot is generated at the end of every request. If R is 0, then no _EndOfRequest snapshots are generated.

All property names are case insensitive.

A # character in the first column of a line in the config-file indicates a comment.

A warning message is issued for missing or invalid property values, however memory profiling is still enabled using the default values.

Notes

  • To use default values, specify an empty config-file.
  • If the config-file is absent or unreadable, a warning message is issued and memory profiling is not enabled for the session.
  • If the AVM cannot create an output file for the memory profile recording, memory profiling is not enabled for the session.
  • If a file already exists of the same name as the output file, then the AVM adds _NNNNN (where NNNNN is a five-digit unique number) to the process id to create a unique output file name.
  • Memory profiling is enabled for the life of the process (ABL client or Progress Application Server (PAS) for OpenEdge agent). The config-file is read once by the process when it starts up. New ABL sessions added to the PAS for OpenEdge agent operate according to the config-file settings when the file was read at process start-up.
  • For more information on memory profiling, see Profile memory in Troubleshoot ABL Applications.