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

#### MRSYTSPT

Prolog
Control Block Contents
Cross Reference

#### MRSYTSPT Prolog

####

####

     DSECT NAME - SYTSPT
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTSPT
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 0  - System Domain
                        Record 24 - Scheduler Activity per processor
                                    type (CP, IFL, zIIP, zAAP, ICF)
     DESCRIPTION - Provides information concerning scheduling
                   of work in the system to aid an installation
                   in the use of tuning commands. This information
                   should be used with records MRSYTSCG (Domain 0,
                   Record 10) and MRSYTSCP (Domain 0, Record 13) for
                   for a complete picture of scheduling in the system.
                   Much of the scheduling of work in VM is done
                   according to the type of processor.  One
                   of these records is created for each
                   processor type.

    MRSYTSPT Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   56  SYTSPT                 start of monitor record
      0   0  Character    0  SYTSPT_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     1  SYTSPT_CALTYPE         Processor 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)
     21  15  Character    3  *                      Reserved and available for
                                                    IBM use.
     24  18  Character    8  SYTSPT_SRXATOD         Artificial TOD. This TOD only
                                                    advances at the rate the system
                                                    is running user work.
     32  20  Character    8  SYTSPT_SRXATOD2        Artificial TOD2. This TOD
                                                    only advances with each CPU's
                                                    user time and each CPU's wait
                                                    time.
     40  28  Signed       4  SYTSPT_SRXRELDL        Cardinal count of total
                                                    relative shares of all VMDBKs
                                                    in the dispatch list.
     44  2C  Signed       4  SYTSPT_SRXABSDL        Cardinal count of total
                                                    absolute shares of all VMDBKs
                                                    in the dispatch list. Unit of
                                                    value is a hexadecimal factor
                                                    scaled 16 bits. For example,
                                                    X'00010000' = 1.00(100%),
                                                    X'0000C000' = 0.75(75%),
                                                    X'00008000' = 0.50(50%), etc.
                                                    Set to zero if user is a
                                                    RELATIVE share user.
     48  30  Unsigned     4  SYTSPT_SRXLLCNT        Count of adds to the
                                                    limit-list. This count does not
                                                    include adds resulting from
                                                    virtual-MP priority drop.
     52  34  Unsigned     4  SYTSPT_SRXCONLL        Count of users actually ON
                                                    the Limit List.
     56  38  Character    0  SYTSPT_END

    MRSYTSPT 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
    SYTSPT                     0     56
    SYTSPT_CALTYPE            14      1
    SYTSPT_END                38      0
    SYTSPT_MRHDR               0      0
    SYTSPT_SRXABSDL           2C      4
    SYTSPT_SRXATOD            18      8
    SYTSPT_SRXATOD2           20      8
    SYTSPT_SRXCONLL           34      4
    SYTSPT_SRXLLCNT           30      4
    SYTSPT_SRXRELDL           28      4

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

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009