The LOG-MANAGER system handle attributes and methods provide a limited set of capabilities to access the logging settings for the current ABL runtime session.

The following table lists the function of each LOG-MANAGER system handle attribute.

Table 1. LOG-MANAGER system handle attributes
Attribute Access Function
ENTRY-TYPES-LIST
Readable Returns a character string containing a comma-separated list of all valid entry types for the current OpenEdge environment.
LOG-ENTRY-TYPES
Readable/Writable Specifies a comma-separated list of one or more types of log entries to write to the log file.
LOGFILE-NAME
Readable/Writable Specifies the name of log file OpenEdge uses to log messages and ABL stack trace information.
LOGGING-LEVEL
Readable/Writable Specifies the level at which log entries are written to the log file.
LOG-THRESHOLD
Readable Returns the file size threshold of log files. 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.
NUM-LOG-FILES
Readable Returns the number of rolled over log files to keep on disk at any one time, for OpenEdge session, including the current log file.
TYPE
Readable Returns the type of handle (for all system handles, "PSEUDO-WIDGET").

The following table lists the function of each LOG-MANAGER system handle method.

Table 2. LOG-MANAGER system handle methods
Method Function
CLEAR-LOG( )
Clears all messages existing in the current client log file and leaves the file open for writing
CLOSE-LOG( )
Stops an interactive or batch client from writing messages to the current log file, and closes the log file
WRITE-MESSAGE( )
Writes user messages to the current log file
Note: The CLOSE-LOG( ) method is valid only for interactive and batch clients. PAS for OpenEdge writes a message to the server log file indicating that it is invalid to use the CLOSE-LOG( ) method to close an PAS for OpenEdge log file. DataServer connections established by PAS for OpenEdge agents all share the same server log file. So, you cannot execute the CLOSE-LOG( ) method unless there is only one agent with an open DataServer connection. In this case, the method returns FALSE.

For more information on the LOG-MANAGER system handle or its attributes and method, see the LOG-MANAGER system handle reference entry in ABL Reference.