Totalview® User Guide : PART II Debugging Tools and Tasks : Chapter 5 Loading and Managing Sessions : Setting up Debugging Sessions : Loading Programs from the Sessions Manager : Debugging a New Program
Debugging a New Program
To configure a new debugging session, either:
• Select A new program to launch the Program Session dialog, or
• Select File > Debug New Program from the Root or Process windows, if TotalView is already running.
The Program Session dialog launches.
 
Figure 29 – Program Session dialog
1. Enter a session name in the Session Name text box.
NOTE >> Note that 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 or Starting New Sessions in a Sessions Window".
2. Enter the name of your program in the File Name box 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 drop-down list.
If you enter a file name, TotalView searches for it in the list of directories named using the File > Search Path command or listed in your PATH environment variable.
CLI: dset EXECUTABLE_PATH
3. (Optional) Add any custom configurations or options:
— Remote debugging: Select or add a remote host, if the program is to be executed on a remote computer. See "Adding a Remote Host".
— Program arguments: Enter any program arguments into the Arguments field.
Because you are loading the program from within TotalView, you will not have entered the command-line arguments that the program needs. For detail, see Program Arguments in the In-Product Help.
— Debugging Options: See "Options: Reverse Debugging, Memory Debugging, and CUDA".
— Environment variables or standard I/O: See "Setting Environment Variables and Altering Standard I/O"
— Notes: You can add any notes to the session by selecting the Note icon (). See "Adding Notes to a Session".
4. Click Start Session. The Start Session button is enabled once all required information is entered.