Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSYTPRP

Prolog
Control Block Contents
Storage Layout
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 does not include any
                                             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 includes time spent by the
                                             system on behalf of the user doing
                                             such things as instruction
                                             simulation. It also includes time
                                             doing other types of system work,
                                             such as making scheduling
                                             decisions.
 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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002