Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : LOGGING-LEVEL attribute
 

LOGGING-LEVEL attribute

The level at which log entries are written to the log file.
Data type: INTEGER
Access: Readable/Writable
Applies to: DSLOG-MANAGER system handle, LOG-MANAGER system handle
Use the LOGGING-LEVEL attribute to specify the level at which log entries are written to the log file. For an OpenEdge client, the Client Logging (-clientlog) startup parameter or the LOG-MANAGER system handle's LOGFILE-NAME attribute specifies the log file. For a DataServer server, the DataServer Logging (-dslog) startup parameter specifies the log file. Each logging level specifies a different amount of information.
There are five logging levels:
Logging level
Description
0 (None)
Logs no entries. This is equivalent to turning logging off.
1 (Errors)
Logs OpenEdge error messages. This includes all error messages and is unrelated to the entry types specified. Errors continue to be logged at all higher levels.
2 (Basic)
The log entry type determines what information is logged. Each log entry type generates at least some output. This is the default.
3 (Verbose)
The log entry type determines what information is logged. Includes the information generated at levels 1 and 2.
4 (Extended)
The log entry type determines what information is logged.
By default, the logging level you specify applies to all log entry types. However, you can specify a different logging level for individual log entry types with the LOG-ENTRY-TYPES attribute or the Log Entry Types (-logentrytypes) startup parameter. The higher logging levels include the log information from the lower logging levels, in addition to the information logged at that level.
Note: If you set the LOGGING-LEVEL attribute at runtime, it resets the logging level for all log entry types to the specified value. You should use LOG-ENTRY-TYPES to change logging levels for specific log entry types at runtime. You must re-specify all the different log entry types each time that you want to change one.
The LOGGING-LEVEL attribute corresponds to the Logging Level (-logginglevel) startup parameter.
For more information about the Client Logging (-clientlog), DataServer Logging (-dslog), Log Entry Types (-logentrytypes), or Logging Level (-logginglevel) startup parameters, see OpenEdge Deployment: Startup Command and Parameter Reference, OpenEdge Data Management: DataServer for Microsoft SQL Server, OpenEdge Data Management: DataServer for Oracle, and OpenEdge Development: Debugging and Troubleshooting.