DISPLAY WATCHPOINT

Class

Error Handling and Debugging

Purpose

Display active watchpoints when a program is being run in debug mode

Syntax

DISPLAY WATCHPOINT [TO FILE <.txt filename> | (<expC>)] | [TO PRINT]

See Also

CANCEL, DEBUG, DISPLAY BREAKPOINT, DISPLAY MEMORY, DISPLAY STATUS, DO, LIST BREAKPOINT, LIST WATCHPOINT, QUIT, RESUME, SET COMPILE, SET DEVELOPMENT, SET STEP, SUSPEND

Description

The DISPLAY WATCHPOINT command displays active watchpoints when a program is being run in debug mode. Watchpoints are memory variables to be 'watched'. A program executing in debug mode will stop and redisplay the debug popup when the value of the 'watched' variable changes.

Keyword	Description
TO <file>	The display output will be sent to the specified file. The filename can be substituted with a <expC>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".txt" will be used. The command SET PAGELENGTH governs the output file pagination and SET PAGEWIDTH defines the width of each page. Page numbers are centered on the bottom of the page according to width.
TO PRINT	The display output will be sent to a printer. The TO PRINT option will default to a local printer unless the command SET PRINTER TO \\SPOOLER is issued. The print request will then be spooled to the system printer, which is defined by the environment variable DB_PRINT.

Example

debug myapp
suspend
display watchpoint
resume