Measure Reference Manual

If you specify an asterisk (*), MEASFT creates the output data files with names of the form
ZMSRFnnn, beginning with ZMSRF000. The number of output data files created depends upon
split-criteria. If split-criteria is not specified, MEASFT behaves as described in
Usage Notes (page 555).
If you specify a string of characters ending in an asterisk, MEASFT regards the value as a file
name prefix and appends a number, starting with "00" for the first file. The number of output
data files created depends upon the split-criteria. If split-criteria is not specified,
MEASFT behaves as described in Usage Notes (page 555).
If you specify a comma-separated list of file names, enclosed in parentheses, MEASFT uses
those names for the files it creates. You must specify at least one name. If the number of specified
names is different from the number of output data files dictated by the split-criteria,
MEASFT terminates with an error message.
If you specify only one name, you must specify split-criteria to indicate what should go
into the single output data file.
name-prefix, namen and name are partially or fully qualified names. For example, all of
the following specifications are valid:
\node.$vol.subvol.*
subvol.pref*
(split1, \node.$vol.subvol.rsplit2, othersv.split3)
If you specify an output file name that is the name of an existing Measure data file, but not the
name of the data file to be split (that is, the specified output file name is not the file name
identified by filename), MEASFT displays a warning message and purges the data before
writing to the file. If you specify an output file name that is the same as the name of the existing
Measure data file to be split, MEASFT displays an error message and terminates.
If you specify an output file name that is the name of an existing file, but not a Measure data
file, MEASFT displays an error message and terminates.
split-criteria
specifies how the data file will be split. Its syntax is one of:
BY ENTITY *
BY ENTITY (entity-list1[, entity-list2]...)
BY CPU *
BY CPU (cpu-list1[, cpu-list2]...)
BY TIME, FROM time [, { TO time | FOR duration } ]
BY TIME, TO time
BY TIME, FOR duration
BY TIME, INTO number [ SECOND | MINUTE | HOUR ] [ PARTS ]
BY ENTITY followed by an asterisk (*) causes MEASFT to create one output data file per entity
type present in the data file.
BY ENTITY followed by one or more entity lists causes MEASFT to create one output data file
for each list of entities. The syntax for entity-listn is:
entity-name [entity-name]...
that is, a space-separated list of entity-name. The permissible values for entity-name
are:
CLUSTER
CPU
DEVICE
DISC or DISK
DISCOPEN or DISKOPEN
DISKFILE
FILE
LINE
NETLINE
SPLIT Command 553