etl2otf
Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2
Formats an event log (.etl) file as a set of open trace format (.otf) files.
For examples of how to use this command, see Examples.
Syntax
etl2otf <.etl_file_name> [/removeIntraCollectiveEvents]
etl2otf /?
Parameters
Parameter |
Description |
|---|---|
<.etl_file_name> |
Specifies the name of the event log file that you want to format. |
/removeIntraCollectiveEvents |
Skips all API events that occur during a Message Passing Interface (MPI) collective operation. If you specify this parameter, you must place it after the name of the .etl file. This parameter is supported only for Windows® HPC Server 2008 R2. |
/? |
Displays Help at the command prompt. |
Remarks
The etl2otf command is a Message Passing Interface (MPI) program. Run it with mpiexec to distribute formatting work across each node that is used in a job. The result files are located on each node.
The etl2otf command applies clock corrections as it formats the binary trace data as open trace format files, if you used the mpicsync command to create clock-corrected .etl files.
The etl2otf command creates files that have the file name formats described in the following table.
File name format |
Example file name |
Description |
|---|---|---|
.etl_file_name_otf.otf |
mpi_trace_12.1.0.etl_otf.otf |
OTF master file |
.etl_file_name_otf.0.def |
mpi_trace_12.1.0.etl_ otf.0.def |
OTF global definitions file |
.etl_file_name_otf. rank.events |
mpi_trace_12.1.0.etl_ otf.1.events, mpi_trace_12.1.0.etl_ otf.2.events,... |
Event files, one for each MPI rank |
Examples
To format the event log named mpi_trace_12.1.0.etl as an .otf file, use the following command:
mpiexec /cores 1 etl2otf mpi_trace_12.1.0.etl
To format the event log named mpi_trace_26.1.0.etl as an .otf file and skip all API events that occur during an MPI collective operation, use the following command:
mpiexec /cores 1 etl2otf mpi_trace_26.1.0.etl /removeIntraCollectiveEvents