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.
|
| 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:
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. |