Technical data

onbreak

CR-106 ModelSim Commands ModelSim EE/SE Command Reference

onbreak

The onbreak command is used within a macro; it specifies a command to be

executed when running a macro that encounters a breakpoint in the source code.

Using the onbreak command without arguments will return the current onbreak

command string. Use an empty string to change the onbreak command back to its

default behavior (i.e., onbreak ""). In that case, the macro will be interrupted after

a breakpoint occurs (after any associated bp command

(CR-40) string is executed).

onbreak commands can contain macro calls.

Syntax

onbreak

{[<command> [; <command>] ...]}

Arguments

Any VSIM command can be used as an argument to onbreak. If you want to use

more than one command, use a semicolon to separate the commands, or place

them on multiple lines. The entire command string must be placed in curly braces.

It is an error to execute any commands within an onbreak command string

following a run

(CR-139), run -continue, or step (CR-151) command. This

restriction applies to any macros or Tcl procedures used in the onbreak command

string. Optional.

Examples

onbreak {exa data ; cont}

Examine the value of the HDL item data when a breakpoint is encountered. Then continue

the run command

(CR-139).

onbreak {resume}

Resume execution of the macro file on encountering a breakpoint.