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 tvscript command-line options 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 -procsor -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 -npnumber-of-processes-starter_args "filename[ mpi-arguments] [-argsprogram_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 mpirunthat 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 -npnumber-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 -npnumber-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 -npnumber-of-processes ‑starter_args"[runjob-arguments] ‑‑exefilename[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 -npnumber-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 -npnumber-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