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
Storage Layout
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 V4R3.0.

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002