OLT troubleshooting - OLT environment file

The OLT environment file (dertrenv.dat) is stored on the machine where the OLT viewer is running.

ngwin.gif (1069 bytes) On Windows NT/2000, the file can be found in your %userprofile%\DbgProf directory.
ngaix.gif (991 bytes) 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).

ngwin.gif (1069 bytes)OLT_TRC_SRV_HOST=localhost
ngaix.gif (991 bytes)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.

ngwin.gif (1069 bytes)OLT_TRC_SRV_TGTDIR=%DER_DRIVER_PATH%\\bin
ngaix.gif (991 bytes)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.

ngwin.gif (1069 bytes)OLT_TRC_EV_DIR=%DER_DRIVER_PATH%/temp
ngaix.gif (991 bytes)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.

ngrelt.gif (466 bytes)
Preparing for an OLT and IBM Distributed Debugger session
Tracing a distributed application
Distributed debugging using OLT