Try OpenEdge Now
skip to main content
Startup Command and Parameter Reference
Startup Parameter Descriptions : Log Threshold (-logthreshold)
 

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 or agent. 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 OpenEdge Development: ABL Reference.