Welcome to Scribd. Sign in or start your free trial to enjoy unlimited e-books, audiobooks & documents.Find out more
Download
Standard view
Full view
of .
Look up keyword or section
Like this
2Activity

Table Of Contents

About this document
Who might use this document
Accessing z/OS licensed documents on the Internet
Using LookAt to look up message explanations
How this document is organized
Terms used in this document
How to read syntax diagrams
Item Syntax example
How to send your comments
Part 1. Getting started with Debug Tool
Chapter 1. Debug Tool: overview
“Debug Tool interfaces”
Debug Tool interfaces
Full-screen mode
Batch mode
Remote debug mode
Debug Tool Utilities: creating and managing setup files
Debug Tool Utilities: converting, compiling, and linking
Debug Tool Utilities: preparing assembler programs
Debug Tool Utilities: conducting code coverage
Debug Tool Utilities: preparing IMS run-time environment
Starting Debug Tool Utilities
Compiling or assembling your program with the proper compiler options
Starting Debug Tool
Stepping through a program
Recording and replaying statements
Running your program to a specific line
Setting a breakpoint
Displaying the value of a variable
Changing the value of a variable
Skipping a breakpoint
Clearing a breakpoint
Stopping Debug Tool
Part 2. Preparing your program for debugging
Do you want to compile your program with hooks?
Do you want to reference variables during your debug session?
Collecting your resources
Chapter 5. Preparing a COBOL program
Compiling an OS/VS COBOL program
Chapter 6. Preparing a PL/I program
Compiling a PL/I program with the TEST compiler option
Chapter 7. Preparing a C program
Compiling a C program with the TEST compiler option
Compiling a C program on an HFS file system
Rules for the placement of hooks in functions and nested blocks
Rules for placement of hooks in statements and path points
“Compiling your C program with the #pragma statement”
Compiling your C program with the #pragma statement
Chapter 8. Preparing a C++ program
Compiling a C++ program with the TEST compiler option
Compiling a C++ program on an HFS file system
Rules for the placement of hooks in statements and path points
Chapter 9. Preparing an assembler program
Before you begin
Assembling your program
Creating the EQALANGX file
Assembling your program and creating EQALANGX
Link-editing your program
Chapter 10. Preparing a DB2 program
Precompiling DB2 programs for debugging
Compiling DB2 programs for debugging
Linking DB2 programs for debugging
Binding DB2 programs for debugging
Chapter 12. Preparing a CICS program
Link-editing CEEBXITA into your program
Creating and storing a DTCN profile
Preference File
Sharing DTCN repository profile items among CICS systems
Chapter 13. Preparing an IMS program
Creating a private message region or running a BMP program
Linking IMS programs for debugging
Part 3. Starting Debug Tool
Creating the setup file
Editing an existing setup file
Copying information into a setup file from an existing JCL
Entering file allocation statements, run-time options, and program parameters
Saving your setup file
Starting your program
“Special considerations while using the TEST run-time option”
Special considerations while using the TEST run-time option
Defining TEST suboptions in your program
Suboptions and NOTEST
Implicit breakpoints
Primary commands file and USE file
Running in batch mode
Starting Debug Tool at different points
Session log
Precedence of Language Environment run-time options
Example: TEST run-time options
Specifying the STORAGE run-time option
Specifying the TRAP(ON) run-time option
Chapter 16. Starting Debug Tool from a program
Starting Debug Tool with CEETEST
Usage notes
Example: using CEETEST to start Debug Tool from C/C++
Example: using CEETEST to start Debug Tool from COBOL
Example: using CEETEST to start Debug Tool from PL/I
Starting Debug Tool with PLITEST
Starting Debug Tool with the __ctest() function
Starting Debug Tool under CICS
Starting Debug Tool under MVS in TSO
Starting Debug Tool in batch
Starting Debug Tool from DB2 stored procedures: troubleshooting
Using DTCN to start Debug Tool for CICS programs
How to end your CICS debugging session
Using CEEUOPT to start Debug Tool under CICS
Using compiler directives to start Debug Tool under CICS
Using CEDF to start Debug Tool under CICS
Chapter 20. Using full-screen mode: overview
Debug Tool session panel
Session panel header
Source window
Monitor window
Log window
Displaying the source or listing file
Entering commands on the session panel
Order in which Debug Tool accepts commands from the session panel
Using the session panel command line
Issuing system commands
Using prefix commands on specific lines or statements
Using commands that are sensitive to the cursor position
Using Program Function (PF) keys to enter commands
Initial PF key settings
Retrieving previous commands
Retrieving commands from the Log and Source windows
Navigating through Debug Tool session panel windows
Moving the cursor between windows
Scrolling the windows
Scrolling to a particular line number
Finding a string in a window
Changing which source file appears in the Source window
Displaying the line at which execution halted
Recording your debug session in a log file
Creating the log file
Recording how many times each source line runs
Recording the breakpoints encountered
Setting breakpoints to halt your program at a line
Stepping through or running your program
“Stop the recording”
Stop the recording
Restrictions on accessing COBOL data
Displaying and monitoring the value of a variable
One-time display of the value of variables
Example: sample COBOL program for debugging
Halting when certain routines are called in COBOL
Modifying the value of a COBOL variable
Halting on a COBOL line only if a condition is true
Capturing COBOL I/O to the system console
Displaying raw storage in COBOL
Getting a COBOL routine traceback
Generating a COBOL run-time paragraph trace
Finding unexpected storage overwrite errors in COBOL
Halting before calling an invalid program in COBOL
“Example: sample PL/ I program for debugging”
Example: sample PL/I program for debugging
Halting when certain PL/I functions are called
Modifying the value of a PL/I variable
Halting on a PL/I line only if a condition is true
Displaying raw storage in PL/I
Getting a PL/I function traceback
Tracing the run-time path for PL/I code compiled with TEST
Finding unexpected storage overwrite errors in PL/I
Halting before calling an undefined program in PL/I
“Example: sample C program for debugging”
Example: sample C program for debugging
Halting when certain functions are called in C
Modifying the value of a C variable
Halting on a line in C only if a condition is true
Debugging C when only a few parts are compiled with TEST
Capturing C output to stdout
Calling a C function from Debug Tool
Displaying raw storage in C
Debugging a C DLL
Getting a function traceback in C
Tracing the run-time path for C code compiled with TEST
Finding unexpected storage overwrite errors in C
Finding uninitialized storage errors in C
Halting before calling a NULL C function
“Example: sample C++ program for debugging”
Example: sample C++ program for debugging
Halting when certain functions are called in C++
Modifying the value of a C++ variable
Halting on a line in C++ only if a condition is true
Capturing C++ output to stdout
Calling a C++ function from Debug Tool
Displaying raw storage in C++
Debugging a C++ DLL
Getting a function traceback in C++
Tracing the run-time path for C++ code compiled with TEST
Example: sample assembler program for debugging
Multiple compilation units in a single assembly
Halting when certain assembler routines are called
Halting on a line in assembler only if a condition is true
Getting an assembler routine traceback
Finding unexpected storage overwrite errors in assembler
Chapter 26. Customizing your full-screen session
Defining PF keys
Defining a symbol for commands or other strings
Customizing the layout of windows on the session panel
Opening and closing session panel windows
Resizing session panel windows
Zooming a window to occupy the whole screen
Customizing session panel colors
Customizing profile settings
Saving customized settings in a preferences files
DBCS
Character case and DBCS in C and C++
Character case in COBOL and PL/I
Abbreviating Debug Tool keywords
Entering multiline commands in full-screen and line mode
Entering multiline commands in a command file
Entering multiline commands without continuation
Using blanks in Debug Tool commands
Entering comments in Debug Tool commands
Using constants in Debug Tool commands
Getting online help for Debug Tool command syntax
Format for a COBOL source listing and debug file
Debug Tool commands that resemble COBOL statements
COBOL command format
COBOL compiler options in effect for Debug Tool commands
COBOL reserved keywords
Using COBOL variables with Debug Tool
“Example: assigning values to COBOL variables”
Accessing COBOL variables
Assigning values to COBOL variables
Example: assigning values to COBOL variables
Displaying values of COBOL variables
Using DBCS characters in COBOL
%PATHCODE values for COBOL
Declaring session variables in COBOL
Debug Tool evaluation of COBOL expressions
Displaying the results of COBOL expression evaluation
Using constants in COBOL expressions
Using Debug Tool functions with COBOL
Using %HEX with COBOL
Using the %STORAGE function with COBOL
Qualifying variables and changing the point of view in COBOL
Qualifying variables in COBOL
Changing the point of view in COBOL
Considerations when debugging a COBOL class
Debugging VS COBOL II programs
Finding the listing of a VS COBOL II program
Chapter 29. Debugging PL/I programs
Debug Tool subset of PL/I commands
PL/I language statements
%PATHCODE values for PL/I
PL/I conditions and condition handling
Entering commands in PL/I DBCS freeform format
Debug Tool enhancements to LIST STORAGE PL/I command
PL/I support for Debug Tool session variables
Accessing PL/I program variables
Accessing PL/I structures
Debug Tool evaluation of PL/I expressions
Supported PL/I built-in functions
“Using SET WARNING PL/ I command with built-in functions”
Using SET WARNING PL/I command with built-in functions
Unsupported PL/I language elements
Debug Tool commands that resemble C and C++ commands
Using C and C++ variables with Debug Tool
Accessing C and C++ program variables
Displaying values of C and C++ variables or expressions
Assigning values to C and C++ variables
%PATHCODE values for C and C++
Declaring session variables with C and C++
C and C++ expressions
Calling C and C++ functions from Debug Tool
C reserved keywords
C operators and operands
Debug Tool evaluation of C and C++ expressions
Intercepting files when debugging C and C++ programs
Scope of objects in C and C++
Storage classes in C and C++
Blocks and block identifiers for C
Blocks and block identifiers for C++
Example: referencing variables and setting breakpoints in C and C++ blocks
Scope and visibility of objects
Blocks and block identifiers
Displaying environmental information
Qualifying variables and changing the point of view in C and C++
Qualifying variables in C and C++
Changing the point of view in C and C++
Example: using qualification in C
Stepping through C++ programs
Setting breakpoints in C++
Setting breakpoints in C++ using AT CALL
Examining C++ objects
“Example: displaying attributes of C++ objects”
Example: displaying attributes of C++ objects
Monitoring storage in C++
Chapter 31. Debugging an assembler program
Loading an assembler program’s debug information
Restrictions for debugging an assembler program
Restrictions for debugging an assembler MAIN program
Restrictions for debugging self-modifying code
Capabilities of the disassembly view
Starting the disassembly view
To start the disassembly view:
The disassembly view
Performing single-step operations
Setting breakpoints
Displaying and modifying registers
Displaying and modifying storage
Restrictions for the disassembly view
Chapter 33. Debugging DB2 programs
Debugging DB2 programs in batch mode
Debugging DB2 programs in full-screen mode
Resolving some common problems
Chapter 35. Debugging IMS programs
Debugging IMS programs in interactive mode
Debugging IMS programs in batch mode
Debug modes under CICS
Preventing Debug Tool from stopping at EXEC CICS RETURN
Saving and restoring breakpoints
Restrictions when debugging under CICS
Fine-tuning your programs with Debug Tool
Removing hooks
Removing statement and symbol tables
Debugging without hooks, statement tables, and symbol tables
Debugging optimized COBOL programs
Debugging MVS POSIX programs
Debug Tool evaluation of HLL expressions
Debug Tool interpretation of HLL variables and constants
HLL variables
HLL constants
Debug Tool commands that resemble HLL commands
Qualifying variables and changing the point of view
Qualifying variables
Changing the point of view
Handling conditions and exceptions in Debug Tool
Handling conditions in Debug Tool
Debugging multilanguage applications
Debugging an application fully supported by Language Environment
“Using session variables across different languages”
Using session variables across different languages
Coexistence with other debuggers
“Coexistence with unsupported HLL modules”
Coexistence with unsupported HLL modules
Chapter 41. Debugging multithreading programs
Restrictions when debugging multithreading applications
Starting Debug Tool within an enclave
Viewing Debug Tool windows across multiple enclaves
Using breakpoints within multiple enclaves
Ending a Debug Tool session within multiple enclaves
Using Debug Tool commands within multiple enclaves
Part 8. Appendixes
Appendix A. Data sets used by Debug Tool
Creating personal data sets
Modifying and using a setup file
Run the program in foreground
Run the program in batch
Tip on using the IBM Distributed Debugger
Syntax for the C TEST compiler option
Syntax for the C++ TEST compiler option
Syntax for the COBOL TEST compiler option
Notices
Copyright license
Programming interface information
Trademarks and service marks
Bibliography
Debug Tool publications
High level language publications
Related publications
Softcopy publications
Glossary
Index
0 of .
Results for:
No results containing your search query
P. 1
DebugTooluser

DebugTooluser

Ratings: (0)|Views: 650|Likes:
Published by Sonia Maryland

More info:

Published by: Sonia Maryland on Mar 13, 2011
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

03/13/2011

pdf

text

original

You're Reading a Free Preview
Pages 8 to 130 are not shown in this preview.
You're Reading a Free Preview
Pages 141 to 177 are not shown in this preview.
You're Reading a Free Preview
Pages 185 to 303 are not shown in this preview.
You're Reading a Free Preview
Pages 311 to 350 are not shown in this preview.

Activity (2)

You've already reviewed this. Edit your review.
1 thousand reads
1 hundred reads

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->