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

BASIC-LOGGING attribute

Turns on QryInfo logging for an individual query.
Data type: LOGICAL
Access: Readable/Writeable
Applies to: Query object handle
ABL does not provide QryInfo logging for individual queries at logging level 2 (Basic), by default. You must use the BASIC-LOGGING attribute to turn on logging for an individual query when the logging level of the QryInfo log entry type is set to level 2 (Basic). If the logging level of the QryInfo log entry type is level 3 (Verbose) or higher, then ABL ignores any BASIC-LOGGING attribute setting and logs query information for all queries.
To set the logging level of the QryInfo log entry type, use the LOG-ENTRY-TYPES attribute or the Log Entry Types (-logentrytypes) startup parameter with the logging level option.
To turn on logging for an individual query when the logging level is set to 2 (Basic), you must set this attribute to TRUE before a query starts. For a dynamically opened query, this is before the QUERY-PREPARE( ) method. For a statically opened query, this is before the OPEN QUERY statement. If you set this attribute to TRUE after a query starts, ABL does not provide logging for that query.
To turn off logging for an individual query when the logging level is set to 2 (Basic), you must set this attribute to FALSE. If you set this attribute to FALSE before a query completes, ABL does not write query statistics to the log.
Whenever you turn on or turn off logging for an individual query using this attribute, ABL writes a log entry to the log file indicating the query ID, the query object handle, and the name of the query.
For more information about the Log Entry Types (-logentrytypes) startup parameter, see OpenEdge Deployment: Startup Command and Parameter Reference.
For more information about query logging, see OpenEdge Development: Debugging and Troubleshooting.