Measure Reference Manual

MEASOPEN
Obtains read, write, or read and write access to a measurement data file; opens the file: and
creates a Measure file-handling (MEASFH) process to access the file. Use the write and read
parameters to specify access type. To close a data file, use the MEASCLOSE procedure.
The best way to access a remote data file is to use the measfh parameter. You specify an object
file (on the remote system) that contains a Measure file-handling (MEASFH) program. Measure
then starts a process on the remote system that executes the MEASFH program to read the data
file. MEASOPEN has a parameter for specifying options. Two bits of this field override the default
treatment of the OSS journal segment function.
error := MEASOPEN ( dfile ! i
,dfnum ! o
,write ! i
,read ! i
,[ measfh ] ! i
,[ swapvol ] ! i
,[ cpunum ] ! i
,[ options ] ! i
,[ filesize ] ) ; ! i
error
INT
is the error code indicating the outcome of the operation. Possible error codes include:
DescriptionError Code
Successful completion.0
A bad parameter value was supplied.err^badparams3203
The SQL journal segment for this file is still under construction.err^buildingsqljournal3240
dfile
input
INT:ref:12
is an array containing the data file name.
dfnum
output
INT:ref:1
is the data file access number. Use this number in subsequent procedure calls to identify the
data file. The Measure subsystem uses the file number of the Measure file-handling (MEASFH)
process open as this unique file-access number.
write
input
INT:value
is used with read to specify access type:
ResultReadWrite
Obtains write access to the data file and automatically initializes
it. During initialization, any data in the file is deleted. It must be
True or FalseTrue
an unstructured local disk file with a file code of 175 or a local
tape file. If the file does not exist, it is created.
Obtains read access to the data file. The data file must be a local
or remote disk file.
TrueFalse
414 Measure Callable Procedures