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
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. 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 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

    This information is
    based on z/VM V5R2.0.

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005