IBM OLT and Distributed Debugger
Release Notes
Debugger table of contents
Concepts (Distributed Debugger)
About Distributed Debugger
Overview
Source and Control Panes
Value Panes
When to attach
Remote debugging
Debug on demand
Optimized code debugging
Recursion and debugging
Heap errors
Breakpoints
Exception handling
UNIX call handling during debugging
exec() handling
fork() handling
system() handling
Postmortem debugging
Postmortem debugging on AIX
Unusual debugger behavior (AIXonly)
Limitations during postmortem debugging
Postmortem debugging on OS/2
Stages of postmortem debugging: OS/2 local debugging only
Errors during UNIX workstation postmortem debugging
Separate debug information
Multithreaded programs (OS/2)
Tasks (Distributed Debugger)
Establishing a debugging environment
Setting environment variables for the debugger
Preparing a program for debugging
Writing a program for debugging
Compiling a program for debugging
Starting the debugger
Starting the debugger for local debugging
Starting the debugger for debugging compiled languages remotely
Starting the debugger for debugging interpreted Java remotely
Starting the debugger on OS/2
Starting the debugger user interface daemon
Enabling and disabling debug on demand
Attaching to a local running process
Attaching to a remote running process
Attaching to a running Java Virtual Machine
Debugging a Java applet
Working with breakpoints
Setting a line breakpoint
Setting a function breakpoint
Setting a method breakpoint
Setting an address breakpoint
Setting a storage change breakpoint
Setting a watchpoint
Setting a load occurrence breakpoint
Setting a deferred breakpoint
Setting a conditional breakpoint
Setting multiple breakpoints
Viewing set breakpoints
Modifying breakpoint properties
Enabling and disabling breakpoints
Deleting a breakpoint
Controlling program execution
Running a program
Stepping through a program
Skipping over sections of a program
Halting execution of a program
Restarting a program
Selecting debugger recognized exceptions
Inspecting variables
Adding a variable or expression to the Monitors pane
Viewing the contents of a variable or expression
Changing the contents of a variable
Inspecting registers
Viewing the contents of a register
Viewing the contents of a floating-point register
Changing the contents of a register
Adding a register to the Monitors pane
Inspecting storage
Viewing a location in storage
Changing the representation of storage contents
Changing the contents of a storage location
Adding a new Storage Monitor pane for an expression or register
Enabling and disabling a monitored expression
Enabling tool tip evaluation for variables
Changing the representation of monitor contents
Postmortem debugging
Debugging dump files
Obtaining a dump file
References (Distributed Debugger)
idebug command
irmtdbgj command
irmtdbgc command
idod command
Step commands
Optional breakpoint parameters
Program profiles
Supported Java Virtual Machine arguments
Supported expressions
C/C++ supported data types
C/C++ supported expression operands
C/C++ supported expression operators
C/C++ compiler options on workstation UNIX platforms
Supported data types for Java programs
Interpreted Java expressions supported
Compiler options for debugging
Interpreted Java compiler options
Environment variables
PATH
DPATH
CLASSPATH
INCLUDE
LIBPATH
DER_DBG_CASESENSITIVE
DER_DBG_DEEP_STEP_DEBUG
DER_DBG_PATH
DER_DBG_TAB
DER_DBG_TABGRID
Limitations
Remote debug limitations
OnException | OffException
Start @ITRAPPER;
OutputPath | Path
Trapper parameter file
DumpNumber | Number
LogFile
TraceChild
UserExit
OLT table of contents
Concepts (OLT)
Overview
Supported platforms and languages
Execution modes
Display modes
Partial-order display
Real-time display
How to read the trace
Trace symbols
Selected event
Performance analysis
Circular log support
Multi-programmer support
Tasks (OLT)
Preparing for an OLT session
Preparing for an OLT session on workstations
Compiling application code for OLT
Enabling OLT for Component Broker
Enabling OLT for WebSphere Standard Edition
Enabling OLT for WebSphere Advanced Edition
Preparing for an OLT session on AS/400
Compiling AS/400 application code for OLT
Preparing an AS/400 environment for OLT
Preparing for an OLT session on OS/390
Compiling OS/390 application code for OLT and distributed debugging (CB)
Preparing an OS/390 host environment for OLT (CB)
Preparing an OS/390 C++ client environment for OLT (CB)
Preparing an OS/390 Java client environment for OLT (CB)
Preparing a Windows NT C++ client environment for OLT (CB)
Preparing a Windows NT Java client environment for OLT (CB)
Preparing an OS/390 host environment for OLT (Standard)
Tracing a distributed application
Starting the OLT server and viewer on separate workstations
Running multiple instances of OLT on the same host
Setting method breakpoints on the trace
Disabling or re-enabling method breakpoints
Distributed debugging using OLT
Debugging servlets, EJBs, and business objects from OLT
Debugging client applications from startup
Debugging in step-by-step mode
Debugging from a remote workstation
Debugging a Java client
Debugging an ActiveX client (ComponentBroker)
Debugging JNI
Navigating the trace
Scrolling the trace
Reordering trace lines
Tagging an event
Finding an event
Saving the current trace to a file
Opening an existing trace file
References (OLT)
OLT environment file
OLT commands
Java commands for tracing and debugging
Java commands: Starting a Java client for OLT and Distributed Debugger enablement
Java commands: Debugging a Java client from startup
Java commands: Starting the Debugger engine remotely
Component Broker Object Level Trace examples
Tracing and debugging a C++ client and C++ business object in step-by-step mode (Windows NT)
Tracing and debugging a Java client and C++ business object (Windows NT)
Tracing and debugging a C++ client and C++ business object on AIX
Tracing and debugging a Java client from startup (Windows NT)
Tracing and debugging a Java client and business object (Windows NT)
Tracing and debugging a C++ client and C++ business object on Solaris
Tracing and debugging a C++ client and C++ business object on OS/390
WebSphere Standard and Advanced Edition examples
WebSphere Standard Edition: tracing and debugging a servlet
WebSphere Advanced Edition: tracing and debugging a servlet
Troubleshooting
Installation and startup
Distributed debugging
Browsers