HP NonStop G-Series - Manual (Page 115)

Creating a Custom Measurement Application
Measure User’s Guide — 520560-003
6 -3
Reading Declaration Files
Reading Declaration Files
Use the TAL compiler ?SOURCE command to read these declaration files into the
source code global declarations:
Allocating Space for the Measure Control Block
Allocate space in the program’s global data area for the Measure control block
(
meascb ). You must perform this allocation unless you use only the MEASCLOSE,
MEASOPEN, MEASREAD or MEASREAD_DIFF_, and MEASREADCONF procedures
in a program.
You need only one Measure control block per process, regardless of the number of
measurements the process makes.
MEASCB^DEF in the MEASDECS file is the template structure for the control block.
This referral structure allocates space for the control block:
STRUCT .MEASCB(MEASCB^DEF)
MEAS_READACTIVE_ Reads data from active counter records, for buffers
larger than 32KB.
MEASREADCONF Returns measurement configuration and resource use
information from a data file. Requires that the file be
opened (using MEASOPEN).
MEASREAD_DIFF_ Returns counter records from a measurement data file.
MEASSTATUS Returns resource use information for an active
measurement.
MEASWRITE_DIFF_ Writes counter records from a measurement data file to
a structured file.
Declaration File Description
$SYSTEM.SYSTEM.EXTDECS0 Contains the external declarations for the Measure
procedures. Each Measure procedure used in your
program must be specified in the ?SOURCE command.
$SYSTEM.SYSnn.MEASDECS Contains template structures for the Measure control
block, configuration table, and entity descriptors. It also
declares literal identifiers for the error message codes
returned by the procedures and for constants used in
the configuration table and entity descriptors.
Table 6-1. Measure Callable Procedures (page 2 of 2)
Procedure Function