NextGen TotalView for HPC User Guide : PART I An Introduction to NextGen TotalView for HPC : Chapter 2 Creating and Managing Sessions : Starting a Session from your Shell
Starting a Session from your Shell
There are a number of ways to start NextGen TotalView for HPC so a session is created and ready to begin when TotalView opens.
NOTE >> If you need features currently not supported in the NextGen TotalView for HPC UI (see "Introducing NextGen TotalView for HPC"), you can launch TotalView by invoking totalview without the flag -newUI. For example: totalview
NOTE >> If you have set the environment variable TVNEWUI to True, omit the flag -newUI in the commands below. See "Introducing NextGen TotalView for HPC" for more information.
Debugging a Program
totalview -newUI executable
Starts TotalView and loads the executable program.
Debugging a Parallel Program
totalview -newUI -args mpirun -np 4 ./mpi_program
Starts TotalView and loads a four-process MPI program.
Debugging a Core File
totalview -newUI executable corefile
Starts TotalView, loads the executable program, and an associated corefile. You can use wild cards in the core file name.
Debugging a Replay Recording File
totalview -newUI executable replay-recording-file
Starts TotalView, loads the executable program, and the replay-recording-file from a previous debugging session for which a ReplayEngine recording was saved to the named file.
Passing Arguments to the Program Being Debugged
totalview -newUI executable -a args
Starts TotalView and passes all the arguments following the -a option to the executable program. When using the -a option, it must be the last TotalView option on the command line. Delimit multiple arguments with spaces.
totalview -newUI -args executable args
Similar to above, but uses the command line option -args to specify that the executable program and arguments follow.
Loading a Session
totalview-newUI -load_session session-name
Starts TotalView and the named session.
RELATED TOPICS 
Parallel preferences when debugging a parallel program