Measure Reference Manual

DDL Header (ZMS Style)
NOTE: You should always use TEMPLATE-VERSION (page 147) to get the external records
corresponding to a format that you can handle.
There are three ways to do this:
• Use MEASCOM, which uses the template version for the current version.
• From a user program, call Measread_diff_() with the requested template version.
• For structured files, use a pre-created structured file, with a record length corresponding to
the requested template version for the entity in question. When data collected on systems of
differing product versions are stored in the same structured files, the template version for all
records will be the one used to create the structured file. The template version from the first
record will be used to format all records in the file.
If there are fields in the data file that do not exist in the version indicated by the requested template
version, they will not be present in the requested records.
If there are fields in the version indicated by the requested template version that do not exist in the
data file, they will be present in the requested records, filled with zeros, and you can use the
DATA-VERSION (page 146) field to judge if those zero-filled fields are valid or not.
RECORD zmsentity. FILE is "zmsentity" ENTRY-SEQUENCED.
02 loadid type character 8.
02 load-id redefines loadid.
03 prefix-id type character 4.
03 interval-id type character 4.
02 system-name type character 8.
02 cpu-num type binary 16 unsigned.
02 os-version.
03 letter type character 1.
03 number type binary 8.
02 reserved type character 4.
02 object-uid type character 16.
02 from-timestamp type binary 64.
02 to-timestamp type binary 64.
02 delta-time type binary 64.
02 template-version type binary 64.
02 format-version.
03 letter type character 1.
03 number type binary 8.
02 data-version.
03 letter type character 1.
03 number type binary 8.
02 subsystem-version type binary 16 unsigned.
02 error type binary 16.
end
DDL Header (Legacy Style)
RECORD entity. FILE is "entity" ENTRY-SEQUENCED.
02 error type binary 16 unsigned.
* time items:
02 from-timestamp type binary 64.
02 to-timestamp type binary 64.
02 delta-time type binary 64.
* measurement identification items:
02 system-name type character 8.
02 os-version.
03 letter type character 1.
03 number type binary 8.
Common Entity Header Fields 145