Measure Reference Manual

D Measure Data File Tool (MEASFT)
The Measure Data File Tool (MEASFT) lets you split a measurement data file into multiple data files
for consumption and display by MEASCOM or through Measure APIs. MEASFT is especially useful
in the case of the very large data files that can result from measuring large numbers of entities or
measuring at very small intervals.
MEASFT is part of H06.07 and later RVUs, but you can use it to split measurement data files
created by Measure G10 or later G-series PVUs. To split a G-series data file, you must first move
the file to a system running an H-series and J-series RVU. After running MEASFT, either move the
output data files back to the original system for processing and display, or process them on the
system running an H-series and J-series RVU, using the MEASFH option of the ADD command to
specify the appropriate MEASFH object file version.
NOTE: In Measure G12 or later G-series PVUs, it is no longer necessary to move a G-series data
file to a system running an H-series and J-series RVU in order to split the file.
MEASFT has two major functions, each invoked by a command:
• SPLIT. This command splits one measurement data file into multiple measurement data files.
You can specify whether to split the file by entity type(s), processor number, or based on a
time window (in H06.25/J06.14 and later RVUs only). Measurement configuration,
START/STOP measurement records, and any applicable OSS and SQL journal data are
replicated in each output data file.
• INFO. This command reads a measurement data file and displays a report indicating how
much file space is used for data associated with each entity type and processor number. This
information can help you decide how best to split the data file.
MEASFT also has a HELP command, which displays syntax requirements for MEASFT commands.
INFO Command
The INFO command produces a report that indicates how much space in a data file is associated
with each entity type and processor type. You can use this information to help you determine the
best split criteria for the file.
In H06.25/J06.14 and later RVUs, the INFO command also displays a split history record of the
data file. The split history information contains the time when the data file was created, the MEASFT
banner of the MEASFT program that performed the split, and the command line that created the
data file. In addition, the time period and interval values will be displayed, if relevant:
• If the data file is a TIME-split file (a data file created by the SPLIT BY TIME command) or is a
descendent of a TIME-split file, the INFO command also displays the time period value of the
data file, which is a subset of the time period for the original data file.
• If the data file is for an interval measurement, or is a descendent of an interval measurement,
the INFO command also displays the interval value.
Configuration, START/STOP records, and journal data are listed separately and not included in
the entity and processor usage statistics.
Syntax
INFO filename
filename
identifies the Measure data file to be examined. Use a full or partially qualified Guardian file
name.
550 Measure Data File Tool (MEASFT)