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.

    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_LCUPCPCT        Number of physical CPUs. This
                                                    also is the number of
                                                    SYTCUM_MIBDATA entries in the
                                                    record.
     21  15  Character    3  *                      Reserved 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   10  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.

    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_CALMIBLN           1A      2
    SYTCUM_CALMIBOF           18      2
    SYTCUM_LCUMCPU             0      2
    SYTCUM_LCUMGTM             2      8
    SYTCUM_LCUPCPCT           14      1
    SYTCUM_LCUTCTOD           1C      8
    SYTCUM_MIBDATA             0     10
    SYTCUM_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