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
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   60  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   16  SYTCUP_LCPTYPE      CPU TYPE as from EBCDIC NAME
                                                 TABLE. This table is provided by
                                                 the hardware, and describes the
                                                 type of logical processor.
     60  3C  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     60
    SYTCUP_CALCPULN        22      2
    SYTCUP_CALCPUOF        20      2
    SYTCUP_CALFLGS         1D      1
    SYTCUP_CALPTIS         1D           80
    SYTCUP_CPUDATA          0     22
    SYTCUP_LCPTYPE         2C     16
    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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003