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