Micro Focus Enterprise Developer 3.0 for Eclipse > Programming > Mainframe Programming > PL/I Programming > CodeWatch User's Guide > CodeWatch Commands > Watch

Watch

Use

Sets watchpoints on specified variables.

Command Syntax

WATCH variable
      [/SILENT|/NSILENT]
      [/IGNORE|/NIGNORE]
      [/SKIP=n]
      [/ACTION[action-list]
      [/IF{logical-expr}]

where:

variable: Specifies the variable to be watched

n: Is the value you assign to the skip counter

action-list: Specifies a set of one or more CodeWatch commands separated by semicolons

logical-expr: Can be any expression that may occur in the source language program, including references to simple as well as aggregate (such as array, record, and structure elements) type variables, returning a boolean value

Description

Watchpoints are used to monitor any changes to data. The WATCH command designates the given variable to be watched. When the contents of the watched variable change, program execution stops and control is returned to the debugger.

Restrictions

The Watch variable cannot be a NONCONNECTED array reference.
The Watch variable cannot be a multi-dimensional array with array slices.
If the Watch variable is BASED, and its memory was allocated via ALLOCATE and subsequently freed via FREE, the watchpoint must be manually removed via the NWATCH command (cwcmd) or via the applicable UI method; otherwise, CodeWatch will continue to monitor the freed memory location.