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

#### MRSYTCUG

Prolog
Control Block Contents
Cross Reference

#### MRSYTCUG Prolog

####

####

     DSECT NAME - SYTCUG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTCUG
     DESCRIPTIVE NAME - Monitor Sample Record
                   Domain 0  - System Domain
                   Record 15 - Logical CPU Utilization Data (Global)
     DESCRIPTION - Global description of logical CPU utilization in
                   a LPAR environment.  This record contains only data
                   of global nature and exists only when the system is
                   running under control of the PR/SM feature.  For
                   descriptions of individual logical partitions and
                   their logical CPUs, see the MRSYTCUP (Domain 0,
                   Record 16) record.
     NOTE: Data in the STSI fields is produced when the necessary
           architecture is present for the STSI instruction.
           When this is not present the field values will be 0's.

    MRSYTCUG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   56  SYTCUG                 Start of monitor record
      0   0  Character    0  SYTCUG_MRHDR           Record header
      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  SYTCUG_LCUTNPAR        Number of defined logical
                                                    partitions. Each logical
                                                    partition is described in a
                                                    separate record, MRSYTCUP
                                                    (Domain 0, Record 16).
     21  15  Bitstring    1  SYTCUG_LCUTFLAG        Flag byte
              1... ....      SYTCUG_LCUTPHYS        LPAR management time facility
                                                    is available on this system.
                                                    Physical CPU utilization data
                                                    is provided in MRSYTCUM (Domain
                                                    0, Record 17)
              .1.. ....      SYTCUG_LCUT204A        Indicates enhanced LPAR
                                                    monitor support available. The
                                                    enhanced LPAR monitor support
                                                    allows for reporting of large
                                                    number of logical processors
                                                    and for the CPU type reported
                                                    in the SYTCUP_LCPTYPE field of
                                                    the MRSYTCUP record (D0/R16).
              ..1. ....      SYTCUG_LCUT204S        Indicates the storage
                                                    frame(s) required to obtain the
                                                    enhanced LPAR statistics was
                                                    unavailable for this interval.
                                                    The number of frames required
                                                    is based on the number of LPARs
                                                    and Logical processors on the
                                                    system. These frames must be
                                                    contiguous. This indicates that
                                                    data may not be reported for
                                                    all logical CPUs.
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     22  16  Character    2  *                      Reserved for IBM use
     24  18  Unsigned     2  SYTCUG_LCUTSLCE        Global time slice, in
                                                    milliseconds, if defined by
                                                    operator. Otherwise, zero.
     26  1A  Unsigned     2  SYTCUG_LCUTPCCT        Number of CPUs in the
                                                    physical system, or in the
                                                    physical partition if the
                                                    system is running in physically
                                                    partitioned mode.
                                                    ***********************
    STSI 2.2.2 fields

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

     28  1C  Unsigned     2  SYTCUG_LPNUMBER        LPAR Number of the level-2
                                                    configuration. This number is
                                                    unique to this configuration
                                                    from all other level-2
                                                    configurations provided by the
                                                    same LPAR hypervisor.
     30  1E  Character    1  *                      Reserved and available for
                                                    IBM use.
     31  1F  Bitstring    1  SYTCUG_CPUCHAR         Describes the characteristics
                                                    of the logical CPUs that are
                                                    provided for the level-2
                                                    configuration.
     32  20  Unsigned     2  SYTCUG_CPUCOUNT        Specifies the total number of
                                                    logical CPUs that are provided
                                                    for this level-2 configuration.
                                                    This number includes all of the
                                                    logical CPUs that are in the
                                                    configured state, the standby
                                                    state, or the reserved state.
     34  22  Unsigned     2  SYTCUG_CPUCFGCT        Specifies the number of
                                                    logical CPUs for this level-2
                                                    configuration that are in the
                                                    configured state.
     36  24  Unsigned     2  SYTCUG_CPUSTNBY        Specifies the number of
                                                    logical CPU's for this level-2
                                                    configuration that are in the
                                                    standby state. A logical CPU is
                                                    in the standby state when it is
                                                    in the level-2 configuration,
                                                    is not available to be used to
                                                    execute programs, and can be
                                                    made available by issuing
                                                    instructions to place it in the
                                                    configured state.
     38  26  Unsigned     2  SYTCUG_CPURESVD        Specifies the number of
                                                    logical CPU's for this level-2
                                                    configuration that are in the
                                                    reserved state. A logical CPU
                                                    is in the reserved state when
                                                    it is in the level-2
                                                    configuration, is not available
                                                    to be used to execute programs,
                                                    and cannot be made available by
                                                    issuing instructions to place
                                                    it in the configured state.
     40  28  Character    8  SYTCUG_LPARNAME        Specified the name of this
                                                    level-2 configuration.
     48  30  Unsigned     4  SYTCUG_LPARCAF         The LPAR Capabiltiy
                                                    Adjustment Factor specifies the
                                                    amount of the underlying
                                                    level-1 configuration
                                                    capability that is allowed to
                                                    be used for this level-2
                                                    configuration by the LPAR
                                                    hypervisor. The maximum value
                                                    is 1000, and the fraction of
                                                    level-1 configuration
                                                    capability is determined by
                                                    dividing the CAF value by 1000.
     52  34  Unsigned     2  SYTCUG_CPUDEDCT        Specifies the number of
                                                    configured state logical CPUs
                                                    for this level-2 configuration
                                                    that are provided using
                                                    dedicated level-1 CPUs
     54  36  Unsigned     2  SYTCUG_CPUSHARD        Specifies the number of
                                                    configured state logical CPUs
                                                    for this level-2 configuration
                                                    that are provided using shared
                                                    level-1 CPUs.
     56  38  Character    0  SYTCUG_END

    MRSYTCUG 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
    SYTCUG                     0     56
    SYTCUG_CPUCFGCT           22      2
    SYTCUG_CPUCHAR            1F      1
    SYTCUG_CPUCOUNT           20      2
    SYTCUG_CPUDEDCT           34      2
    SYTCUG_CPURESVD           26      2
    SYTCUG_CPUSHARD           36      2
    SYTCUG_CPUSTNBY           24      2
    SYTCUG_END                38      0
    SYTCUG_LCUTFLAG           15      1
    SYTCUG_LCUTNPAR           14      1
    SYTCUG_LCUTPCCT           1A      2
    SYTCUG_LCUTPHYS           15           80
    SYTCUG_LCUTSLCE           18      2
    SYTCUG_LCUT204A           15           40
    SYTCUG_LCUT204S           15           20
    SYTCUG_LPARCAF            30      4
    SYTCUG_LPARNAME           28      8
    SYTCUG_LPNUMBER           1C      2
    SYTCUG_MRHDR               0      0

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

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

    Copyright IBM Corporation, 1990, 2005