Environment variables for the debugger engine

Debug engine environment variables are set in the AIX environment.

The following environment variables control the engine behavior:

Environment Variable Description
DER_DBG_LOCAL_PATH Specifies a set of paths for the debugger to use to find executable files and load libraries. The debugger will search this path before searching either the PATH environment variable or the system's library search path.
DER_DBG_PATH Specifies a set of paths for the debugger to use to find source files. These paths will be used if the debug information does not contain fully-qualified source file names.
DER_DBG_OVERRIDE Specifies a set of paths for the debugger to use to find source files. These paths are searched before DER_DBG_PATH.
DER_DBG_ADDR Specifies the default host to be used in user interface daemon mode. This can be either a host name or an IP address. The default is localhost. This is overridden by the command line parameter -qhost.

When specifying the address, you can also include the default port to be used in user interface daemon mode. To include a port number, specify DER_DBG_ADDR=<host name or address>:<port>. By default, the port number used is 8001. Any port specified with this environment variable is overridden by the command line parameter -quiport.

DER_DBG_TABGRID Specifies the interval between tabs to be used when expanding tabs in the source file view of the user interface. The default is 8.
DER_DBG_TAB If DER_DBG_TABGRID is set to 0, this gives the number of spaces to be inserted in place of each tab in source files. The default is 8.
DER_DBG_ STEP_DEBUG You can set this to SHALLOW or DEEP and INCLUDE or NOINCLUDE. Separate the values by a space or comma.
  • SHALLOW or DEEP controls whether the step-debug function only checks the immediate subroutine for debug information (SHALLOW) or keeps going until a location with debug information is found (DEEP). Deep step-debug can negatively impact performance if you have large amounts of code with no debug information.
  • INCLUDE or NOINCLUDE determines whether code in included files is treated as having debug information when performing a step-debug.
By default, this environment variable is set to SHALLOW INCLUDE (or SHALLOW,INCLUDE).
DER_DBG_NO_XWINDOW Setting this variable to N or NO allows the program being debugged to use an X Window for input/output, assuming the other conditions for using an X Window are set. Setting this variable to Y or YES suppresses the use of an X Window for the program being debugged. The default value of this variable is NO.
DER_DBG_FORK This environment variable can have any of these values:
  • PARENT
  • BOTH
  • BOTHRUN

For more information, see the related fork() handling topic.

DER_DBG_POWER_STEP If this variable is set to Y or YES, breakpoints will be suppressed during all step actions (step actions will complete, regardless of any breakpoints that are set). By default, power step is off.
DER_DBG_CICS_STEP This is a special environment variable to be used when debugging under CICS®. It causes the debugger to step normally through code that calls routines via CICS.
DER_DBG_ARRAY_REPCHANGE This environment variable can be set to YES or NO (the default value is NO). When this environment variable is set to NO and you change the representation of an array element in either the Variables or Monitors view, only that element is changed. When this environment variable is set to YES and you change the representation of an array element, the representation of all array elements in that array change.
DER_DBG_TRACE Use this environment variable to specify the location of the engine trace file.
DER_DBG_PICLDUMP Use this environment variable to specify the location of the EPDC trace file.
DER_DBG_DISPLAY Use this environment variable to override the location of the X Window display.
DER_DBG_SOURCESTEP This environment variable enforces source-stepping for the specified languages. You can set this environment variable to these value: C, CPP, C++, PLI, PL/I, RPG, COBOL, FORTRAN, NONE, and ALL. These values are not case-sensitive and can be separated by spaces or commas. The default value of this environment variable is COBOL PL/I or COBOL,PL/I.
DER_DBG_SOURCE_CHECK Use this environment variable to specify source verification checks. These valid values are not case-sensitive and can be separated by spaces or commas: DATE, NODATE, CONTENT, NOCONTENT, ALL, and NONE. The default value is NONE.
DER_DBG_CONSOLE Use this environment variable to specify the location, GUI, LOCAL, or REMOTE, of the console for the application that you are debugging. The default value is REMOTE, which repeats the console of debuggee to the debugger UI. LOCAL presents debuggee console activity only in the shell in which irmtdbgc was started. GUI starts an xterm session for the console activity of the debuggee.
DER_DBG_HIDE_SYSTEM_THREADS If this variable is set to Y or YES, system threads will be hidden. By default, system threads are hidden.

Feedback