Source view

Tracing execution

When vWATCH64 is connected to your program, you will see the source code in vWATCH64's main window and you will be able to follow execution. If you hit F5 or click the <F5=Run> button, your program will start running and the next line to be run will be highlighted, as in the example above (line 16 is going to be run next, as indicated by the right-facing arrow and gray highlight under the source line).

You can hit F5 (or click the <F5=Run> button) to start execution of your program. As it is run, the source view will be updated to show the next line to be run. If you don't want the screen to keep jumping to different parts of the source while it's being run, you can turn off tracing by clicking the <Trace ON> button (which will turn into <Trace OFF>). Also, if you scroll up or down using the mousewheel, the scrollbar or the arrow keys in your keyboard, tracing will be automatically turned off. To pause execution hit F8 (or click the <F8=Pause> button) or, alternatively, click on the source lines. While in pause mode, you can do any of the following:

Run line by line

Using F8 key (both with vWATCH64's window or your program's window being on top) your program will run line by line, and you can follow the execution in vWATCH64's source view window.

Set a breakpoint

If you click any source line (except for lines with nonexecutable statements or blank lines/lines with only comments) you will set a breakpoint to that line, which means your program will run until it reaches that line when you hit F5. You can also set a breakpoint to the currently highlighted source line by hitting F9 (hitting it again toggles the breakpoint on/off). If you right click a line there's also an option to turn a breakpoint on/off. Lines with a breakpoint set will look like line 25 below:

Set next statement

Sometimes when you're debugging your program, you may be suspicious of a specific line or line block that could be causing issues. With set next statement you can choose which is the next line to be run, changing your program's natural order. Think of it as an external way to add a GOTO on the fly. To do so, while in pause mode, right-click the line you want to jump to and choose Set next statement.

Notice that you can't set next statement outside the current module/procedure. If you try to set the next line inside a SUB/FUNCTION while execution is paused in the main module you'll get an Ouside boundaries message:

As well as if you're inside a SUB/FUNCTION and try to set next statement outside of it:

Besides right-clicking to set the next statement, you can also use the <Set Next> button on the top bar to manually enter a line number to be run.

The same boundary rules apply. If you enter a line number beyond the total of source lines, you'll get the following error:

Run to this line

This is a handy shortcut to setting a breakpoint and hitting F5 to run. However, when you right-click a line and choose Run to this line, your program will run until that line is reached and no breakpoint will be left set. You can choose to run to a line that's in a different module/procedure, unlike with Set next statement, but bear in mind that you may be choosing to run to a line that may never be reached by your program, which will keep it running indefinitely until you manually pause it.

Search/filter

While in source view, both when your program is running and when it's paused, you can search for specific terms in your source code. To do so, just start typing. In the example below, we searched for the word PRINT, and all source lines containing it have been instantly filtered:

If you hit TAB, instead of searching in the source code, you can search in line numbers. In the example below, only lines between 16-33 and line 62 are being shown:

When you have a filtered list, you can set a breakpoint to all of them at once, by hitting F9. Clear all breakpoints by hitting F10 (or holding shift and clicking the <F10=Clear> button that will show).

Next: Variable view