tvscript Command Syntax

The syntax for the tvscript command is:

tvscript [ options ] [ filename ] [ –a program_args ]

options

TotalView and tvscript command-line options. You can use any options described in Chapter 7, “TotalView Command Syntax”. tvscript command-line options are described in the next section.

filename

The program being debugged.

–a program_args

Program arguments.

The command-line options most often used with tvscript are:

–mpi (The MPI environments supported are those listed in the Parallel tab of the File > New Program dialog box.)

–starter_args

–nodes

–np or –procs or –tasks

For more information on these command-line options, see Chapter 7, “TotalView Command Syntax”.

The syntax for using tvscript with an MPI on Blue Gene / L and Blue Gene / P systems is:

tvscript [ options ] –mpi BlueGene - np number-of-instances –starter_args
          “filename [ mpi-arguments] [-args program_args]” mpirun

–np number-of-instances

The number of processes or tasks that the starter program will create.

–starter_args

Required, with the arguments following enclosed in quotes; the application executable (filename) to be debugged must be the first argument.

–mpi-arguments

The command arguments for mpirun, such as “-cwd”,
“-mode”, and “-partition”.

-args

Command argument for mpirun that passes to the launched application on the compute node.

mpirun

Required; the executable at the end of the command line.