Totalview® for HPC Reference Guide : PART I CLI Commands : Chapter 4 Batch Debugging Using tvscript : tvscript Command Syntax
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".
Blue Gene/L and Blue Gene/P
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-processes -starter_args           "filename [ mpi-arguments] [-args program_args]" mpirun
-np
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.
Blue Gene/Q with SLURM
The syntax for using tvscript with an MPI on Blue Gene/Q systems using SLURM is:
tvscript [ options ] -mpi BlueGeneQ-SLURM -np number-of-processes -starter_args           "[srun-arguments] filename [program_args]" srun
-np
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 follow the arguments for srun.
srun-arguments
The command arguments for srun.
filename
The program being debugged.
program_args
The arguments for the program being debugged.
srun
Required; the executable at the end of the command line.
Blue Gene/Q for ANL's Cobalt Job Manager and IBM’s runjob
The syntax for using tvscript on Blue Gene/Q for ANL's Cobalt job manager and IBM's runjob: is
tvscript [ options ] -mpi BlueGeneQ-Cobalt -np number-of-processes -starter_args           "[runjob-arguments] : filename [program_args]" runjob
-np
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 follow the arguments for runjob and be separated by a colon (:).
runjob-arguments
The command arguments for runjob.
filename
The program being debugged.
program_args
The arguments for the program being debugged.
runjob
Required; the executable at the end of the command line.
Blue Gene/Q for the LoadLeveler job manager and IBM's runjob
The syntax for using tvscript on Blue Gene/Q for the LoadLeveler job manager and IBM's runjob: is
tvscript [ options ] -mpi BlueGeneQ-LoadLeveler -np number-of-processes         ‑starter_args "[runjob-arguments] ‑‑exe filename [program_args]" runjob
-np
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 follow the arguments for runjob and --exe.
runjob-arguments
The command arguments for runjob.
filename
The program being debugged.
program_args
The arguments for the program being debugged.
runjob
Required; the executable at the end of the command line.
Cray Xeon Phi
The syntax for using tvscript on Cray Xeon Phi Knights Corner (KNC) native nodes is:
tvscript [ options ] -mpi CrayKNC-aprun -np number-of-processes -starter_args           "[aprun-arguments] filename [program_args]" aprun
-np
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 follow the arguments for aprun.
aprun-arguments
The command arguments for aprun (except the -k argument).
filename
The program being debugged.
program_args
The arguments for the program being debugged.
aprun
Required; the executable at the end of the command line.
For example:
tvscript \
-create_actionpoint "tx_basic_mpi.c#98=>display_backtrace
‑show_arguments, print myid" \
-mpi CrayKNC-aprun -np 16 \
-starter_args "tx_basic_mpi" \
aprun
Cray XK7
The syntax for using tvscript on Cray XK7 is:
tvscript [ options ] -mpi CrayXK7-aprun -np number-of-processes -starter_args          
          "[aprun-arguments] filename [program_args]" aprun
-np
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 follow the arguments for aprun.
aprun-arguments
The command arguments for aprun.
filename
The program being debugged.
program_args
The arguments for the program being debugged.
aprun
Required; the executable at the end of the command line.
For example:
tvscript \
-create_actionpoint "tx_basic_mpi.c#98=>display_backtrace
‑show_arguments, print myid" \
-mpi CrayXK7-aprun -np 16 \
-starter_args "tx_basic_mpi" \
aprun