The OLT environment file (dertrenv.dat) is stored on the machine where the OLT viewer is running.
On Windows NT/2000, the file
can be found in your %userprofile%\DbgProf directory.
On AIX, the file is in your
$HOME/.DbgProf directory.
The dertrenv.dat file contains the following variables, which are explained below:
OLT_TRC_OLT_VER=OLT9 OLT_TRC_SRV_HOST=localhost OLT_TRC_SRVAPP_PORT=2102 OLT_TRC_SRVCLT_PORT=2202 OLT_TRC_DOROLLOVER=false OLT_TRC_ROLLOVER=100000 OLT_TRC_SRV_UID1=6666 OLT_TRC_SRV_UID2=9999 OLT_TRC_SRV_TGTDIR=%DER_DRIVER_PATH%\\bin; OLT_TRC_EV_DIR=%DER_DRIVER_PATH%/temp
OLT_TRC_OLT_VER=OLT9
This value represents the OLT version number (for example, Version 9).
OLT_TRC_SRV_HOST=localhost
OLT_TRC_SRV_HOST=$HOSTNAME
If you run the OLT server separately from the OLT viewer, the OLT_TRC_SRV_HOST value in
the dertrenv.dat file on the viewer machine must point to the location of the OLT server.
OLT_TRC_SRVAPP_PORT=2102
OLT_TRC_SRVCLT_PORT=2202
The OLT server attempts to listen for events on TCP/IP port 2102. If it cannot connect to
both this port and to port 2202, the OLT server will not come up. If you change these numbers (for example, if the ports are busy and
you cannot start the OLT server) and run the OLT Viewer and OLT Server on separate machines, you must
ensure that those numbers are identical in the dertrenv.dat files on both machines.
This does not apply if you are running the Debugger, server, and viewer on the same machine.
OLT_TRC_DOROLLOVER=false
This value indicates whether circular log support is enabled (true or false). If true,
only a specified number of events are logged in a trace. Once that number is reached, the
oldest events are deleted as new events arrive. The number of events logged is determined
by the IVB_TRC_ROLLOVER value.
OLT_TRC_ROLLOVER=100000
Number of events that can be logged before the OLT server rolls over.
OLT_TRC_SRV_UID1=6666
OLT_TRC_SRV_UID2=9999
These values are PIN numbers that validate the OLT viewer and server pair.
OLT_TRC_SRV_TGTDIR=%DER_DRIVER_PATH%\\bin
OLT_TRC_SRV_TGTDIR=$DER_DRIVER_PATH/bin
This value specifies the location of the file dertrdsc. This file tells the OLT
viewer how to display events. By default, this location is the bin directory.
OLT_TRC_EV_DIR=%DER_DRIVER_PATH%/temp
OLT_TRC_EV_DIR=/TMP
This value determines which directory the trace files are stored to and retrieved from. By
default, event trace files are stored in the directory defined by %DER_DRIVER_PATH%/temp
(or /tmp on AIX). If you are unsure about the directory, enter set DER_DRIVER_PATH
on a command line (echo $DER_DRIVER_PATH on AIX). To save and retrieve event
trace files from a different directory, enter a new path in the viewer, from File
> Preferences > OLT. To open any previously-saved files, you must first
move them to your new default directory.
Note: If you change a value in the dertrenv.dat file, it does not take effect until you restart the OLT server and viewer.
Preparing for an OLT and IBM Distributed Debugger session
Tracing a distributed application
Distributed debugging using OLT