You can specify the name of the log file to which OpenEdge writes all errors and warning messages by using the following:

  • The Client Logging (-clientlog) startup parameter
  • The LOGFILE-NAME attribute on the LOG-MANAGER system handle
  • The logFile and related properties in the openedge.properties file with OpenEdge Management or OpenEdge Explorer
Note: Use the above to log specifications to designate log file information for DataServer clients as well. The server context of DataServers, however, starts with a default log file name of dataserver.lg and uses separate mechanisms for designating a log file name. See the DataServer Guide for MS SQL Server for more information about specifying a log filename for the server context.

The following table shows how to specify the log filename.

Table 1. Specifying the log filename
Method General syntax Example
Startup parameter 
-clientlog filename
 
-clientlog mylog.log
LOG-MANAGER system handle 
LOG-MANAGER:LOGFILE-NAME = "filename".
 
LOG-MANAGER:LOGFILE-NAME = "mylog.log".
OpenEdge Management or OpenEdge Explorer, or openedge.properties file 
agentLogFile = <path-to>/<instance name>.agent.{yyyy-MM-dd}.log
 
logFile = c:\OpenEdge\WRK\oepas1.agent.2019-06-25.log
Note: After starting an ABL session using the Client Logging (-clientlog) startup parameter, another log filename can be specified in code using the LOGFILE-NAME attribute on the LOG-MANAGER system handle. In this case, OpenEdge stops writing to the log file specified by the Client Logging (-clientlog) startup parameter and starts writing to the log file specified by the LOGFILE-NAME attribute.

For a detailed description of the client logging startup parameter, see Client Logging (-clientlog). For a detailed description of the handle to the logging settings, see LOG-MANAGER system handle.

For more information on openedge.properties, see the openedge.properties.README file and see Configure logging in PAS for OpenEdge.