Server Context Log File Naming

When no log file name is specified for the server context, its default name continues to be dataserv.lg in the working directory, just as it was using the legacy qt_debug logging options.

Both OpenEdge client startup and ProBroker startup allow the server context log file to be specified with the -dslog parameter. For a DataServer broker instance specified to the Unified Broker, the srvrDSLogFile attribute in the ubroker.properties file specifies the server context log file name.

If the server context log file name is specified without any path, it is placed in the working directory. If it is specified with a relative path name, it searches for that relative path under the absolute path of the working directory unless the $DSLOGDIR environment variable is set. When $DSLOGDIR is set, it overrides the working directory as the root path for placing the server log file. The relative path name of the specified log name is combined with this absolute path to place the server context file. If you specify a full absolute path for the server context log file name, it is used exclusively to set the log file path.

Table 53. Parameters for creating log file
DSLOGDIR value	-dslog value	Result
An existing directory	dslog name	dslog file is created in the DSLOGDIR
An existing directory	Qualified path and dslog name	dslog file is created in the dslog path
An existing directory	Not set	Log file with default name is created in DSLOGDIR
A new/non-existent directory	dslog name	dslog file is created in working directory
Not set	Qualified path and dslog name	dslog file is created in the dslog path
Not set	Not set	Log file with default name is created in working directory
Not set	A new/non-existent path and dslog name	Log file with ds_ prefix is created in working directory
Not set	dslog name	dslog file is created in working directory