Measure Reference Manual

PROCESSH^DESC
is the descriptor for PROCESSH entities. PROCESSH entity descriptors are variable in length and
can contain CODE^SPACE^DESC (page 478) templates following the initial PROCESSH^DESC
structure.
For OSS file pathnames, use the PROCESS^OSS^DESC (page 475) and CODE^SPACE^OSS^DESC
(page 480) templates.
Struct Processh^desc (*);
Begin
Int Type; ! Entity type
Int Len; ! Byte length of record. In case of processh it includes
! length of all the code-space descriptors and for userdef
! it includes length of all the counter descriptors.
Int CPU^number;
Int PIN;
Int Process^name[0:3];
Int Program^file^name[0:11];
Fixed Conftime; ! Set to 0F, for use by MEASFH only
Int Code^spaces; ! Number of code spaces to be measured
End; ! A subsequent code^space^desc is not needed for an Entitydesc of
! a previously installed entity. But for Contab use, as many
! code^space^desc as desired must imediately follow this struct.
type
INT:value:1
is the literal value PROCESSH^T or the numeric identifier 3.
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 CODE^SPACE^DESC descriptors associated
with it. len is 50 if the descriptor does not contain any CODE^SPACE^DESC extensions.
cpu^number
INT:value:1
is the number of the CPU on which the process to be measured is running. Use the literal -1 to
indicate all CPUs.
pin
INT:value:1
is the process identification number of the process to be measured. You can use these literal
values:
• -1 to indicate all processes
• SYSPROCS to indicate all processes installed by SYSGEN
• ALLTIMES to measure execution time for all processes
• ALLINTR to measure only interrupt time for all processes
If you specify pin as the literal value ALLTIMES or ALLINTR, you must use code-space to
specify a code space of SC.0, SL.n, SCR, or SLR.
process^name
INT:value:4
is the name of the process to be measured. The name must be left-justified and blank-filled. It
must consist of a dollar sign ($) followed by a process name in internal format. process^name
can be a system process name. Use the literal -1 to indicate all process names.
PROCESSH^DESC 477