OpenEdge Data Management: DataServer for Microsoft SQL Server

Connecting the DataServer
6–20
Table 6–6: DSLOG-MANAGER system handle attributes
Attribute Access Function
DB-CONTEXT 1
Readable/
Writable
Specifies the logical database name of a valid and
connected data source for a supported db-type. It
set the system handle to a specific server context
to enable access to other DSLOG-MANAGE 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
LOGFILE-NAME 2
LOGGING-LEVEL Readable/
Writable
Returns 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 was connected.
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.
Returns 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 was
connected.
LOG-THRESHOLD 3 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-FILES 4 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-PROC
EDURE
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.