Difference between revisions of "LIST WATCHPOINT"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{YLM to do}}
 
 
==Class==
 
Performance and Optimization
 
 
 
 
==Purpose==
 
==Purpose==
 
+
List active watchpoints when a program is being run in debug mode
  
  
Line 18: Line 12:
  
 
==Description==
 
==Description==
 
+
The LIST 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.
  
  
Line 29: Line 23:
 
|-
 
|-
 
|}
 
|}
 +
  
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
 +
debug myapp
 +
suspend
 
list watchpoint
 
list watchpoint
 +
resume
 
</code>
 
</code>
 +
  
 
==Products==
 
==Products==
 +
Recital
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Error Handling and Debugging]]
 +
[[Category:Error Handling and Debugging Commands]]

Latest revision as of 17:12, 11 November 2009

Purpose

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


Syntax

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


See Also

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


Description

The LIST 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
list watchpoint
resume


Products

Recital