Measure Reference Manual

data-file
is a disk file (local or remote) containing measurement data. You can specify a currently active
data file.
MEASFH measfh
specifies a MEASFH process other than the default for your system. measfh is an object file
name. Specify an alternate MEASFH process when you:
• Need to process a measurement data file created by an earlier product version of the
Measure subsystem. MEASFH and measurement data files are release dependent. You
must use D40 MEASFH with a D40 data file, and so on.
• Specify a data file on a remote system. Although you are not required to use the MEASFH
on the remote system, it is much faster to have the remote MEASFH perform the I/O to the
remote data file than to perform the I/O over the network.
MEASFH object files are typically named $SYSTEM.SYSnn.MEASFH. To find the subvolume
name for your system, use the STATUS * command. SYSnn is the subvolume that contains the
OSIMAGE file.
NOTE: To examine data files from D-series or previous RVUs on systems running G-series RVUs,
you must use a Dnn product version of MEASCOM as well as the appropriate MEASFH. For
maximum compatibility with a variety of data files, always use the most recent Dnn product version
of MEASCOM.
Related Commands
PageFunctionCommand
54Closes a data file and deletes its current MEASFH processDELETE MEASUREMENT
64Displays which data files are accessible and which file is used
for reports and plots (current data file)
INFO MEASUREMENT
Usage Notes for All PVUs and RVUs
• MEASFH requires disk space three times the size of the data file for creating file indexes and
external counter records. This disk space is either on the same disk as the MEASCOM swap
volume or on the volume specified for swap files through the SWAPVOL command.
• Your user ID must have read access to the data file.
• If you try to access too many measurements during the same session, SEGMENT_ALLOCATE_
returns error 5 (invalid segment size). For a complete list of error numbers and their definition,
see the Guardian Procedure Calls Reference Manual.
• The ADD MEASUREMENT command processes the MEASFH clause the first time ADD
MEASUREMENT is issued for a given data file. To use a different MEASFH process on the
same data file during a session, use the DELETE MEASUREMENT command to delete the
current MEASFH process, then reissue the ADD MEASUREMENT command to specify a new
MEASFH process.
Usage Notes for H-Series and J-Series PVUs and RVUs
In H-series and J-series RVUs starting with H06.07, you can use the MEASFT utility to divide the
measurement data file according to split criteria such as processor number or entity type.
Measurement configuration and OSS or ANSI journal data are included in both files.
You can also use MEASFT to split an existing G-series data file. In this case, you must first move
the G-series data file onto a system running an H-series RVU. After running MEASFT to split the
data file, either move the new data files back to the G-series RVU for analysis or run the appropriate
46 MEASCOM Commands