Starting an ORNL PVM Session

Start the ORNL PVM daemon process before you start TotalView. See the ORNL PVM documentation for information about the PVM daemon process and console program.

1. Use the pvm command to start a PVM console session--this command starts the PVM daemon. If PVM is not running when you start TotalView (with PVM support enabled), TotalView exits with the following message:

       Fatal error: Error enrolling as PVM task: pvm error

2. If your application uses groups, start the pvmgs process before starting TotalView. PVM groups are unrelated to TotalView process groups. For information about TotalView process groups, refer to Examining Groups.
    
3. Enable PVM support in TotalView using an X resource; see totalview*pvmDebugging. You need to restart TotalView after setting this new resource. For more information, refer to X Resources.

   As an alternative, you can use command-line options to the totalview command. For example:

   -pvm, which enables PVM support
   -no_pvm, which disables PVM support

   The command-line options override the X resource. For more information on, refer to TotalView Command Syntax.

4. Set the TotalView directory search path to include the PVM directories. This directory list must include those needed to find both executable and source files. The directories you use will vary, but should always contain the current directory and your home directory.

   You can set the directory search path by using an X resource or the File > Search Directory command. Refer to totalview*searchPath and Setting Search Paths for more information.

   For example, to debug the PVM examples, you can place the following directories in your search path:

     .
     $HOME
     $PVM_ROOT/xep
     $PVM_ROOT/xep/$PVM_ARCH
     $PVM_ROOT/src
     $PVM_ROOT/src/$PVM_ARCH
     $PVM_ROOT/bin/$PVM_ARCH
     $PVM_ROOT/examples
     $PVM_ROOT/examples/$PVM_ARCH
     $PVM_ROOT/gexamples
     $PVM_ROOT/gexamples/$PVM_ARCH

5. Verify that the action taken by TotalView for the SIGTERM signal is appropriate. (You can examine the current action by using the Process Window's File > Signals command. Refer to Handling Signals for more information.)

   PVM uses the SIGTERM signal to terminate processes. Because TotalView stops a process when the process receives a SIGTERM, the OpenMP process is not terminated. If you want the PVM process to terminate, set the action for the SIGTERM signal to Resend.

Continue with Automatically Acquiring PVM/DPVM Processes.