Measure Reference Manual

FIXED:value
is the desired file size (capacity) in bytes. The minimum value for filesize is 133169152
(127 MB) and the maximum is 1099507433472 (1048572 MB) or the maximum disk size
(if less than 1048572 MB). The default value is 1073741824 (1024 MB). A value of -1
indicates that no file size was specified. If filesize is less than the minimum allowed value
or greater than the maximum allowed value, error 3203 (ERR^BADPARAMS) is returned. If the
file already exists, the filesize parameter is ignored, and the capacity of the existing file
is used.
Usage Notes
• A call to MEASOPEN with read access is equivalent to executing an ADD MEASUREMENT
command. The MEASOPEN procedure creates a MEASFH process, opens it, and sends the
name of the data file to add to the MEASFH process. The MEASFH process scans the data
file and builds a set of in-memory table indexes for future access requests (the same as is done
in an ADD MEASUREMENT operation). You should know the disk and memory resource costs
associated with this procedure.
• A call to MEASOPEN with write access results in a purge of the data file contents. The purge
of the data is performed by the MEASFH process.
• These LITERALs are defined in MEASDECS and MEASCHMA:
LITERAL OSSNOTSPECIFIED = 0;
LITERAL OSSFORCEDON = 1;
LITERAL OSSFORCEOFF = 2;
LITERAL SQLNOTSPECIFIED = 0;
LITERAL SQLFORCEDON = 1;
LITERAL SQLFORCEDOFF = 2;
• If write access is specified, the options parameter determines whether the OSS or SQL/MX
journal segment is constructed with the measurement.
If read access is specified, the options parameter determines whether an OSS or SQL/MX
journal segment in a Measure data file is attached to the calling process and whether error
or warning messages about the OSS or SQL/MX journal segment function are passed to the
calling process.
• If the caller of MEASOPEN does not include the options parameter, OSSFORCEDOFF or
SQLFORCEDOFF is assumed. If write access is specified, no journal segment construction
occurs. If read access is specified, no attempt is made to attach an OSS or SQL/MX journal
segment from the data file. This handling of the options parameter prevents inadvertent
performance degradation on the system by applications that cannot utilize the OSS or the
SQL/MX journal segment function.
• Programs that start measurements programmatically (for example, programs that usually involve
system monitoring, system management, and OSS pathname translation services) are
encouraged to use the OSS name server facilities on the system rather than the journal segment
function.
• These literals are defined in MEASDECS and MEASCHMA:
SQLNOTSPECIFIED = 0LITERAL
SQLFORCEDON = 1LITERAL
SQLFORCEDOFF = 2LITERAL
• In Measure G11 and later PVUs, the MEASOPEN options parameter has two new bits
(options.<12:13>) used to override the default treatment of the SQL/MX journal segment
416 Measure Callable Procedures