mpicsync
Correlates the event time stamps for each of the .etl files.
For examples of how to use this command, see Examples.
Syntax
mpicsync [/w:<number>] [/d:{0|1|2|3|4}] [/nw] <.etl_file1_name> [<.etl_file2_name> ...]
mpicsync /?
Parameters
Parameter | Description |
---|---|
/w:<number> | Reads the specified number of events from the .etl file. Specify 0 to read all of the events. The default is 0. |
/d:{0|1|2|3|4} | Specifies the level of debugging output to display as a number between 0 and 4. Each level also prints the information from the lower levels. The default is 1. The levels of debugging output are: - 0 - None. - 1 - Prints synchronization results, which are the time offset and the multiplication coefficient for the clock skew, and their error values. - 2 - Prints a summary of the synchronization data. - 3 - Prints the .etl file headers. - 4 - Prints the polygon information by each rank that constructs the time skew constants. |
/nw | Does not rewrite the .etl file. |
<.etl_file1_name> [<.etl_file2_naem> ...] | Specifies one or more .etl files to synchronize, separated by spaces. |
/? | Displays Help at the command prompt. |
Remarks
The mpicsync command is a Message Passing Interface (MPI) program. Run it with the mpiexec command to distribute correlation work across each node that is used in a job.
By default, the mpicsync command rewrites the .etl files to apply the clock corrections to the event time stamps.
Examples
To correlate the event time stamps in the trace log file named mpi_trace_48.1.0.etl by using the /cores parameter of the mpiexec command with a value of 1 to run a single mpicsync instance on each compute node, use the following command:
mpiexec /cores 1 mpicsync mpi_trace_48.1.0.etl
To run a single mpicsync process on each compute node that correlates the event time stamps for the first 1000 events in the trace logs named mpi_trace_68.1.0.etl mpi_trace_94.1.0.etl, prints debugging output that includes .etl file headers, and does not rewrite the .etl files, use the following command:
mpiexec /cores 1 mpicsync /w:1000 /d:3 /nw mpi_trace_68.1.0.etl mpi_trace_94.1.0.etl