Server Context Log File Naming
- Last Updated: January 17, 2024
- 1 minute read
- OpenEdge
- Version 12.8
- Documentation
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.
The values for DSLOGDIR and -dslog can be set as described in the following table:
| 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 |