Measure Reference Manual

MEAS_ADJUSTZMSRECORD_
Takes ZMS style structure records in any published format and adjusts them to the MEASDDLS
format with which an application was compiled.
error := MEAS_ADJUSTZMSRECORD_ ( in^record ! i
,out^record ! o
,templateversion ); ! i
in^record
input
INT .EXT:ref:n
is a buffer containing a ZMS style external record to be padded or truncated to a new desired
format. The length of in^record is derived from the information encoded in the template
version of the header record pointed to by in^record.
out^record
output
INT .EXT:ref:n
is a buffer in which to return a ZMS style external record padded or truncated to a format
specified by the templateversion parameter. The length of out^record is derived from
the information encoded in the templateversion parameter.
templateversion
input
FIXED:value
is the record template version for the format of record being requested. It is obtained from the
MEASDDLS with which the requesting application was compiled.
If passed as -1F, the templateversion for the current release will be used, starting with the
H06.15/J06.04 RVUs. Note that returned external records, in that case, may not match the
counter record definitions with which the application was compiled.
Usage Notes
If the adjustment is to a smaller or earlier record format, the fields added or increased between
the two record versions are stripped or truncated.
If the adjustment is to a larger or newer record format, the location of the new or larger fields in
the more recent format are padded.
All padding is with the value zero, except for long variable-length identifiers at the end of the
identifiers section. If these increase in size, they are padded with spaces.
To have an application read a structured data file (file code 170) containing records of a template
version other than that with which the application was compiled:
1. Open the file structured data file.
2. Use FILE_GETINFO_ to obtain the record length of the data in the file.
3. Read each record of the file to a buffer long enough to hold the complete record.
4. Declare a buffer area for a reformatted record based on the MEASDDLS template.
5. Invoke MEAS_ADJUSTZMSRECORD_ passing the record from the file, the declared buffer
area for the reformatted record, and the correct zms entity-template-version literal
from MEASDDLS.
380 Measure Callable Procedures