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

#### MRSYTCUM

Prolog
Control Block Contents
Cross Reference

#### MRSYTCUM Prolog

####

####

     DSECT NAME - SYTCUM
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTCUM
     DESCRIPTIVE NAME - Monitor Sample Record
            Domain 0  - System Domain
            Record 17 - Physical CPU Utilization Data for LPAR Management
     DESCRIPTION - Physical CPU utilization data for LPAR management,
                   including data for each CPU.
     NOTES:
       -- This record is generated only when the system is running
          in the logical partition ("LPAR") environment and the
          LPAR management time facility is available on the system.
       -- SYTCUM_CALMIBOF and SYTCUM_CALMIBLN should always be used
          to locate the SYTCUM_MIBDATA entries.  Their values may be
          subject to change.
       -- This record is not generated if the HMC Global
          Performance Data setting is disabled.

    MRSYTCUM Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   36  SYTCUM                 Start of monitor record
      0   0  Character    0  SYTCUM_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  SYTCUM_CALNREC         Number of SYTCUM_MIBDATA
                                                    entries found in this record.
                                                    One SYTCUM_MIBDATA entry is
                                                    created for each physical
                                                    CPU. For the total number of
                                                    physical CPUs see
                                                    SYTCUM_LCUPCPCT.
     21  15  Bitstring    1  SYTCUM_CALFLGS         Flag byte
             1... ....       SYTCUM_CALMORE         When set to  ON, indicates
                                                    an additional MRSYTCUM record
                                                    is created for this LPAR.
                                                    When OFF, indicates this is
                                                    the only or last MRSYTCUM
                                                    record for this LPAR.
             .1.. ....       *
             ..1. ....       *
             ...1 ....       *
             .... 1...       *
             .... .1..       *
             .... ..1.       *
             .... ...1       *
     22  16  Unsigned     1  SYTCUM_LCUPCPCT        Total number  of physical
                                                    CPUs.
     23  17  Character    1  *                      Reserve d for IBM use
     24  18  Signed       2  SYTCUM_CALMIBOF        Byte offset, relative to the
                                                    start of this record, to the
                                                    first SYTCUM_MIBDATA entry of
                                                    the table
     26  1A  Signed       2  SYTCUM_CALMIBLN        Length, in bytes, of a
                                                    SYTCUM_MIBDATA entry
     28  1C  Character    8  SYTCUM_LCUTCTOD        Time-of-day, in TOD clock
                                                    value, that the physical CPU
                                                    information was fetched
     36  24  Character    0  *                      Table of SYTCUM_MIBDATA
                                                    entries, one for each physical
                                                    CPU. SYTCUM_CALMIBOF,
                                                    SYTCUM_CALMIBLN and
                                                    SYTCUM_LCUPCPCT should be used
                                                    to locate this table.
    CPU Utilization data for LPAR management. There is a separate entry for
    each CPU.

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   36  SYTCUM_MIBDATA         Physical CPU data entry
      0   0  Unsigned     2  SYTCUM_LCUMCPU         Physical CPU address
      2   2  Character    8  SYTCUM_LCUMGTM         Accumulated number of
                                                    microseconds during which a
                                                    physical processor was assigned
                                                    LPAR management time. This
                                                    value is reset only when LPAR
                                                    is initialized.
     10   A  Character   16  SYTCUM_LCUPTYPE        Physical processor type as an
                                                    EBCDIC string. Contains a value
                                                    only if enhanced LPAR monitor
                                                    support with support for
                                                    secondary processors is
                                                    available as indicated by
                                                    SYTCUG_LCUT204E.
     26  1A  Character    2  *                      Reserved and available for
                                                    IBM use.
     28  1C  Character    8  SYTCUM_LCUSMTM         If non-zero, accumulated
                                                    number of microseconds during
                                                    which a physical processor
                                                    was assigned system
                                                    management time. This value
                                                    is reset only by a power on
                                                    reset.
     36  24  Character    0  SYTCUM_END

    MRSYTCUM 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
    SYTCUM                     0     36
    SYTCUM_CALFLGS            15      1
    SYTCUM_CALMIBLN           1A      2
    SYTCUM_CALMIBOF           18      2
    SYTCUM_CALMORE            15           80
    SYTCUM_CALNREC            14      1
    SYTCUM_END                24      0
    SYTCUM_LCUMCPU             0      2
    SYTCUM_LCUMGTM             2      8
    SYTCUM_LCUPCPCT           16      1
    SYTCUM_LCUPTYPE            A     16
    SYTCUM_LCUSMTM            1C      8
    SYTCUM_LCUTCTOD           1C      8
    SYTCUM_MIBDATA             0     36
    SYTCUM_MRHDR               0      0

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

    Last updated on 9 Nov 2012 at 17:04:13.

    Copyright IBM Corporation, 1990, 2012