etl2otf

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  

Additional references