z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

|
Portability
Related Information
touch
dbx — Use the debugger
Format
Description
POSIX.2, X/Open Portability Guide, UNIX systems.
The –c option is an extension of the POSIX standard.
Appendix I also explains how to set the local time zone with the TZ environment
variable.
dbx [options] [executable-file [program-arguments ...]]
dbx [options] [attach-type] process-id
dbx [options] -C core-file
dbx is a source-level debugger for z/OS UNIX System Services. It provides an
environment to debug and run C and C++ programs, as well as performing machine
level debug. You can carry out operations such as the following:
v Examine object files
v Run a program in a controlled environment
v Set breakpoints at selected statements or run the program one line at a time
v Debug using symbolic variables and display them in their correct format
v View an MVS dump
v Attach to a running program, and perform debugging operations.
The executable-file argument is an load module produced by a compiler. To perform
source-level debugging, you need to compile your executable with symbolic
information. This is accomplished by specifying the –g or –Wc,debug compiler flags
on the compiler command line.
Note: If the object file is not compiled with the –g or –Wc,debug option on the
c89/cc/c++ command, or if the user compiles with optimization, the
capabilities of the dbx command will be reduced.
The core-file argument is an MVS dump that exists as a file in the z/OS UNIX file
system or in an MVS data set.
dbx allows the end user to customize its behavior via two files that are processed
during initialization. These are .dbxsetup and .dbxinit . Each file can contain a list
of dbx subcommands that will be run before the dbx prompt is displayed. During
startup, dbx will first search for these files in the current working directory and then
in the user’s $HOME directory. If a file is found, it is parsed and the search for that
specific file terminates. Use a text editor to create a .dbxsetup or .dbxinit file.
Any subcommands in the .dbxsetup file are executed before the debug target
program is loaded. This allows the user to tailor dbx’s operational behavior during
date
Chapter 2. Shell command descriptions 183