.png)
etl2otf
Updated: December 10, 2012
Applies To: Microsoft HPC Pack 2008, Microsoft HPC Pack 2008 R2, Microsoft HPC Pack 2012, Windows HPC Server 2008, Windows HPC Server 2008 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.
etl2otf <.etl_file_name> [/removeIntraCollectiveEvents] etl2otf /?
| 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. |
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 |
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
