Try OpenEdge Now
skip to main content
Debugging and Troubleshooting
Troubleshooting Resources : Logging in OpenEdge : Logging infrastructure overview : LOG-MANAGER system handle attributes and methods
 
LOG-MANAGER system handle attributes and methods
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 22. 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 23. 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. WebSpeed agents and AppServer servers write a message to the server log file indicating that it is invalid to use the CLOSE-LOG( ) method to close a WebSpeed or AppServer server log file. DataServer connections established by Webspeed or AppServer 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 OpenEdge Development: ABL Reference.