Measure User's Guide

Contents

Measure User’s Guide—520560-003

iii

4. Formatting Reports and Plots

Controlling Content and Format of Reports 4-1

REPORT Attributes 4-1

Controlling the Report Window 4-6

Displaying Interpreted and Uninterpreted Values 4-8

Plotting Measurement Data 4-10

The Plot Definition 4-11

PLOT Attributes 4-13

Generating Plots 4-16

Changing the Scale 4-22

Changing the Orientation 4-23

Changing the Density 4-26

Changing the Plot Window 4-27

Plotting Execution Modes 4-28

Producing Structured Files of Measurement Data 4-31

Step 1: Produce Structured Report Files 4-31

Step 2: Load the Structured Files 4-32

Step 3: Build the Data Dictionary 4-33

Generating Reports Using Enform and SQL/MP Products 4-34

Loading Data From Different Systems to Common Files 4-34

5. Defining Custom Counters

Task 1: Instrument an Application 5-1

Step 1: Source in the MEASDECS File 5-2

Step 2: Declare Integer Variable, Array, and Offset 5-2

Step 3: Initialize the Counter (Call MEASCOUNTERBUMPINIT) 5-2

Step 4: Bump the Counter (Call MEASCOUNTERBUMP) 5-2

Sample TAL Program 5-3

Task 2: Measure the Application 5-6

Step 1: Specify the Processes Running the Application 5-6

Step 2: Specify the User-Defined Counters in the Application to Measure 5-6

Considerations 5-7

Sample COBOL Application 5-9

6. Creating a Custom Measurement Application

Preparing Your Program and Defining the Configuration 6-1

Reading Declaration Files 6-3

Allocating Space for the Measure Control Block 6-3

Defining Entities 6-4