TotalView supports the popular parallel execution models MPI and MPICH, OpenMP, ORNL SGI shared memory (shmem), Global Arrays, and UPC.
Starting an MPI Program
MPI programs use a starter program such as mpirun to start your program. You can start these MPI programs in two ways:
• With the starter program under TotalView control. In this case, you enter the name of the starter program on the command line.
• Using the UI, in which case the starter program is not under TotalView control. In this case, you enter program information into the Parallel Session Dialog from within the Session Editor.
Programs started using the UI have some limitations: program launch does not use the information you set for single-process and bulk server launching, and you cannot use the Attach Subset command.
Starting MPI programs using the Session Editor is the recommended method and is described here. For examples using a starter program, see Starting a Session from your Shell.
Parallel Session Dialog
From the Start Page, select Debug a Parallel Program to launch the Parallel Session dialog.
1. Session and Program Details
Figure 19 – Parallel Session: Session and Program Details
Session Details: Enter a session name in the Session Name field.
NOTE >> Any previously entered sessions of the same type are available from the Session Name dropdown box. Once selected, you can change any session properties and start your debug session. See "Editing a Previous Session"
Program Details
— File Name: Enter the name of your program or press Browse to browse to and select the file. You can enter a full or relative path name. If you have previously entered programs here, they will appear in a dropdown list.
If you enter a file name and the UI cannot find it, it displays the path in red; however, TotalView searches for it in the list of directories listed in your PATH environment variable. See "Search Path".
— Arguments: Enter any arguments to be sent to your program.
Because you are loading the program from within the UI, you need to enter the command-line arguments that the program requires.
2. Parallel Details
Figure 20 – Parallel Session: Parallel Details
— Parallel System: Select which parallel system profile TotalView should use when starting your program. This profile can be one that TotalView provides, one created for your site, or one that you create. (For information, see the “MPI Startup” appendix in the TotalView for HPC Reference Guide.)
— Tasks: Enter a number indicating how many tasks your program should create.
If your system has a default value and you want to use it, enter a value of 0 (zero).
If your system has no default value or you want to override the default, enter a value of 1 or greater.
— Nodes: (System-dependent) Enter a number indicating how many nodes your program should use when running your program. (Not all systems use this value, so this field may not be visible.)
— Additional Starter Arguments: If your program’s execution requires that you use arguments to send information to the starter process such as mpirun or poe, enter them in this field. (In contrast, if you need to use arguments to send information to your program, enter those arguments in the Arguments field under Program Details.)
