Measure User's Guide

Creating an Enform Report From Measure Data
Measure User’s Guide—520560-003
A-3
Rates
Rates
The uninterpreted values provided by the structured report for incrementing and
accumulating counters are the number of operations performed. To calculate
operations per second, use this formula:
(counter * 1.000) / (delta-time/1000000)
You must divide by one million to get seconds because the length of the report window,
DELTA-TIME, is in microseconds.
This Enform session displays the PROCESS DISPATCHES counter as the number of
operations performed in the column DISPATCHES and as the number of operations
performed per second in the column under DISP RATE:
>LIST PROGRAM-FILE-NAME,DISPATCHES,
>((DISPATCHES*1.000)/(DELTA-TIME/1000000))HEADING"DISP RATE",
>WHERE PROGRAM-FILE-NAME CONTAINS "MCOM";
PROGRAM-FILE-NAME DISPATCHES DISP RATE
------------------------ ---------- ----------
$DATD QUOTAS MCOM 2485 5.284
$DATD QUOTAS MCOM 169 2.001
The PROGRAM-FILE-NAME field of the PROCESS record contains the name of the
executing program file. The WHERE clause of the LIST command selects the records
to be included in the report.
Creating User-Defined Variables
Use DECLARE statements to create user-defined variables in Enform reports.
User-defined variables are most often used in LIST statements to calculate new report
items from existing record fields.
To use variables wherever you would use field names, you must create a new record
definition and assign the variable values to the fields of the new record. (See Creating
User-Defined Records on page A-4.)
This DECLARE statement defines the variable PROC-TIME. By default, a variable’s
initial value is 0. You can specify a different initial value by using the Enform SET
command.
>DECLARE proc-time INTERNAL F19.3 AS F9.3
>HEADING "Process/Busy Time/(seconds)";
The INTERNAL clause defines the PROC-TIME internal data structure as F19.3,
where 19 is the total number of character positions, including the decimal point, and 3
is the number of digits to the right of the decimal point. (An 18-digit decimal number
with three digits to the right of the decimal place is used for internal Enform
calculations.)