|
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 104 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.
It 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 SYTPRP_PLSVFVTM Amount of CPU time this
processor has been using the real
vector facility while in SIE
56 38 Character 8 SYTPRP_PLSVFOTM Amount of CPU time that this
processor has spent on switching
vector users
64 40 Unsigned 4 SYTPRP_PLSVFLOD Cumulative count of the times CP
loads the vector registers from
where they were saved on
guest-owned storage frames.
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 instructions from SIE
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 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 104
SYTPRP_CALFSTPH 58 4
SYTPRP_END 68 0
SYTPRP_MRHDR 0 0
SYTPRP_PFXCPUAD 14 2
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
SYTPRP_PLSVFLOD 40 4
SYTPRP_PLSVFOTM 38 8
SYTPRP_PLSVFVTM 30 8
This information is
based on z/VM V4R4.0.
Last updated on 12 May 2005 at 14:31:00.
Copyright IBM Corporation, 1990, 2003