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

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003