Measure Reference Manual

START MEASUREMENT
The START MEASUREMENT command specifies the file where the measurement data is to be written
and starts the measurement.
In Measure G09 and later PVUs, you can enable or disable OSS journal segment construction for
the resolution of internal OSS path information in data records.
In Measure H02 and later PVUs, you can use the FILESIZE and NOCOUNTERS options to select
the measurement data file size and suppress counter data records. The START MEASUREMENT
command is enhanced to allow options to be specified in any order.
Syntax
START [ MEASUREMENT ] data-file
[ , FROM [ start-date , ] start-time-of-day ]
[ , FOR duration ]
[ , TO [ end-date , ] end-time-of-day ]
[ , INTERVAL interval ]
[ , { OSS | NOOSS } ]
[ , { SQL | NOSQL } ]
[ , FILESIZE file-size [ MB | GB ] ]
[ , NOCOUNTERS ]
MEASUREMENT
is optional if you specified MEASUREMENT as the default command object by using the
ASSUME command.
data-file
is the file to which the measurement data is written. If you allocate your own data file, the
maximum segment size is 127.5 MB.
If data-file exists, the Measure file-handling process (MEASFH) clears the file before starting
the measurement. If data-file is currently active, MEASFH returns an error message.
If data-file does not exist, MEASFH creates it as an unstructured file with a file code of
175. Primary and secondary extent sizes are 2048 pages each, and the maximum number
of extents is 256. This results in a default file size (capacity) of 1024 MB.
If data-file is a disk file, MEASCOM performs an implicit ADD MEASUREMENT data-file,
so you can examine the collected data (using one of the LIST commands) without explicitly
entering the ADD MEASUREMENT command.
If data-file is a tape file, you must copy that file to a disk file before using MEASCOM to
examine the collected data.
FROM [ start-date , ] start-time-of-day ]
specifies the start of the measurement. If you omit FROM, the measurement begins immediately.
start-date
is the start date of the measurement, in one of these formats:
{ [d]d mmm[ yyyy] }
{ mmm [d]d[ yyyy] }
where
dd is a day of the month, a number in the range 1 through 31.
mmm is the first three letters of the month; for example: JAN, MAR, OCT.
yyyy is the year. Valid years are 1984 through 2047.
If you omit start-date, the current date is used.
start-time-of-day
is the start time of the measurement, in the format:
START MEASUREMENT 123