MRSYTCUM

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 V4R2.0.

Last updated on 15 Oct 2001 at 08:04:23.

Copyright IBM Corporation, 1990, 2001