|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCPRP
PrologControl Block Contents
Cross Reference
MRPRCPRP Prolog
DSECT NAME - PRCPRP
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRPRCPRP
DESCRIPTIVE NAME - Monitor Sample Record
Domain 5 - Processor Domain
Record 3 - Processor Data (Per Processor)
DESCRIPTION - Provides data related to work dispatched on a real
processor. A separate record is generated for each
real processor.
NOTES:
Valid values for PRCPRP_PFXSTATE are:
000 - CPU is online and available
022 - Attempting to quiesce this CPU so it can be
be taken offline
044 - CPU has been quiesced and is in disable wait
state so it can be taken offline
055 - CPU is check-stopped
066 - CPU is now logically offline
110 - CPU is physically offline
238 - CPU is in an unknown state (SIGP
communication failure)
130 - CPU is being brought online
MRPRCPRP Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 384 PRCPRP Start of monitor record
0 0 Character 0 PRCPRP_MRHDR Record header. See MRRECHDR
for details.
0 0 Character 20 MRHDR
0 0 Unsigned 2 MRHDRLEN
2 2 Unsigned 2 MRHDRZER
4 4 Unsigned 1 MRHDRDM
5 5 Unsigned 1 *
6 6 Unsigned 2 MRHDRRC
8 8 Character 8 MRHDRTOD
16 10 Character 4 *
20 14 Character 0 MRHDR_END
20 14 Unsigned 2 PRCPRP_PFXCPUAD Processor address
22 16 Unsigned 2 *(0:30) Reserved for IBM use. This
field used to be called
PRCPRP_PLSSTLNU and was filled
in using PLSSTLNU. See the new
field PRCPRP_PLSSTLCT which
supports 64 processors and now
uses fullword counts.
84 54 Unsigned 4 PRCPRP_PFXDSPCS Count of 'long paths' through
the dispatcher. This is roughly
the number of times a different
user was selected to be
dispatched. It includes also
the number of times a running
user was examined to see if it
should continue to run, and was
selected to run again (no
switch made).
88 58 Unsigned 4 PRCPRP_PLSDSPCM Count of times a VMDBK was
chosen to be dispatched, then
had to be moved to the master
processor for master-only work.
This is the only time work will
be passed from a
non-master-processor to another
processor.
92 5C Unsigned 4 PRCPRP_DSVMAXUS Maximum number of users
allowed in the Processor Local
Dispatch Vector (PLDV)
96 60 Character 28 PRCPRP_HFSAMPLE
96 60 Unsigned 4 PRCPRP_HFCOUNT Number of times this
processor was sampled for high
frequency data.
100 64 Unsigned 4 PRCPRP_HFUSERZ High-frequency count. Number
of times the Processor Local
Dispatch Vector (PLDV) had no
VMDBKs
104 68 Unsigned 4 PRCPRP_HFUSERC High-frequency count. Number
of VMDBKs in the Local Dispatch
Vector (PLDV) when the PLDV was
not empty. DSVUSERC
108 6C Character 8 PRCPRP_CALUDED If processor is dedicated,
this is the userid to which it
is dedicated. Otherwise, the
field is binary zeros.
116 74 Unsigned 1 PRCPRP_PFXTYPE Host CPU usage type
identifier. Processor type is:
X'14' = Master Processor X'1E'
= Dedicated Processor X'28' =
Alternate Processor
117 75 Character 3 * Reserved and available for
IBM use.
120 78 Unsigned 4 PRCPRP_HFUSERM High-frequency count. Number
of VMDBKs in the master-only
Local Dispatch Vector (PLDV).
This varies from PRCPRP_HFUSERC
which for the master processor
is the sum of VMDBKs in both
the master-only PLDV and the
normal PLDV.
124 7C Unsigned 4 PRCPRP_PLSSTLCT(0:63) Array of counts of 'stolen'
VMDBKs, one count for each
processor from which the VMDBK
was stolen. This array does not
include the master-only
processor since its work cannot
be dispatched by another
processor.
380 17C Unsigned 1 PRCPRP_PFXCPUTY Processor type. Valid values:
X'00' - General Purpose (CP)
X'02' - zSeries Application
Assist (zAAP) X'03' -
Integrated Facility for Linux (IFL)
X'04' - Internal Coupling Facility
(ICF) X'05' - zSeries Integrated
Information (zIIP)
381 17D Unsigned 1 PRCPRP_PFXSTATE CPU Operating Status
382 17E Character 2 * Reserved for IBM use
384 180 Character 0 PRCPRP_END
MRPRCPRP Cross Reference
Hex Hex
Name Offset Length Value
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
PRCPRP 0 384
PRCPRP_CALUDED 6C 8
PRCPRP_DSVMAXUS 5C 4
PRCPRP_END 180 0
PRCPRP_HFCOUNT 60 4
PRCPRP_HFSAMPLE 60 28
PRCPRP_HFUSERC 68 4
PRCPRP_HFUSERM 78 4
PRCPRP_HFUSERZ 64 4
PRCPRP_MRHDR 0 0
PRCPRP_PFXCPUAD 14 2
PRCPRP_PFXCPUTY 17C 1
PRCPRP_PFXDSPCS 54 4
PRCPRP_PFXSTATE 17D 1
PRCPRP_PFXTYPE 74 1
PRCPRP_PLSDSPCM 58 4
PRCPRP_PLSSTLCT 7C 256
This information is
based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 20:31:30.
Copyright IBM Corporation, 1990, 2008