Measure Reference Manual

For structured records, if a preexisting structured file exists, the first record of the file is
used to determine the template version, and the new records added to the structured
file will use that template version. Note that it is actually possible for the data file to be
a newer version than the installed system and for Measure to still determine the record
format and write relevant counters in the correct places according to the “future” template
version. To use a “future” template version, create a preexisting file by inserting a
“dummy” record of the desired template version into an empty file. Then direct your
application to ignore this "dummy" record during actual file processing by assigning
the record a unique LOADID such as "SKIPTHIS" or "IGNOREIT". In this instance,
"future” values in the newer template version will be zero filled. The same functionality
is true for applications that are updated to support new Measure counters but still run
on older systems. When run on older systems, the Measure interfaces adjust the records
to the newer template-version format requested by the application.
If the structured file exists but is empty, the configured record length of the file will be
matched to a current or past template-version only. For MEASCOM, the template version
is matched to the installed system version.
This template-version functionality allows Measure to place records from data files
captured from multiple systems with different releases and/or Measure versions in a
single set of ZMS structured files with a common record format. It further allows
applications to request and process Measure records in the format the application was
compiled with, independent of the format for the Measure version that gathered the
data. There is no need to recompile applications to stay current with Measure record
formats unless you want the application to utilize new information in the updated
formats.
FROM [ start-date , ] start-time-of-day ]
specifies the beginning of the report window. If you omit FROM, the start time of the
measurement or the start time of the entity measurement is used, whichever is later.
start-date
is the start date of the data to be used for the report, 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 measurement start date is used.
start-time-of-day
is the start time of the data to be used for the report, in the format:
hh:mm[:ss]
where
hh is the hour (0 through 23).
mm is minutes (0 through 59).
ss is seconds (0 through 59).
If you omit start-time-of-day, the measurement start time is used.
LOADID loadid
specifies the name to be placed in the loadid field of structured records.
SET REPORT 111