every_clause syntax

Most forms of the AT command contain an optional every_clause that controls whether the specified action is taken based on the number of times a situation has occurred. For example, you might want an action to occur only every 10th time a breakpoint is reached.

The syntax for every_clause is:

Read syntax diagramSkip visual syntax diagramEVERYintegerFROMintegerTOintegerEVERY
EVERY integer
Specifies how frequently the breakpoint is taken. For example, EVERY 5 means that z/OS® Debugger is started every fifth time the AT-condition is met. The default is EVERY 1.
FROM integer
Specifies when z/OS Debugger invocations are to begin. For example, FROM 8 means that z/OS Debugger is not started until the eighth time the AT-condition is met. If the FROM value is not specified, its value is equal to the EVERY value.
TO integer
Specifies when z/OS Debugger invocations are to end. For example, TO 20 means that after the 20th time this AT-condition is met, it should no longer start z/OS Debugger. If the TO value is not specified, the every_clause continues indefinitely.

Usage notes

  • FROM integer cannot exceed TO integer and all integers must be ≥ 1.
  • EVERY by itself is the same as EVERY 1 FROM 1.
  • The EVERY, FROM, and TO clauses can be specified in any order.

Examples

  • Break every third time statement 50 is reached, beginning with the 48th time and ending after the 59th time. The breakpoint action is performed the 48th, 51st, 54th, and 57th time statement 50 is reached. 
    AT EVERY 3 FROM 48 TO 59 STATEMENT 50;
  • At the fifth change of structure field member of the structure named mystruct, print a message saying that it has changed and list its new value. In addition, clear the CHANGE breakpoint. The current programming language setting is C. 
    AT FROM 5 CHANGE mystruct.member {
  LIST ("mystruct.member has changed.
              It is now", mystruct.member);
  CLEAR AT CHANGE mystruct.member;
}