Using z/OS Debugger commands within multiple enclaves
Some z/OS® Debugger commands and variables have a specific scope for enclaves and processes. The table below summarizes the behavior of specific z/OS Debugger commands and variables when you are debugging an application that consists of multiple enclaves.
| z/OS Debugger command | Affects current enclave only | Affects entire z/OS Debugger session | Comments |
|---|---|---|---|
%CAAADDRESS |
X | ||
AT GLOBAL |
X | ||
AT TERMINATION |
X | ||
CC START |
X | ||
CC STOP |
X | ||
CLEAR AT |
X | X | In addition to clearing breakpoints set in the current enclave, CLEAR AT can clear global breakpoints. |
CLEAR DECLARE |
X | ||
CLEAR LDD |
X | ||
CLEAR VARIABLES |
X | ||
Declarations |
X | Session variables are cleared at the termination of the process in which they were declared. | |
DISABLE |
X | X | In addition to disabling breakpoints set in the current enclave, DISABLE can disable global breakpoints. |
ENABLE |
X | X | In addition to enabling breakpoints set in the current enclave, ENABLE can enable global breakpoints. |
LIST AT |
X | X | In addition to listing breakpoints
set in the current enclave, LIST AT can list global
breakpoints. |
LIST CALLS |
X | Applies to all systems except MVS batch and MVS with TSO. Under MVS batch
and MVS with TSO, LIST
CALLS lists the call chain for the current active thread
in the current active enclave. For programs containing interlanguage communication (ILC), routines from previous enclaves are only listed if they are coded in a language that is active in the current enclave. Note: Only
compile units in the current thread will be listed for PL/I multitasking
applications.
|
|
LIST CC |
X | Only source statements for the current enclave will be displayed. | |
LIST EXPRESSION |
X | You can only list variables in the currently active thread. | |
LIST LAST |
X | ||
LIST LDD |
X | ||
LIST NAMES CUS |
X | Applies to compile unit names. In
the Debug Frame window, compile units in parent enclaves are marked
as deactivated. |
|
LIST NAMES LABELS |
X | You can only list variables in the currently active thread. | |
LIST NAMES TEST |
X | Applies to z/OS Debugger session variable names. | |
MONITOR GLOBAL |
X | Applies to Global monitors. | |
PLAYBACK ENABLE |
X | The PLAYBACK command
that informs z/OS Debugger to
begin the recording session. |
|
PLAYBACK DISABLE |
X | The PLAYBACK command
that informs z/OS Debugger to
stop the recording session. |
|
PLAYBACK START |
X | The PLAYBACK command
that suspends execution of the program and indicates to z/OS Debugger to enter
replay mode. |
|
PLAYBACK STOP |
X | The PLAYBACK command
that terminates replay mode and resumes normal execution of z/OS Debugger. |
|
PLAYBACK BACKWARD |
X | The PLAYBACK command
that indicates to z/OS Debugger to perform STEP and RUNTO commands
backward, starting from the current point and going to previous points. |
|
PLAYBACK FORWARD |
X | The PLAYBACK command
that indicates to z/OS Debugger to perform STEP and RUNTO commands
forward, starting from the current point and going to the next point. |
|
PROCEDURE |
X | ||
SET AUTOMONITOR1 |
X | Controls the monitoring of data items at the currently executing statement. | |
SET COUNTRY1 |
X | This setting affects both your application
and z/OS Debugger.
At the beginning of an enclave, the settings are those provided by Language Environment® or your operating system. For nested enclaves, the parent's settings are restored upon return from a child enclave. |
|
SET EQUATE1 |
X | ||
SET INTERCEPT1 |
X | For C, intercepted streams or files
cannot be part of any C I/O redirection during the execution of a
nested enclave. For example, if stdout is intercepted
in program A, program A cannot then redirect stdout to stderr when
it does a system() call to program B. Also, not supported
for PL/I. |
|
SET NATIONAL LANGUAGE1 |
X | This setting affects both your application
and z/OS Debugger.
At the beginning of an enclave, the settings are those provided by Language Environment or your operating system. For nested enclaves, the parent's settings are restored upon return from a child enclave. |
|
SET PROGRAMMING LANGUAGE1 |
X | Applies only to programming languages in which compile units known in the current enclave are written (a language is "known" the first time it is entered in the application flow). | |
SET QUALIFY1 |
X | Can only be issued for load modules, compile units, and blocks that are known in the current enclave. | |
SET TEST1 |
X | ||
TRIGGER condition2 |
X | Applies to triggered conditions.2 Conditions can be either an Language Environment symbolic feedback code, or a language-oriented keyword or code, depending on the current programming language setting. | |
TRIGGER AT |
X | X | In addition to triggering breakpoints
set in the current enclave, TRIGGER AT can trigger
global breakpoints. |
Note:
SETcommands other than those listed in this table affect the entire z/OS Debugger session.- If no active condition handler exists for the specified condition, the default condition handler can cause the program to end prematurely.