LOG-MANAGER system handle attributes and methods
- Last Updated: January 17, 2024
- 1 minute read
- OpenEdge
- Version 12.8
- Documentation
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.
| Attribute | Access | Function |
|---|---|---|
|
Readable | Returns a character string containing a comma-separated list of all valid entry types for the current OpenEdge environment. |
|
Readable/Writable | Specifies a comma-separated list of one or more types of log entries to write to the log file. |
|
Readable/Writable | Specifies the name of log file OpenEdge uses to log messages and ABL stack trace information. |
|
Readable/Writable | Specifies the level at which log entries are written to the log file. |
|
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. |
|
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. |
|
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.
| Method | Function |
|---|---|
|
Clears all messages existing in the current client log file and leaves the file open for writing |
|
Stops an interactive or batch client from writing messages to the current log file, and closes the log file |
|
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.