Measure Reference Manual

error := MEASWRITE_DIFF_( dfnum ! i
,entitydesc ! i
,volume^subvol ! i
,[ from^time ] ! i
,[ to^time ] ! i
,[ timetol ] ! i
,[ version ] ! i
,[ all^recs ] ! i
,[ zero^reports ] ! i
,[ totals ] ! i
,[ loadid ] ! i
,[ if^item ] ! i
,[ templateversion ] ); ! i
dfnum
input
INT:value
is the data file access number. Use the dfnum value returned by the MEASOPEN procedure.
entitydesc
input
INT .EXT:ref:*
is the entity type and entity specification of the desired counter records. Specify entitydesc
as one of the descriptors listed in the contab description of the MEASCONFIGURE procedure.
If you specify entitydesc as a template for multiple specifications, MEASWRITE_DIFF_ returns
all counter records that fit the template.
(Measure H01 and later PVUs) For ANSI SQL objects or partitions, entitydesc can be a
DISCOPEN, DISKFILE, FILE, or SQLSTMT entity descriptor. The SQLSTMT ANSI entity descriptor
is used when an ANSI SQL name is to be specified for the retrieval of SQLSTMT counter records.
volume^subvol
input
INT .EXT:ref:8
is the destination volume and subvolume for the counter records. Counter records are written
to the file in DDL record format. For the DDL record definitions for each entity type, see
Chapter 3: Entities and Counters (page 136).
For a local system, the format of volume^subvol (when redefined as a string [0:15]) is:
Volume^SubVol[0] = '$'
Volume^SubVol[1:7] = volume name (padded with spaces)
Volume^SubVol[8:15]= subvolume name (padded with spaces)
For a remote system, the format is:
Volume^SubVol[0] = '\'
Volume^SubVol[1] = system number
Volume^SubVol[2:7] = volume name (padded with spaces)
Volume^SubVol[8:15]= subvolume name (padded with spaces)
from^time
input
FIXED:value
is the start time of the measurement window. Specify from^time as a Julian date based on
local civil time in four-word-by-one-microsecond format as provided by the system procedure
JULIANTIMESTAMP (see the Guardian Procedure Calls Reference Manual). A value of -1
signifies the beginning of the measurement. If no from^time is specified, the default is -1.
MEASWRITE_DIFF_ 445