LIST AT command

Lists the currently defined breakpoints, including the action taken when the specified breakpoint is activated. If no action is defined, z/OS® Debugger displays the NULL command.

Read syntax diagramSkip visual syntax diagramLISTAT_commandATENABLEDDISABLEDALLOCATEAPPEARANCECALLCHANGEDATEDELETEENTRYEXITGLOBALALLOCATEAPPEARANCECALLDATEDELETEENTRYEXITLABELLINELOADPATHSTATEMENTSUSPENDEDLABELLINELOADOCCURRENCEOFFSETPATHSTATEMENTSUSPENDEDTERMINATION;
AT_command
A valid AT command that includes at least one operand. The AT command must be complete except that the every_clause and command are omitted.
ENABLED
Restricts the list to enabled breakpoints. The default is to list both enabled and disabled breakpoints.
DISABLED
Restricts the list to disabled breakpoints. The default is to list both enabled and disabled breakpoints.
ALLOCATE
Lists currently defined AT ALLOCATE breakpoints.
APPEARANCE
Lists currently defined AT APPEARANCE breakpoints.
CALL
Lists currently defined AT CALL breakpoints.
CHANGE
Lists currently defined AT CHANGE breakpoints. This displays the storage address and length for all AT CHANGE subjects, and shows how they were specified (if other than by the %STORAGE function).
DATE
Lists currently defined AT DATE breakpoints.
DELETE
Lists currently defined AT DELETE breakpoints.
ENTRY
Lists currently defined AT ENTRY breakpoints.
EXIT
Lists currently defined AT EXIT breakpoints.
GLOBAL
Lists currently defined AT GLOBAL breakpoints for the specified AT-condition.
LABEL
Lists currently defined AT LABEL breakpoints.
LINE
Lists currently defined AT LINE or AT STATEMENT breakpoints. LINE is equivalent to STATEMENT.
LOAD
Lists currently defined AT LOAD breakpoints.
OCCURRENCE
Lists currently defined AT OCCURRENCE breakpoints.
OFFSET
Lists currently defined AT OFFSET breakpoints.
PATH
Lists currently defined AT PATH breakpoints.
STATEMENT
Is equivalent to LINE.
SUSPENDED
Lists all suspended breakpoints.
TERMINATION
Lists currently defined AT TERMINATION breakpoint.

If the AT command type (for example, LOAD) is not specified, LIST AT lists all currently defined breakpoints (both disabled and enabled).

Usage notes

  • To display a global breakpoint, you can specify an asterisk (*) with the LIST AT command or you can specify a LIST AT GLOBAL command. For example, if you want to display an AT ENTRY * breakpoint, specify: 
    LIST AT ENTRY *;
or
LIST AT GLOBAL ENTRY;

    If you have only a global breakpoint set and you specify LIST AT ENTRY without the asterisk (*) or GLOBAL keyword, you get a message saying there are no such breakpoints.

  • The LIST AT command cannot be used while you replay recorded statements by using the PLAYBACK commands.

Examples

  • Display information about enabled breakpoints defined at block entries. 
    LIST AT ENABLED ENTRY;
  • Display information about global DATE breakpoint entries. 
    LIST AT DATE *;
  • Display breakpoint information for all disabled AT CHANGE breakpoints within the currently executing program. 
    LIST AT DISABLED CHANGE;
  • The current programming language setting is C. Here are some assorted LIST AT commands. 
    LIST AT LINE 22;
    or 
    LIST AT OCCURRENCE SIGSEGV;
    or 
    LIST AT CHANGE structure.un.m;

Refer to the following topics for more information related to the material discussed in this topic.