OpenEdge Data Management: DataServer for Microsoft SQL Server

Chapter 6: Connecting the DataServer
Analyzing application execution with Enhanced Logger
The Enhanced Logger provides a means for either standard reporting of runtime
activity or logging diagnostic data for troubleshooting problems based on a set of
logging characteristics. The DataServer can be configured to write information to a log
file. You control the type and the degree of detail logged using a combination of log
entry types and logging levels. Log entry types are categories of information written to
the log file. Logging levels control the degree of logging detail for any given log entry
type.
The legacy qt_debug logging infrastructure only logged server information but the
Enhanced Logger framework for DataServers offers two logging contexts:
• Server context for Server-specific log entries
• Client context, which shares logging information with OpenEdge clients and
AppServer agents.
Note: Both the server and the client contexts for DataServers include some log entry
types that work in concert with one another. You can yield a detailed
understanding of the DataServer operations by merging the contexts into one
view of DataServer log activity.
LOG-MANAGER system handle attributes and methods
The LOG-MANAGER system handle controls logging settings for the OpenEdge client and
DataServer client contexts. The LOG-MANAGER attributes and methods allow you to
programmatically control the logging levels and log entry types during the execution of
your program.
Table 33 lists the function of each LOG-MANAGER system handle attribute.
Table 33: LOG-MANAGER system handle attributes (1 of 2)
Attribute Access Function
ENTRY-TYPES-LIST Readable Returns a list of all valid entry types.
LOG-ENTRY-TYPES Readable/Writable Returns/Writes a list of one or more
types of log entries.
LOGFILE-NAME Readable/Writable Returns/Writes the name of the log
file.
LOGGING-LEVEL Readable/Writable Returns/Writes the level at which log
entries are written.
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.
230 OpenEdge Data Management: DataServer for Microsoft SQL Server