Measure Reference Manual

USERDEF^DESC
is the descriptor for USERDEF entities. USERDEF^DESC is used with the COUNTER^DESC.
For OSS file pathnames, use USERDEF^OSS^DESC (page 491).
Struct Userdef^desc (*);
Begin
Int Type; ! Entity type
Int Len; ! Byte length of record.
Int CPU^number;
Int PIN;
Int Process^name[0:3];
Int Program^file^name[0:11];
Int Numcounters; ! Number of counters to be installed
End; ! A subsequent counter^desc is not needed for an Entitydesc of
! a previously installed entity. But for Contab use, as many
! Counter^desc as desired must imediately follow this struct.
type
INT:value:1
is the literal USERDEF^T or the numeric identifier 4.
A positive type value includes the specified entities in the measurement configuration. A
negative type value excludes the specified entities from measurement. For an example, see
Specifying Entity Descriptors (page 376).
len
INT:value:1
is the length in bytes of this descriptor and any COUNTER^DESC descriptors associated with
it. See COUNTER^DESC (page 491).
cpu^number
INT:value:1
is the number of the CPU on which the process to be measured is running.
pin
INT:value:1
is the process identification number of the process to be measured. To indicate all PINs, use
the literal -1.
process^name
INT:value:4
is the name of the process to measure. The name must be left-justified and blank-filled. It must
start with a dollar sign ($) and be in internal format. To indicate all processes, use a dollar
sign followed by an asterisk ($*).
program^file^name
INT:value:12
is the name of the object file that the process to be measured is executing. The name must be
left-justified, blank-filled, and in local internal format. To specify the volume, subvolume, and
file-name fields within program^file^name, use asterisks (*).
numcounters
INT:value:1
is the number of COUNTER^DESC descriptors that follow. Each COUNTER^DESC descriptor
describes a user-defined counter to measure.
NOTE: When passing a USERDEF^DESC descriptor to the MEASREAD or MEASREADACTIVE
procedure, do not include COUNTER^DESC descriptors.
490 Entity Descriptors