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   140  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  Unsigned      4  SYTPRP_PLS9CNR         Count of times a guest
                                                      issued Diagnose x'9C' and the
                                                      target was in a VMDSTATE <
                                                      VMDREADY
     128  80  Unsigned      4  SYTPRP_PLS9CWT         Count of times a guest
                                                      issued Diag x'9C' and the
                                                      target was found in wait
                                                      state (PSW.W=1)
     132  84  Unsigned      4  SYTPRP_PLS9CSWT        Count of times a guest
                                                      issued Diag x'9C' and the
                                                      issuer had to soft-wait on
                                                      the target.
     136  88  Unsigned      4  SYTPRP_PLS9CDSP        Count of times a guest
                                                      issued Diag x'9C' and the
                                                      target was already dispatched
     140  8C  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    140
    SYTPRP_CALFSTPH           58      4
    SYTPRP_END                8C      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
    SYTPRP_PLS9CDSP           88      4
    SYTPRP_PLS9CNR            7C      4
    SYTPRP_PLS9CSWT           84      4
    SYTPRP_PLS9CWT            80      4

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

    Last updated on 06 Oct 2014 at 09:04:04.

    Copyright IBM Corporation, 1990, 2014