Measure User's Guide

Creating a Custom Measurement Application

Measure User’s Guide—520560-003

6-3

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