actionpoint

Displays the subcommands that you can use. The CLI responds by displaying these four action subcommands. There are no arguments to this subcommand.

Retrieves the values of one or more action point properties. The other-args argument can include one or more property names. The CLI returns values for these properties in a list whose order is the same as the names you enter.

If you use the -all option instead of the object-id, the CLI returns a list containing one (sublist) element for each object.

Lists the action point properties that TotalView can access. There are no arguments to this subcommand.

Sets the values of one or more properties. The other-args argument contains property name and value pairs.

The TV::actionpoint command lets you examine and set the following action point properties and states:

The number of addresses associated with an action point.

A single line of code can generate multiple instruction sequences. For example, there may be several entry points to a subroutine, depending on where the caller is. This means that an action point can be set at many addresses even if you are placing it on a single line.

Each individual actionpoint block is an instruction that TotalView may replace with a trap instruction. (When a trap instruction is encountered, the operating system passes control to the debugger.)

Each block can be enabled or disabled separately. This property type returns a list with in which 1 indicates if the block is enabled and 0 if it is disabled.

This is the only property that can be set from within TotalView. All others are read-only

Indicates that another action point shares at least one of the action point blocks. If this condition exists, the block is conflicted. If a block is conflicted, TotalView completely disables the action point.

The conflicted property is 1 if the actionpoint is conflicted, and 0 if it is not.

The location of every action point is represented by a string. Even action points set by clicking on a line number are represented by strings. (In this case, the string is the line number.)

Sometimes, this string is all that is needed. Usually, however, more context is needed. For example, a line number needs a file name.

A value (either 1 or 0) indicating if the action point is enabled. A value of 1 means enabled. (settable)

The expression to execute at an action point. (settable)

The language in which the action point expression is written.

The length in bytes of a watched area. This property is only valid for watchpoints. (settable)

The source line at which the action point is set. This property is not valid for watchpoints.

The group that must arrive at a barrier for the barrier to be satisfied. (settable)

A value (either 1 or 0) indicating if the action point is active in the entire share group. A value of 1 means that it is. (settable)

A value that indicates what is stopped when a barrier is satisfied (in addition to the satisfaction set). Values are process, group, or none. (settable)

A value that indicates what is stopped when an action point is hit (in addition to the thread that hit the action point). Values are process, group, or none. (settable)

The object’s type. (See type_values for a list of possible types.)

Lists values that can TotalView can assign to the type property: break, eval, process_barrier, thread_barrier, and watch.

Dumps all the properties for action point 1. Here is what your output might look like:

address:	0x1200019a8
enabled:	0
expression:
id:	1
language:
length:
line:	/temp/arrays.F#84
satisfaction_group:
satisfaction_process:
satisfaction_width:
share:	1
stop_when_done:
stop_when_hit:	group
type:	break
type_values:	break eval process_barrier thread_barrier watch