Appendix A. Debug Tool commands supported in remote debug mode
You can use some Debug Tool commands in remote debug mode through the following
methods:
- Enter these commands through the Debug
Engine Command field or the Debug Console
Commands window of the remote debugger.
- When you add a breakpoint through the remote debugger, specify
these commands in the Action field,
which is in the Optional Parameters section
of the Add a Breakpoint task. You
must have one of the following products to use this feature:
- IBM Debug Tool plug-in for Eclipse
- compiled language debugger component of Rational Developer for System z, Version 7.5 or later
- Use them in a commands or preferences file.
Using any of these methods, you can use the following commands
in remote debug mode:
- AT CHANGE command (remote debug mode)
- AT ENTRY command (remote debug mode)
- AT LOAD command (remote debug mode)
- AT STATEMENT command (remote debug mode)
- CALL %VER command
- CHKSTGV command
- CLEAR LOAD, which is described in CLEAR command
- DESCRIBE CHANNEL, which is described in DESCRIBE command
- DESCRIBE CUS, which is described in DESCRIBE command
- DESCRIBE LOADMODS, which is described in DESCRIBE command
- DISABLE CADP, which is described in DISABLE command
- DISABLE DTCN, which is described in DISABLE command
- ENABLE CADP, which is described in ENABLE command
- ENABLE DTCN, which is described in ENABLE command
- LIST CADP, which is described in LIST DTCN or CADP command
- LIST CONTAINER command
- LIST DTCN, which is described in LIST DTCN or CADP command
- LOAD command
- LOADDEBUGDATA command (for assembler only)
- NAMES DISPLAY command
- NAMES EXCLUDE command
- NAMES INCLUDE command
- QUERY ASSEMBLER, which is described in QUERY command
- QUERY AUTOMONITOR, which is described in QUERY command
- QUERY BROWSE MODE, which is described in QUERY command
- QUERY CURRENT VIEW, which is described in QUERY command
- QUERY DEFAULT DBG, which is described in QUERY command
- QUERY DEFAULT LISTINGS, which is described in QUERY command
- QUERY DEFAULT MDBG, which is described in QUERY command
- QUERY DEFAULT VIEW, which is described in QUERY command
- QUERY DISASSEMBLY, which is described in QUERY command
- QUERY DYNDEBUG, which is described in QUERY command
- QUERY EQAOPTS, which is described in QUERY command
- QUERY EXPLICITDEBUG, which is described in QUERY command
- QUERY IGNORELINK, which is described in QUERY command
- QUERY INTERCEPT, which is described in QUERY command
- QUERY LDD, which is described in QUERY command
- QUERY LOCATION, which is described in QUERY command
- QUERY LOG, which is described in QUERY command
- QUERY REWRITE, which is described in QUERY command
- QUERY WARNING, which is described in QUERY command
- QUIT, which is described in QUIT command
- QUIT ABEND, which is described in QUIT command
- QUIT DEBUG, which is described in QUIT command
- QQUIT command
- SET ASSEMBLER ON/OFF command
- SET ASSEMBLER STEPOVER command
- SET AUTOMONITOR command
- SET DEFAULT DBG command
- SET DEFAULT LISTINGS command
- SET DEFAULT MDBG command
- SET DEFAULT VIEW command
- SET DISASSEMBLY command
- SET DYNDEBUG command
- SET EXPLICITDEBUG command
- SET IGNORELINK command
- SET INTERCEPT command (COBOL, remote debug mode)
- SET LDD command
- SET LOG OFF, which is described in SET LOG command
- SET LOG ON, which is described in SET LOG command
- SET QUALIFY CU, which is described in SET QUALIFY command
- SET QUALIFY LOAD, which is described in SET QUALIFY command
- SET REWRITE command (remote debug mode)
- SET WARNING command (C, C++, COBOL, and PL/I)
You can use the following commands in remote debug mode only in the Action field, which is in the Optional Parameters section of the Add a Breakpoint task:
Through the Debug Engine Command field
or the Debug Console Commands window,
you can view a list of Debug Tool commands supported in remote debug mode
by doing one of the following tasks:
- Press CTRL+SPACE BAR.
- Type in the first few letters of a command name. Press CTRL+SPACE
BAR. A list of Debug Tool commands that begin with those same letters
is displayed.
To use this feature, you must use one of the following products:
- IBM Debug Tool plug-in for Eclipse
- compiled language debugger component of Rational Developer for System z, Version 7.5 or later
Specifying the location of source, listing, or separate debug file in remote debug mode
by using environment variables
Debug Tool retrieves the information it displays in the Source window
from one of the following files:
- source or listing files
- separate debug files (.dbg files or SYSDEBUG)
- EQALANGX files
- .mdbg files (module map files)
If your build or run your applications on UNIX System Services and you move these files, you
can use the following environment variables to specify the new location
of these files:
- EQA_SRC_PATH
- Specifies the location of the source, listing, SYSDEBUG, or
EQALANGX files.
- EQA_DBG_PATH
- Specifies the location of the .dbg file.
- EQA_MDBG_PATH
- Specifies the location of the .mdbg file.
The following example shows you how to declare an environment variable
that specifies the location of a listing file:
export EQA_SRC_PATH="/u/build1/try1:/u/build2/try3:evaf.test.listing"
You
can have a combination of data sets and UNIX file
system paths separated by a colon (:) and enclosed in quotation marks.
Adding an Eclipse-based plug-in that can read,
create, update, and delete DTCN profiles
You can download an example of an Eclipse-based plug-in
that can manipulate DTCN profiles from the workstation by following
the instructions in topic "Installing
the IBM Debug Tool DTCN and DTSP Profile Manager plug-in", which is in Debug Tool User’s Guide.
Adding an Eclipse-based plug-in that can read,
create, update, and delete DTCN profiles
You can download an example of an Eclipse-based plug-in
that can create and delete your TEST runtime options (EQAUOPTS) data
set from the workstation by following the instructions in topic "Installing the IBM Debug Tool DTCN and DTSP Profile Manager plug-in",
which is in Debug Tool User’s Guide.