A handle to logging settings for the DataServers in the current session. The DataServers use a separate log file which you can specify with the DataServer Logging (-dslog) startup parameter. The default filename is dataserv.lg.
The following table lists the DSLOG-MANAGER system handle attributes.
| Attribute | Access | Function |
|---|---|---|
| DB-CONTEXT1 | Readable/ Writable | Specifies the logical database name of a valid and connected data source for a supported db-type. It sets the system handle to a specific server context to enable access to other DSLOG-MANAGER attributes and methods. You can also set it to the alias of a connected data source. |
| 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. The default value returned by the LOG-ENTRY-TYPES attribute are the logentrytypes specified in the -Dsrv parameter when the foreign data source is connected. |
| LOGFILE-NAME2 | Readable | Returns the name of the log file. By default, the DSLOG-MANAGER uses the dataserv.lg log file. You can change the file name by using the -dslog startup parameter from the OpenEdge client or the srvrDSLogFile UBROKER property from the DataServer broker instance. The server context cannot work without a log file opened so it cannot be changed at runtime. This would risk having no log file opened in the event that the new log file name failed to open. |
| LOGGING-LEVEL | Readable/ Writable | Returns/Writes the level at which log entries are written. The default value returned by the LOGGING-LEVEL attribute is the logginglevel specified in the -Dsrv parameter when the foreign data source is connected. |
| LOG-THRESHOLD3 | 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-FILES4 | 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. |
| HANDLE | Readable | Returns a handle. |
| INSTANTIATING-PROCEDURE | Readable | Returns a procedure handle for the first, or instantiating, procedure. |
| TYPE | Readable | Returns the type of handle. |
For more information about DataServer logging, refer to the following: OpenEdge Development: Debugging and Troubleshooting, OpenEdge Data Management: DataServer for Microsoft SQL Server, and OpenEdge Data Management: DataServer for Oracle.