Measure Reference Manual

If you omit date, the date that the measurement was started is used.
time-of-day
is
hh:mm[:ss ]
where
hh is the hour (0 through 23).
mm is minutes (0 through 59).
ss is seconds (0 through 59).
The syntax for duration is one of:
n SECOND[S]
n MINUTE[S]
n HOUR[S]
where n is an integer in the range 1 through 32767.
BY TIME, INTO number causes MEASFT to create multiple output data files that contains entities
that existed in the input data file. BY TIME, INTO number can optionally be followed by a SECOND,
MINUTE, HOUR, or PARTS specification.
If BY TIME, INTO number is specified without a SECOND, MINUTE, HOUR, or PARTS specification
or BY TIME, INTO number PARTS is specified, number indicates the number of split output data
files into which the input file should be divided and can have a value of 2 to 100.
If BY TIME, INTO number is followed by the SECOND keyword, number defines the number of
seconds of input data that go into each split output data file. If BY TIME, INTO number is followed
by the MINUTE keyword, number defines the number of minutes of input data that go into each
split output data file. If number is followed by the HOUR keyword, number defines the number
of hours of input data that go into each split output data file. When followed by SECOND, MINUTE,
or HOUR, number can have a value of 1 to 32767. If a time unit is specified, the data in the last
split output data file may have a shorter duration than the others.
The maximum number of split output data files is 100. If the BY TIME, INTO specification dictates
that more than 100 split output data files be created, only 100 split output data files will be created
with the 100th split output data file containing the rest of the data records. For example, splitting
a 2-hour measurement into 1-minute parts will result in the first 99 split output data files containing
1 minute of data, and the 100th data file containing 21 minutes of data.
Usage Notes
• When the SPLIT BY TIME command is executed on an interval data file, it includes a tolerance
factor in the beginning and ending times of the split file time period. This tolerance is similar
to the default tolerance that MEASCOM employs when the FROM and TO options are used
for the LIST command. For example, if the beginning and ending times for a split file are 5:00
and 6:00, respectively, and if the measurement interval is 10 minutes, MEASFT will actually
use a beginning time of 4:55 and an ending time of 6:05 in deciding what data records to
include in the split file. This tolerance was added so that Measure reports from the split file
will be identical to the same report from the original file. However, on busy systems, the
MEASCTL or DP2 processes may not be able to write to the measurement data file in a timely
manner. In addition, there may be significant clock skew (relative to the measurement interval)
between CPUs. These conditions can create “edge effects” that affect the fidelity between the
original data file and split file MEASCOM LIST output. To ensure fidelity, the user should
specify time period boundaries about one interval larger than the time period of interest. Using
the previous example, to get reliable MEASCOM LIST output between 5:00 and 6:00, the
user should specify a FROM time of 4:50 and a TO time of 6:10 (or equivalent options) in
the MEASFT SPLIT BY TIME command when the split file is created.
• The “Time period” line of the SPLIT display reflects the time period covered by the input data
file. For an original measurement data file, it’s the Start and Stop time of the measurement.
For a TIME-split data file, or one that is a descendent of a TIME-split data file, the “Time period”
line reflects the time period of the data file.
SPLIT Command 555