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

MRSYTCUG

Prolog
Control Block Contents
Cross Reference

MRSYTCUG Prolog

 DSECT NAME - SYTCUG
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRSYTCUG
 DESCRIPTIVE NAME - Monitor Sample Record
               Domain 0  - System Domain
               Record 15 - Logical CPU Utilization Data (Global)
 DESCRIPTION - Global description of logical CPU utilization in
               a LPAR environment.  This record contains only data
               of global nature and exists only when the system is
               running under control of the PR/SM feature.  For
               descriptions of individual logical partitions and
               their logical CPUs, see the MRSYTCUP (Domain 0,
               Record 16) record.
 NOTE: Data in the STSI fields is produced when the necessary
       architecture is present for the STSI instruction.
       When this is not present the field values will be 0's.


MRSYTCUG Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure    56  SYTCUG                 Start of monitor record
   0   0  Character     0  SYTCUG_MRHDR           Record header
   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  SYTCUG_LCUTNPAR        Number of defined logical
                                                  partitions. Each logical
                                                  partition is described in a
                                                  separate record, MRSYTCUP
                                                  (Domain 0, Record 16).
  21  15  Bitstring     1  SYTCUG_LCUTFLAG        Flag byte
          1... ....        SYTCUG_LCUTPHYS         LPAR management time
                                                  facility is available on this
                                                  system. Physical CPU
                                                  utilization data is provided
                                                  in MRSYTCUM (Domain 0, Record
                                                  17)
          .1.. ....        SYTCUG_LCUT204A         Indicates enhanced LPAR
                                                  monitor support available.
                                                  The enhanced LPAR monitor
                                                  support allows for reporting
                                                  of large number of logical
                                                  processors and for the CPU
                                                  type reported in the
                                                  SYTCUP_LCPTYPE field of the
                                                  MRSYTCUP record (D0/R16).
          ..1. ....        SYTCUG_LCUT204S         Indicates the storage
                                                  page(s) required to obtain
                                                  the enhanced LPAR statistics
                                                  was unavailable for this
                                                  interval. The number of pages
                                                  required is based on the
                                                  number of LPARs and Logical
                                                  processors on the system.
                                                  These pages must be
                                                  contiguous. This indicates
                                                  that data may not be reported
                                                  for all logical CPUs.
          ...1 ....        SYTCUG_LCUT204E         Indicates enhanced LPAR
                                                  monitor support available as
                                                  described for SYTCUG_LCUT204S
                                                  with the addition of support
                                                  for secondary processors such
                                                  as zIIPs, zAAPS, IFLs, and
                                                  ICFs.
          .... 1...        *                       
          .... .1..        *                       
          .... ..1.        *                       
          .... ...1        *                       
  22  16  Character     2  *                      Reserved for IBM use
  24  18  Unsigned      2  SYTCUG_LCUTSLCE        Global time slice, in
                                                  milliseconds, if defined by
                                                  operator. Otherwise, zero.
  26  1A  Unsigned      2  SYTCUG_LCUTPCCT        Number of CPUs in the
                                                  physical system, or in the
                                                  physical partition if the
                                                  system is running in
                                                  physically partitioned mode.
                                                  Includes secondary processors
                                                  if SYTCUG_LCUT204E is on
                                                  ***********************

STSI 2.2.2 fields
Offsets Dec Hex Type Len Name (Dim) Description 28 1C Unsigned 2 SYTCUG_LPNUMBER LPAR Number of the level-2 configuration. This number is unique to this configuration from all other level-2 configurations provided by the same LPAR hypervisor. 30 1E Character 1 * Reserved and available for IBM use. 31 1F Bitstring 1 SYTCUG_CPUCHAR Describes the characteristics of the logical CPUs that are provided for the level-2 configuration. 32 20 Unsigned 2 SYTCUG_CPUCOUNT Specifies the total number of logical CPUs that are provided for this level-2 configuration. This number includes all of the logical CPUs that are in the configured state, the standby state, or the reserved state. Count does not include any secondary processors 34 22 Unsigned 2 SYTCUG_CPUCFGCT Specifies the number of logical CPUs for this level-2 configuration that are in the configured state. Count does not include any secondary processors 36 24 Unsigned 2 SYTCUG_CPUSTNBY Specifies the number of logical CPU's for this level-2 configuration that are in the standby state. A logical CPU is in the standby state when it is in the level-2 configuration, is not available to be used to execute programs, and can be made available by issuing instructions to place it in the configured state. Count does not include any secondary processors 38 26 Unsigned 2 SYTCUG_CPURESVD Specifies the number of logical CPU's for this level-2 configuration that are in the reserved state. A logical CPU is in the reserved state when it is in the level-2 configuration, is not available to be used to execute programs, and cannot be made available by issuing instructions to place it in the configured state. Count does not include any secondary processors 40 28 Character 8 SYTCUG_LPARNAME Specified the name of this level-2 configuration. 48 30 Unsigned 4 SYTCUG_LPARCAF The LPAR Capabiltiy Adjustment Factor specifies the amount of the underlying level-1 configuration capability that is allowed to be used for this level-2 configuration by the LPAR hypervisor. The maximum value is 1000, and the fraction of level-1 configuration capability is determined by dividing the CAF value by 1000. 52 34 Unsigned 2 SYTCUG_CPUDEDCT Specifies the number of configured state logical CPUs for this level-2 configuration that are provided using dedicated level-1 CPUs 54 36 Unsigned 2 SYTCUG_CPUSHARD Specifies the number of configured state logical CPUs for this level-2 configuration that are provided using shared level-1 CPUs. 56 38 Character 0 SYTCUG_END

MRSYTCUG 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
SYTCUG                     0     56
SYTCUG_CPUCFGCT           22      2
SYTCUG_CPUCHAR            1F      1
SYTCUG_CPUCOUNT           20      2
SYTCUG_CPUDEDCT           34      2
SYTCUG_CPURESVD           26      2
SYTCUG_CPUSHARD           36      2
SYTCUG_CPUSTNBY           24      2
SYTCUG_END                38      0
SYTCUG_LCUTFLAG           15      1
SYTCUG_LCUTNPAR           14      1
SYTCUG_LCUTPCCT           1A      2
SYTCUG_LCUTPHYS           15           80
SYTCUG_LCUTSLCE           18      2
SYTCUG_LCUT204A           15           40
SYTCUG_LCUT204E           15           10
SYTCUG_LCUT204S           15           20
SYTCUG_LPARCAF            30      4
SYTCUG_LPARNAME           28      8
SYTCUG_LPNUMBER           1C      2
SYTCUG_MRHDR               0      0

This information is based on z/VM V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011