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 28 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 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_CALMIBLN           1A      2
SYTCUM_CALMIBOF           18      2
SYTCUM_LCUMCPU             0      2
SYTCUM_LCUMGTM             2      8
SYTCUM_LCUPCPCT           14      1
SYTCUM_LCUPTYPE            A     16
SYTCUM_LCUTCTOD           1C      8
SYTCUM_MIBDATA             0     28
SYTCUM_MRHDR               0      0
SYTCUM_END                1C      0

This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007