mpicsync
Correlates the event time stamps for each of the .etl files.
For examples of how to use this command, see Examples.
mpicsync [/w:<number>] [/d:{0|1|2|3|4}] [/nw] <.etl_file1_name> [<.etl_file2_name> ...]
mpicsync /?
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. |
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.
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