DSLOG-MANAGER system handle

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.

Note:

This system handle applies to the DataServer for Microsoft SQL Server as well as the DataServer for Oracle.

Syntax 

 

DSLOG-MANAGER [ :attribute | :method ]

attribute

An attribute of the DSLOG-MANAGER system handle.

method

A method of the DSLOG-MANAGER system handle.

Attributes

 

DB-CONTEXT attribute	ENTRY-TYPES-LIST attribute	HANDLE attribute
INSTANTIATING-PROCEDURE attribute	LOG-ENTRY-TYPES attribute	LOG-THRESHOLD attribute
LOGFILE-NAME attribute	LOGGING-LEVEL attribute	NUM-LOG-FILES attribute
TYPE attribute

Table 66 lists the DSLOG-MANAGER system handle attributes.

 

Table 66:

DSLOG-MANAGER system handle attributes

Attribute	Access	Function
DB-CONTEXT	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-NAME	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-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-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.

---

1

Each connection to a DataServer is its own entity. The DB-CONTEXT attribute enables you to provide different logging settings for each data source connection. The DB-CONTEXT attribute must be set to the logical database name or alias which is currently connected, prior to setting any other attributes. The attribute defaults to the unknown value. If DB-CONTEXT does not contain the value of a valid logical database name, any attempt to access other attributes of DSLOG-MANAGER fails.

2

The value returned by the LOGFILE-NAME is the default name dataserv.lg or; the name specified by the -dslog client startup parameter for self-service clients; the name specified by the -dslog startup parameter when ProBroker is started; the name specified by the srvrDSLogFile attribute in the ubroker.properties file when a Unified Broker instance is started for DataServer connections.

3

The value returned by the LOG-THRESHOLD is one of the following: the name specified by the -logthreshold client startup parameter for self-service clients; the name specified by the -logthreshold startup parameter when ProBroker is started; the name specified by the srvrLogThreshold attribute in the ubroker.properties file when a Unified Broker instance is started for DataServer connections.

4

The value returned by the NUM-LOG-FILES is one of the following: The name specified by the -numlogfiles client startup parameter for self-service clients; the name specified by the -numlogfiles startup parameter when ProBroker is started; the name specified by the srvrNumLogFiles attribute in the ubroker.properties file when a Unified Broker instance is started for DataServer connections.

Methods

 

CLEAR-LOG( ) method

WRITE-MESSAGE( ) method

 

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.