Measure Reference Manual

MEASINFO
Returns the measurement configuration from a data file.
Unlike the MEASREADCONF procedure, this procedure does not require that the calling process
has already opened the file (using MEASOPEN). Because MEASINFO uses less disk space than
MEASREADCONF, HP recommends it for tasks that do not require retrieval of actual data records.
Use it to help you decide whether a data file contains the needed information before creating
MEASFH.
In Measure G09 and later PVUs, MEASINFO has a parameter for retrieving settings that reports
the configuration of the journal segment functions.
error := MEASINFO ( dfile ! i
,[ contab ] ! o
,[ bufsize ] ! i
,[ bytesret ] ! o
,[ starttime ] ! o
,[ stoptime ] ! o
,[ interval ] ! o
,[ entities ] ! o
,[ ctrspace ] ! o
,[ buflen ] ! i
,[ settings ] ); ! o
error
INT
is the error code indicating the outcome of the operation. Possible error codes include:
DescriptionError Code
Successful completion.0
A required parameter was missing.err^missingparam3201
A bad parameter value was suppliederr^badparams3203
The external name returned exceeded the buffer size.err^buftoosmall3204
dfile
input
INT .EXT:ref:12
is an array containing the data file name in internal (12-word) format.
contab
output
INT .EXT:ref:*
is a buffer that holds the measurement configuration table. For the format of the contab array,
see the contab parameter of MEASCONFIGURE (page 383).
bufsize
input
INT:value
is the size in bytes of the contab. buffer. bufsize cannot exceed 32,000 bytes, or error
3203 (ERR^BADPARAMS) is returned.
394 Measure Callable Procedures