Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSYTCUP

Prolog
Control Block Contents
Storage Layout
Cross Reference

MRSYTCUP Prolog

 DSECT NAME - SYTCUP
 FUNCTION - Map a Monitor record.
 LOCATED BY -
      Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
      MRRECHDR    Monitor Record Header
 NAME - MRSYTCUP
 DESCRIPTIVE NAME - Monitor Sample Record
      Domain 0  - System Domain
      Record 16 - CPU Utilization Data in a Logical Partition
 DESCRIPTION - CPU utilization data for an individual logical
             partition.  Also included are data for each logical
             CPU in the partition.
 NOTES:
 -- This record is generated only when the system is running
    in the logical partition ("LPAR") environment.
 -- A separate record is generated for each logical partition in
    the system.
 -- SYTCUP_CALCPUOF and SYTCUP_CALCPULN should always be used
    to locate the SYTCUP_CPUDATA entries.  Their values may be
    subject to change.


MRSYTCUP Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)         Description
 
  0   0  Structure   44  SYTCUP              Start of monitor record
  0   0  Character    0  SYTCUP_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  Character    8  SYTCUP_LCUPNAME     Logical partition name
 28  1C  Unsigned     1  SYTCUP_LCUPPNUM     Logical partition number
 29  1D  Bitstring    1  SYTCUP_CALFLGS      Flag byte
          1... ....      SYTCUP_CALPTIS      When set to ON, this logical
                                             partition is the one that fetched
                                             the logical CPU utilization data
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      *                   
          .... ...1      *                   
 30  1E  Unsigned     1  SYTCUP_LCUPCPCT     Number of logical CPUs in this
                                             partition. This also is the number
                                             of SYTCUP_CPUDATA entries in the
                                             record. If zero, this partition is
                                             not active.
 31  1F  Character    1  *                   Reserved for IBM use
 32  20  Signed       2  SYTCUP_CALCPUOF     Byte offset, relative from the
                                             start of this record, to the first
                                             SYTCUP_CPUDATA entry of the table
 34  22  Signed       2  SYTCUP_CALCPULN     length, in bytes, of a
                                             SYTCUP_CPUDATA entry
 36  24  Character    8  SYTCUP_LCUTCTOD     Time-of-day, in TOD clock value,
                                             that the logical CPU information
                                             was fetched
 44  2C  Character    0  *                   Table of SYTCUP_CPUDATA entries,
                                             one for each logical CPU in the
                                             partition. SYTCUP_CALCPUOF,
                                             SYTCUP_CALCPULN and
                                             SYTCUP_LCBPCPCT should be used to
                                             locate this table.

CPU Utilization data for an individual logical CPU. There is a separate entry for each logical CPU in the partition.
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 22 SYTCUP_CPUDATA Logical CPU data entry 0 0 Unsigned 2 SYTCUP_LCUCPUID Logical CPU address 2 2 Unsigned 2 SYTCUP_LCUCWGHT Processing weight as assigned to this partition. Value is in range of 0 to 999 except that it is set to 65535 (x'FFFF') if this CPU is dedicated to this logical partition. 4 4 Bitstring 1 SYTCUP_LCUCFLGS CPU Information flag byte 1... .... SYTCUP_LCUCWCPL Wait completion flag. ON = 'YES' has been specified in the Wait Completion option of the logical partition controls. Logical CPU dispatching is to be done without regard to logical CPU wait states. OFF = CPU time not used by one logical CPU may be given to another logical CPU or logical partition. .1.. .... SYTCUP_LCUCCAPP Partition-Capping flag. ON if the operator has set capped=yes in the logical-partition controls. Not set if the logical partition uses dedicated CPUs. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 5 5 Unsigned 1 * Reserved for IBM use 6 6 Character 8 SYTCUP_LCUCACTM Accumulated number of microseconds during which a physical processor was assigned to this logical processor. Accumulation continues (i.e., is not reset) while the logical processor is defined. 14 E Character 8 SYTCUP_LCUCLPTM Accumulated number of microseconds, excluding LPAR-management time, during which a physical CPU was assigned to this logical CPU. This value is not reset while the logical CPU is defined.

MRSYTCUP 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
SYTCUP                  0     44
SYTCUP_CALCPULN        22      2
SYTCUP_CALCPUOF        20      2
SYTCUP_CALFLGS         1D      1
SYTCUP_CALPTIS         1D           80
SYTCUP_CPUDATA          0     22
SYTCUP_LCUCACTM         6      8
SYTCUP_LCUCCAPP         4           40
SYTCUP_LCUCFLGS         4      1
SYTCUP_LCUCLPTM         E      8
SYTCUP_LCUCPUID         0      2
SYTCUP_LCUCWCPL         4           80
SYTCUP_LCUCWGHT         2      2
SYTCUP_LCUPCPCT        1E      1
SYTCUP_LCUPNAME        14      8
SYTCUP_LCUPPNUM        1C      1
SYTCUP_LCUTCTOD        24      8
SYTCUP_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