|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTPRP
PrologControl Block Contents
Cross Reference
MRSYTPRP Prolog
DSECT NAME - SYTPRP
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor control area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTPRP
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 2 - Processor Data (Per Processor)
DESCRIPTION - Real System or CPU operation exception.
A separate record is generated for each online
processor.
MRSYTPRP Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 124 SYTPRP Start of monitor record
0 0 Character 0 SYTPRP_MRHDR Record header. See MRRECHDR
for details.
0 0 Character 20 MRHDR
0 0 Unsigned 2 MRHDRLEN record length in bytes
2 2 Unsigned 2 MRHDRZER field of zeros
4 4 Unsigned 1 MRHDRDM domain identifier
5 5 Unsigned 1 *
6 6 Unsigned 2 MRHDRRC record identifier
8 8 Character 8 MRHDRTOD Time at which this record was
built. In time-of-day (TOD)
clock format. See IBM System
370 XA Principle of Operation
for explanation of format.
16 10 Character 4 *
20 14 Character 0 MRHDR_END End of header
20 14 Unsigned 2 SYTPRP_PFXCPUAD Real processor's CPU address
22 16 Unsigned 2 SYTPRP_PLSCUHAF Count of times a VMDBK was
dispatched with 'hard affinity'
(i.e., dedicated to this
processor)
24 18 Character 8 SYTPRP_PFXPRBTM Total CPU time spent in
emulation mode on this
processor for all users
32 20 Character 8 SYTPRP_PFXUTIME Total CPU time spent on this
processor which was charged to
users. It includes both time
spent running the guest and
time that CP spends on behalf
of a user doing such things as
instruction simulation or page
translation. This is in CPU
time, not elapsed (or wall
clock) time.
40 28 Character 8 SYTPRP_PFXTMSYS Total CPU time spent on this
processor which has been
charged to the system instead
of the user. In general, this
is processing that is
inappropriate to charge to any
one particular user. Examples
include portions of the
following functions: scheduling
decisions, handling
interruptions, monitoring, and
page migration.
48 30 Character 8 * Reserved for IBM use.
Previous field is no longer
meaningful. (SYTPRP_PLSVFVTM)
56 38 Character 8 * Reserved for IBM use.
Previous field is no longer
meaningful. (SYTPRP_PLSVFOTM)
64 40 Unsigned 4 * Reserved for IBM use.
Previous field is no longer
meaningful. (SYTPRP_PLSVFLOD)
68 44 Character 8 SYTPRP_PFXTOTWT Total system wait time on
this CPU (includes both active
wait and enabled CPU wait). It
is the time this CPU had no
work to do, measured in CPU
time.
76 4C Unsigned 4 SYTPRP_PFXRUNCI Count of interceptions from
SIE on this processor. It does
NOT include interceptions from
SIE instructions issued in
order to run a 'Vguest', i.e.,
a guest of a guest, during
guest SIE simulation. It does
NOT include interceptions
handled by the fast-path
simulation support code.
80 50 Unsigned 4 SYTPRP_PFXRUNPF Count of host page faults on
this processor resulting from
guest references to storage
paged out by CP. Does not
include faults on RCP pages
84 54 Unsigned 4 SYTPRP_PFXRUNCP Count of SIE instructions
on this processor. It does
not include instructions issued
in order to run a 'Vguest',
i.e., a guest of a guest,
during guest SIE simulation. It
does not include instructions
issued following a successful
fast-path simulation support
code.
88 58 Unsigned 4 SYTPRP_CALFSTPH Count of fast-path
instruction simulations.
PFXFSTSG + PFXFSTXC + PFXFST44
92 5C Character 8 SYTPRP_PFXSPINT Elapsed time in formal spin
locks on this real CPU starting
at zero and counting upwards.
This is measured in TOD clock
units since system IPL.
100 64 Unsigned 4 SYTPRP_PFXSPINC Count of spin lock requests
on this real CPU since IPL that
were not granted immediately.
The lock was obtained only
after spinning.
104 68 Unsigned 1 SYTPRP_PFXCPUTY CPU 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)
105 69 Character 3 * Reserved for IBM use
108 6C Unsigned 4 SYTPRP_PFXFSTPX Count of fast path processing
of partial execution interrupts
112 70 Unsigned 4 SYTPRP_PFXFSTXC Count of fast path
reflections of guest External
Call interrupts
116 74 Unsigned 4 SYTPRP_PFXFSTSG Count of fast path
simulations of SIGP External
Call instructions
120 78 Unsigned 4 SYTPRP_PFXFST44 Count of fast path
simulations of Diagnose X'44'
instructions
124 7C Character 0 SYTPRP_END
MRSYTPRP 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
SYTPRP 0 124
SYTPRP_CALFSTPH 58 4
SYTPRP_END 7C 0
SYTPRP_MRHDR 0 0
SYTPRP_PFXCPUAD 14 2
SYTPRP_PFXCPUTY 68 1
SYTPRP_PFXFSTPX 6C 4
SYTPRP_PFXFSTSG 74 4
SYTPRP_PFXFSTXC 70 4
SYTPRP_PFXFST44 78 4
SYTPRP_PFXPRBTM 18 8
SYTPRP_PFXRUNCI 4C 4
SYTPRP_PFXRUNCP 54 4
SYTPRP_PFXRUNPF 50 4
SYTPRP_PFXSPINC 64 4
SYTPRP_PFXSPINT 5C 8
SYTPRP_PFXTMSYS 28 8
SYTPRP_PFXTOTWT 44 8
SYTPRP_PFXUTIME 20 8
SYTPRP_PLSCUHAF 16 2
This information is
based on z/VM V5R4.0.
Last updated on 6 Oct 2014 at 09:06:41.
Copyright IBM Corporation, 1990, 2014