Native Inspect Manual (H06.13+, J06.03+)

Access Errors.....................................................................................................................30
Commands For Interactive Memory Debugging......................................................................30
Handling Events.....................................................................................................................30
Assessing Your Location After an Event.................................................................................30
Switching Between Debuggers (Inspect and Visual Inspect)...........................................................31
Stopping Native Inspect..........................................................................................................32
Differences Between Native Inspect and WDB and GDB..............................................................32
2 Using Native Inspect.................................................................................33
Quick Start for Inspect Users....................................................................................................33
Preparing to Debug Using Native Inspect...................................................................................33
Compiling and Transferring Program Files.............................................................................34
Gaining Control of a Process Using Native Inspect.................................................................34
Optionally Loading Symbols Information...............................................................................34
Optionally Determining the Compilation-Time Source File Name..............................................36
Optionally Configuring a Search Path for Your Source Files.....................................................36
Advancing Execution to main() in C/C++ Programs................................................................36
Sample Native Inspect Session (C++ Program)...........................................................................37
Launching a C++ Program Under Native Inspect Control.........................................................37
Listing the Source...............................................................................................................38
Tracing the Stack...............................................................................................................38
Controlling Execution..........................................................................................................38
Printing Variables and Memory............................................................................................39
Stepping Execution Into a Function.......................................................................................39
Setting a Memory Access Breakpoint (MAB)..........................................................................39
Stopping Mid-Statement......................................................................................................40
Ending the Program and Debugging Session.........................................................................40
Sample Native Inspect Session (COBOL Program).......................................................................40
Starting a Program Under Native Inspect Control...................................................................40
Listing Source and Setting a Breakpoint at a Line Number.......................................................41
Stepping Execution.............................................................................................................41
Displaying a Level 88 Condition Name.................................................................................41
Examining a Record...........................................................................................................42
Modifying a Record Field....................................................................................................43
Examining Tables...............................................................................................................43
Setting a Breakpoint on a Nested Program Unit.....................................................................45
Debugging Copy Libraries..................................................................................................45
Terminating the Debugging Session......................................................................................46
3 Using Native Inspect With COBOL Programs...............................................47
Understanding how Native Inspect finds Data Items....................................................................47
Handling of SOURCE and COPY Directives................................................................................47
Displaying Lines Included by SOURCE and COPY Directives....................................................47
Setting Breakpoints at Lines Included by SOURCE and COPY Directives....................................47
Displaying Source Lines...........................................................................................................47
Specifying Variables and Tables...............................................................................................48
Specifying Variables...........................................................................................................48
Specifying Tables...............................................................................................................48
Specifying Tables With Variable Upper Bounds.....................................................................49
Specifying Level 88 Condition Names..................................................................................49
Displaying Variables...............................................................................................................50
Displaying Level 88 Condition Names..................................................................................50
Displaying Argument Values................................................................................................50
Displaying Unprintable Characters.......................................................................................50
Displaying the Length of the COBOL Variables.......................................................................50
Handling of REDEFINES and RENAMES....................................................................................51
4 Contents