Release 10.1A: OpenEdge Development:
Debugging and Troubleshooting

> ## 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 OpenEdge session during run-time.

> Table 5–2 lists the function of each `LOG-MANAGER` system handle attribute.

> Table 5–2: 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 4GL 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 5–3 lists the function of each `LOG-MANAGER` system handle method.

> Table 5–3: 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.

> For more information on the `LOG-MANAGER` system handle or its attributes and methods, see the `LOG-MANAGER` system handle reference entry in OpenEdge Development: Progress 4GL Reference .

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095