dactions

Displays information, saves, and reloads action points

Format:

Displays information about action points

dactions [ ap-id-list ] [ -at source-loc ] [ -enabled | -disabled ]

Saves action points to a file

dactions -save [ filename ]

Loads previously saved action points

dactions -load [ filename ]

Arguments:

ap-id-list

A list of action point identifiers. If you specify individual action points, the information displayed is limited to these points.

If you omit this argument, TotalView displays summary information about all action points in the processes in the focus set. If one ID is entered, TotalView displays full information for it. If more than one ID is entered, TotalView just displays summary information for each.

-at source-loc

Displays the action points at source-loc.

-enabled

Only shows enabled action points.

-disabled

Only shows disabled action points.

-save

Writes information about action points to a file.

-load

Restores action point information previously saved in a file.

filename

The name of the file into which TotalView will read and write action point information. If you omit this filename, TotalView writes them to a file named program_name.TVD.breakpoints, where program_name is the name of your program.

Description:

The dactions command displays information about action points in the processes in the current focus. The information is printed; it is not returned.

This command also lets you obtain the action point identifier. You will need to use this identifier when you delete, enable, and disable action points.

Note:   The identifier is returned when the action point is created. It is also displayed when the target stops at an action point.

You can include specific action point identifiers as arguments to the command when detailed information is required. The -enabled and -disabled options restrict output to action points in one of these states.

You cannot use the dactions command when you are debugging a core file or before TotalView loads executables.

The -save option tells TotalView that it should write action point information to a file so that either you or TotalView can restore your action points at a later time. The -load option tells TotalView that it should immediately read in the saved file. If you use the filename argument with either of these options, TotalView either writes to or reads from this file. If you do not use this argument it uses a file named programname.TVD.breakpoints where programname is the name of your program. This file is written to the same directory as your program.

The information saved includes expression information associated with the action point and whether the action point is enabled or disabled. For example, if your program's name is foo, it writes this information to foo.TVD.breakpoints.

Note:   TotalView does not save information about watchpoints.

If a file with the default name exists, TotalView can read this information when it starts your program. When TotalView exits, it can create the default. For more information, see File > Preferences within TotalView's Help system.

Command alias:

You may find the following alias useful:

Alias	Definition	Meaning
ac	{dactions}	Displays all action points

Examples:

ac -at 81

Displays information about the action points on line 81. (Notice that this example uses the alias instead of the full command name.) Here is the output from this command:

ac -at 81
1 shared action point for group 3:
    1 addr=0x10001544 [arrays.F#81] Enabled
        Share in group: true
        Stop when hit: group

dactions 1 3

Displays information about action points 1 and 3, as follows:

2 shared action points for process 1:
    1 addr=0x100012a8 [arrays.F#56] Enabled
    3 addr=0x100012c0 [arrays.F#57] Enabled

dfocus p1 dactions

Displays information on all action points defined within process 1.

dfocus p1 dactions -enabled

Displays information on all enabled action points within process 1.