AT LABEL command (remote debug mode)

Gives z/OS® Debugger control when execution reaches the statement label that you specify. For C and PL/I programs, if multiple labels are associated with a single statement, z/OS Debugger gains control at each label that you set an AT LABEL breakpoint for. For COBOL programs, you can issue AT LABEL commands for multiple labels on the same statement, but for any group of labels that are associated with a single statement, z/OS Debugger gains control for that statement only once.

Read syntax diagramSkip visual syntax diagramAT LABELstatement_label*;
*
Sets a breakpoint at every LABEL

Usage notes

  • If you set a breakpoint for a specific label (for example, AT LABEL MYLABEL), and AT GLOBAL LABEL command is also set, the remote debugger stops only one time.
  • z/OS Debugger does not support the AT LABEL command for VS COBOL II programs.
  • A COBOL statement_label can have only the form of – name.
  • A LABEL breakpoint in remote mode is limited to labels in the currently executing compile unit.
  • For more information about restrictions for the AT LABEL command, see Usage notes on AT LABEL command

Example

Set a breakpoint at Label create in the currently qualified block.

AT LABEL create;