Log Threshold (-logthreshold)

Use Log Threshold (-logthreshold) to specify the file size threshold of log files.

Operating system and syntax UNIX / Windows -logthreshold n
Use with Maximum value Minimum value Single-user default Multi-user default
Client Session — — — —
n
A log file size threshold in bytes.

When the current log file becomes equal to or greater than the specified size, OpenEdge renames and saves the log file and creates a new log file. Valid values are:

  • 0 — This means there is no limit other than what the operating system imposes. Specify 0 to ignore the Number of Log Files to Keep (-numlogfiles) startup parameter setting. This is the default.
  • Between 500,000 and 2,147,483,647 — Values are in bytes (one byte typically holds one character). You can specify a file size up to 2GB, inclusive, but not lower than 500,000.

    If you specify a number lower than 500,000, a run-time error occurs and the OpenEdge process terminates.

OpenEdge names log files based on a sequence number using the following format: 

<filename>.999999.<extension>

For example, if you specify a log file named my.log, OpenEdge renames the log file to my.000001.log before creating a new log file.

Use the Client Logging (-clientlog) startup parameter to specify a log file name for ABL clients.

Note: When a non-zero value is specified for -logthreshold, only one client process at a time can open the file specified by the Client Logging (-clientlog) startup parameter. In this case it is recommended that each client session specify a different file name.

Use the DataServer Logging (-dslog) startup parameter to specify a log file name for the server context of a DataServer client. Use the Number of Log Files to Keep (-numlogfiles) startup parameter to specify the number of log files to keep.

You can also can use the LOG-THRESHOLD attribute on the LOG-MANAGER system handle to specify the file size threshold of log files. For more information, see ABL Reference.