ptxmerge Command

The ptxmerge program allows the user to specify up to 10 input files that are to be merged into one file. All files must be valid Performance Toolbox for AIX recording files in Version 2 format. When more than one input file is specified and one or more of the input files contain multiple sets of control information, only the records belonging to the first such set participate in the merge operation.

If only one input file is given, the program assumes you want it to rearrange the records in that file. If this file contains only one set of control information, then the output file is identical to the input file.

Syntax

ptxmerge [ -m| -p incr|-t inc r] [ -z] outfile input1 [ input2 [ input3...]]

Flags

m

Only valid if exactly two input files are specified. Merges files, modifying all time stamps in the oldest file by the difference in time between the time stamps of the first value record in the two files.

p

Only valid if exactly two input files are specified. Must be followed by the number of seconds to be added to all time stamps in the first input file before merging the files. This value may be negative.

t

Only valid if exactly two input files are specified. Must be followed by the number of seconds to be added to all time stamps in the second input file before merging the files. This value may be negative.

z

Optional. Preserves information about sets of statistics (statsets) when creating the resulting file. This is useful if the output file is to be used for playback with xmperf. The input files are merged together but each set of statistics are played back in instruments of the same contents (though not necessarily the same appearance) as the originals.