Measure Reference Manual

MEASGETVERSION
Returns the Measure version of the specified data file. If the call provides a buffer, the procedure
also returns an array of external entity record lengths for the version, indexed by entity type. You
can use MEASGETVERSION for two purposes:
• You can use the Measure version of the data file to decide which MEASFH version to use.
• You can use the record length returned to decide the address of the records returned by other
procedures (such as MEASREAD).
error := MEASGETVERSION ( { dfile } ! i
,{ dfnum } ! i
,version ! o
,[ buffer ] ! o
,[ buflen ] ! i
,[ sysname ] ! o
,[ release ] ! o
,[ processor^type ] ! o
,[ sysidbuf ] ! o
,[ sysidbuflen ] ! i
,[ sysidlen ] ); ! o
NOTE: Support for sysidbuf, sysidbuflen, and sysidlen begins with the Measure
H05/J03 PVU.
dfile
input
INT .EXT:ref:12
is an array containing the data file name. You must specify either dfile or dfnum. If you do
not, error 3201 (ERR^MISSINGPARAM) is returned. Optionally, you can specify both.
dfnum
input
INT:value
is the data file access number. Use the dfnum value returned by the MEASOPEN procedure.
You must specify either dfile or dfnum. If you do not, error 3201 (ERR^MISSINGPARAM)
is returned. Optionally, you can specify both.
version
output
INT:ref:1
is the Measure product version when the data file was created. The value returned consists of
two parts. Bits 0:7 contain an alphabetic character (for example, D), and bits 8:15 contain a
numeric value (for example, 30). Together they express the product version (for example, D30).
buffer
output
INT .EXT:ref:*
is an array of 16-bit integers to be accessed using the entity type index. buffer is typically
declared as INT.BUFFER[0:MAX^T]. Each array element indicates the legacy style external
record length for that entity type. If you pass the buffer parameter, you must specify buflen,
or error 3201 (ERR^MISSINGPARAM) is returned.
buflen
input
INT:value
392 Measure Callable Procedures