TotalView Reference Guide : Part I: CLI Commands :  CLI Commands : dga
dga
Displays Global Array variables
Format: 
dga [ -lang lang_type ] [ handle_or_name ] [ slice ]
Arguments: 
-lang
Specifies the language conventions to use. Without this option, TotalView uses the language used by the thread of interest (TOI).
lang_type
Specifies the language type to use when displaying a global array. The type must be either “c” or “f”.
handle_or_name
Displays an array. This can be either a numeric handle or the name of the array. Without this argument, TotalView displays a list of all Global Arrays.
slice
Displays only a slice (that is, part of an array). If you are using C, you must place the array designators within braces {} because square brackets ([]) have special meaning in Tcl.
Description: 
The dga command displays information about Global Arrays.
If the focus includes more than one process, TotalView prints a list for each process in the focus. Because the arrays are global, each list is identical. If there is more than one thread in the focus, the CLI prints the value of the array as seen from that thread.
In almost all cases, you should change the focus to d2.< so that you don’t include a starter process such as prun.
Examples: 
dga
Displays a list of Global Arrays, for example:
lb_dist
Handle -1000
Ghosts yes
C type $double[129][129][27]
Fortran Type \
$double_precision(27,129,129)
 
bc_mask
Handle -999
Ghosts yes
C type long[129][129]
Fortran Type $integer(129,129)
 
dga bc_mask (:2,:2)
Displays a slice of the bc_mask variable, for example:
bc_mask(:2,:2) = {
(1,1) = 1 (0x00000001)
(2,1) = 1 (0x00000001)
(1,2) = 1 (0x00000001)
(2,2) = 0 (0x00000000)
}
 
dga -lang c -998 {[:1]{:1]}
Displays the same bc_mask variable as in the previous example in C format. In this case, the command refers to the variable by its handle.

Related Topics