Measure Reference Manual

Scaling FactorDEFINE Statement
16 timeADD DEFINE =_SET_PROCESSH_RATE, file SCALE16X
32 timesADD DEFINE =_SET_PROCESSH_RATE, file SCALE32X
To determine the approximate sampling rate, issue successive PEEK INT requests in a processor
to view the accumulated sample interrupts, or examine the counter PROCESSH-SAMPLES in
the ZMSCPU report or through MEASCOM LIST CPU command. For example:
TACL 12> ADD DEFINE =_SET_PROCESSH_RATE, file SCALE4X
TACL 13> MEASCOM START MEASSUBSYS
• If the process-spec is either a process-name or a cpu,pin combination, a
code-file-spec needs to be specified to configure a PROCESSH measurement. If an object
file name is specified as process-spec, the code-file-spec is optional. For LIST
commands, it is not necessary to specify a code-file-spec.
Usage Notes for G-Series PROCESSH Entities
• TNS/R processors include short code sequences called gateways that handle the transition
from non-native to native calls. If a sampled process is executing in a gateway, PROCESSH
increments the sample count but does not assign the sample to a particular code space.
Therefore, the total sample count might be larger than the sum of the various code-space
counts.
• If the sum of the individual code-space sample counts is significantly less than the total
samples count for the process, using the Native Object File Tool (NOFT) utility, check to see
if any shared run-time libraries (SRLs) should have been added to the PROCESSH configuration.
If so, add them in MEASCOM as URLs to the PROCESSH configuration. For an example, see
Examples of PROCESSH Measurements.
NOTE: Because sampling does not occur in processor millicode or in gateways, the potential
exists for a small number of missing samples.
Examples of PROCESSH Measurements
• This example tracks the use of system procedures by all processes in CPU 7. It shows the use
of the system code and system library activity for the TNS/R system, and produces sampling
reports for all of the system procedures run on a TNS/R system. The use of ALLTIME measures
all system code and system library activity for all processes in the CPU.
+ ADD PROCESSH ALLTIME 7 (SC $SYSTEM.SYSnn.TSC)
+ ADD PROCESSH ALLTIME 7 (SL $SYSTEM.SYSnn.TSL)
NOTE: A TNS/R system has more than one system code (SC) file.
• This example measures SCR and SLR code spaces.
To support the TNS/R operating environment, the SYSGEN program creates a new object file
(file code 700), named TSYSCLR, which is placed in $SYSTEM.SYSnn subvolume. This object
file can be used to sample TNS/R system code (SCR) and the TNS/R system library (SLR).
Because TNS/R code spaces contain no code maps, the samples are displayed only for SCR
and SLR. The TSYSCLR file is superseded in H-series and J-series RVUs, as described later in
this list of examples.
To sample TNS/R code spaces for SCR and SLR:
+ ADD PROCESSH proc spec (SCR $SYSTEM.SYSnn.TSYSCLR)
+ ADD PROCESSH proc spec (SLR $SYSTEM.SYSnn.TSYSCLR)
322 Entities and Counters