LOG-MANAGER system handle attributes and methods

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").

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.