Debugging SGI MPI Applications

TotalView can acquire processes started by SGI MPI version 3.1, which is part of the Message Passing Toolkit (MPT) 1.2 package.

Message queue display is supported by release 1.3 of the Message Passing Toolkit. See Displaying the Message Queue Graph for message queue display.

SGI MPI programs are normally started with the mpirun command. You would use a similar command to start an MPI program under TotalView's control:

    totalview mpirun -a mpirun-command-line

This invokes TotalView and tells it to show you the machine code for SGI MPI mpirun. Since you are not usually interested in debugging this code, use the Process > Go command to let the program run.

The SGI MPI mpirun command runs and starts all MPI processes. After TotalView acquires them, it asks if you want to stop them at startup. If you answer yes, TotalView halts them before they enter the main program. You can then enter breakpoints.

If you set a verbosity level that allows informational messages, TotalView also prints a message showing the name of the array and the value of the array services handle (ash) to which it is attaching.

Attaching to an SGI MPI Job

To attach to a running SGI MPI job, attach to the SGI MPI mpirun process that started the job. The procedure for attaching to an mpirun process is the same as the procedure for attaching to any other process. For details, see Attaching to Processes.

Once you have attached to the SGI MPI mpirun process, TotalView displays the same dialog as it does with MPICH.