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

#### MRSYTSYG

Prolog
Control Block Contents
Cross Reference

#### MRSYTSYG Prolog

     DSECT NAME - SYTSYG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTSYG
     DESCRIPTIVE NAME -  Monitor Sample Record
                         Domain 0 - System Domain
                         Record 19- System Data (Global)
     DESCRIPTION - System wide utilization data.
     NOTE:
       -- For additional information about the format and
          meaning of the SYTSYG_SSIxxxxx fields, refer to
           - Principles of Operation for the layout of the
             STSI output (SYSIB 1.2.2 and 2.2.2) which is
             documented in Chapter 10 under "STORE SYSTEM
             INFORMATION".
       -- When a field in this record uses the term "CPU/core",
          the meaning of the field changes based on whether
          Multithreading (MT) is enabled for this partition.
          Refer to Monitor Sample Record Domain 1 Record 4
          (MRMTRSYS) to determine whether MT is enabled for
          this partition as well as the number of threads for
          each CPU type.
           When MT is not enabled, a physical core contains
           only one CPU:
             - CPU   : central processing unit.
             - CORE  : physical unit containing one CPU.
                       In this environment the core has
                       1 thread, the term "thread" is not used,
                       and the term "CPU" is generally favored
                       over the term "core".
           When MT is enabled, a physical core contains one or
           more CPUs (aka "threads"):
             - CPU   : central processing unit. Identified by
                       CPU address which consists of core ID
                       and thread ID.
             - CORE  : physical unit containing one or more CPUs
                       (aka "threads"). All CPUs of a core have
                       the same CPU type.
             - THREAD: synonym for a CPU that is a member of a
                       core. Each thread on a core has a
                       distinct thread ID (TID), numbered from
                       0 up to the maximum thread ID available
                       on the core.

#### MRSYTSYG Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   164  SYTSYG                 Start of monitor record
       0   0  Character     0  SYTSYG_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  SYTSYG_XCTMSACT        Accumulated elapsed time in
                                                      microseconds that routines
                                                      that comprise user exits were
                                                      active
      28  1C  Unsigned      4  SYTSYG_FTRDONE         Number of times fast CCW
                                                      translation processing
                                                      completed successfully for a
                                                      DASD device.
      32  20  Unsigned      4  SYTSYG_FTRABORT        Number of times fast CCW
                                                      translation processing was
                                                      aborted for a DASD device.
      36  24  Unsigned      4  SYTSYG_FTRNOTEL        Number of times a presented
                                                      CCW for a DASD device was not
                                                      eligible for fast CCW
                                                      translation. There are cases
                                                      where ineligibility may have
                                                      been determined before the
                                                      CCW was presented to the fast
                                                      path simulator. Those cases
                                                      are not counted here.
      40  28  Unsigned      4  SYTSYG_FTRWRITE        Number of times a write
                                                      channel program for a DASD
                                                      device was presented for fast
                                                      CCW translation.
      44  2C  Unsigned      4  SYTSYG_CTNDONE         Number of times fast CCW
                                                      translation processing
                                                      completed successfully for a
                                                      network device.
      48  30  Unsigned      4  SYTSYG_CTNABORT        Number of times fast CCW
                                                      translation processing was
                                                      aborted for a network device.
      52  34  Unsigned      4  SYTSYG_CTNNOTEL        Number of times a presented
                                                      CCW for a network device was
                                                      not eligible for fast CCW
                                                      translation. There are cases
                                                      where ineligibility may have
                                                      been determined before the
                                                      CCW was presented to the fast
                                                      path simulator. Those cases
                                                      are not counted here.
                                                      ***********************
    STSI 1.2.2 fields

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

      56  38  Unsigned      4  SYTSYG_SCPCAPAB        STSI 1.2.2 field. The
                                                      capability of a specialty
                                                      CPU/core in the configuration
                                                      in integer format. Used as an
                                                      indication of the capability
                                                      of the CPU/core relative to
                                                      the capability of other
                                                      processor models. When zero,
                                                      all CPUs of any CPU type in
                                                      the configuration have the
                                                      same capability, as specified
                                                      by the CPU capability,
                                                      SYTSYG_CPUCAPAB.
      60  3C  Unsigned      4  SYTSYG_CPUCAPAB        STSI 1.2.2 field. Specifies
                                                      the capability of a general
                                                      CPU/core in the current
                                                      configuration in integer
                                                      format. Used as an indication
                                                      of the capability of the
                                                      CPU/core relative to the
                                                      capability of other processor
                                                      models.
      64  40  Unsigned      2  SYTSYG_CPUCOUNT        STSI 1.2.2 field. The total
                                                      number of general CPUs/cores
                                                      in the configuration.
                                                      Includes all CPUs/cores in
                                                      the configured, standby and
                                                      reserved states.
      66  42  Unsigned      2  SYTSYG_CPUCFGCT        STSI 1.2.2 field. Specifies
                                                      the number of general
                                                      CPUs/cores in the configured
                                                      state. A CPU is in the
                                                      configured state when it is
                                                      in the configuration and
                                                      available to be used to
                                                      execute programs.
      68  44  Unsigned      2  SYTSYG_CPUSTNBY        STSI 1.2.2 field. Specifies
                                                      the number of general
                                                      CPUs/cores in the standby
                                                      state. A CPU/core is in the
                                                      standby state when it is in
                                                      the configuration, is not
                                                      available to be used to
                                                      execute programs, and can be
                                                      made available by issuing
                                                      instructions to place it into
                                                      the configured state.
      70  46  Unsigned      2  SYTSYG_CPURESVD        STSI 1.2.2 field. Specifies
                                                      the number of general
                                                      CPUs/cores in the reserved
                                                      state. A CPU/core is in the
                                                      reserved state when it is in
                                                      the configuration, is not
                                                      available to be used to
                                                      execute programs, and cannot
                                                      be made available by issuing
                                                      instructions to place it into
                                                      the configured state.
                                                      ***********************
    STSI 3.2.2 fields This information is level-3 from a VMDBK if available.

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

      72  48  Unsigned      1  SYTSYG_VL3DBCT         STSI 3.2.2 field. Specifies
                                                      the number of VM levels
                                                      running between the level at
                                                      which this data was collected
                                                      and the hardware. For
                                                      example, data collected from
                                                      a VM system running second
                                                      level would show a value of
                                                      1. A third level system would
                                                      show a value of 2.
      73  49  Character     1  *                      Reserved and available for
                                                      IBM use.
      74  4A  Unsigned      2  SYTSYG_VL3COUNT        STSI 3.2.2 field. The total
                                                      number of primary virtual
                                                      CPUs that are provided for
                                                      this level-3 configuration.
                                                      Includes all of the virtual
                                                      CPUs that are in the
                                                      configured, standby, or the
                                                      reserved states.
      76  4C  Unsigned      2  SYTSYG_VL3CFGCT        STSI 3.2.2 field. Specifies
                                                      the number of primary virtual
                                                      CPUs for this level-3
                                                      configuration that are in the
                                                      configured state. A virtual
                                                      CPU is in the configured
                                                      state when it is in the
                                                      level-3 configuration and
                                                      available to abe used to
                                                      execute programs.
      78  4E  Unsigned      2  SYTSYG_VL3STNBY        STSI 3.2.2 field. Specifies
                                                      the number of primary virtual
                                                      CPUs for this level-3
                                                      configuration that are in the
                                                      standby state. A virtual CPU
                                                      is in the standby state when
                                                      it is in the level-3
                                                      configuration, is not
                                                      available to be used to
                                                      execute programs, and can be
                                                      made available by issuing
                                                      instructions to place it into
                                                      the configured state.
      80  50  Unsigned      2  SYTSYG_VL3RESVD        STSI 3.2.2 field. Specifies
                                                      the number of primary virtual
                                                      CPUs for this level-3
                                                      configuration that are in the
                                                      reserved state. A virtual CPU
                                                      is in the reserved state when
                                                      it is in the level-3
                                                      configuration, is not
                                                      available to be used to
                                                      execute programs, and cannot
                                                      be made available by issuing
                                                      instructions to place it into
                                                      the configured state.
      82  52  Character     2  *                      Reserved and available for
                                                      IBM use.
      84  54  Character     8  SYTSYG_VL3MNAME        STSI 3.2.2 field. Specifies
                                                      the name of this level-3
                                                      configuration.
      92  5C  Unsigned      4  SYTSYG_VL3CAF          STSI 3.2.2 field. The
                                                      Capability Adjustment Factor
                                                      specifies the amount of the
                                                      underlying level-1, level-2
                                                      or level-3 configuration
                                                      capability that is allowed to
                                                      be used for this level-3
                                                      configuration by the virtual
                                                      machine control program. The
                                                      maximum value is 1000, and
                                                      the fraction of level-3
                                                      configuration capability is
                                                      determined by dividing the
                                                      CAF value by 1000.
      96  60  Character    16  SYTSYG_VL3CPNAM        STSI 3.2.2 field.
                                                      Identifies the virtual
                                                      machine control program that
                                                      provides this level-3
                                                      configuration. This may
                                                      include qualifiers such as
                                                      version number and release
                                                      level.
     112  70  Unsigned      4  SYTSYG_MAI_MISS        Count of Missing Adapter
                                                      Interruptions
     116  74  Unsigned      4  SYTSYG_MAI_UREC        Count of unrecoverable
                                                      Adapter Interruptions
     120  78  Unsigned      4  SYTSYG_NCPCAPAB        STSI 1.2.2 field. The
                                                      nominal capability of a
                                                      general CPU/core in the
                                                      configuration in integer
                                                      format. When zero, this means
                                                      the system is not operating
                                                      at reduced speed, so the
                                                      primary capability,
                                                      SYTSYG_CPUCAPAB, value
                                                      applies.
     124  7C  Unsigned      4  SYTSYG_FXRDONE         Number of times zHPF DCW
                                                      translation processing
                                                      completed successfully for a
                                                      DASD device.
     128  80  Unsigned      4  SYTSYG_FXRWRITE        Number of times a write
                                                      channel program for a DASD
                                                      device was presented for zHPF
                                                      DCW translation.
     132  84  Unsigned      4  SYTSYG_RCCSCAPF        STSI 1.2.2 field. The
                                                      capability of a specialty
                                                      CPU/core in the configuration
                                                      in binary floating point
                                                      (BFP) format. Used as an
                                                      indication of the capability
                                                      of the CPU/core relative to
                                                      the capability of other
                                                      processor models. When zero,
                                                      all CPUs of any CPU type in
                                                      the configuration have the
                                                      same capability, as specified
                                                      by the CPU capability,
                                                      SYTSYG_RCCCCAPF.
     136  88  Unsigned      4  SYTSYG_RCCCCAPF        STSI 1.2.2 field. Specifies
                                                      the capability of a general
                                                      CPU/core in the current
                                                      configuration in BFP format.
                                                      Used as an indication of the
                                                      capability of the CPU/core
                                                      relative to the capability of
                                                      other processor models.
     140  8C  Unsigned      4  SYTSYG_RCCNCAPF        STSI 1.2.2 field. The
                                                      nominal capability of a
                                                      general CPU/core in the
                                                      configuration in BFP format.
                                                      When zero, this means the
                                                      system is not operating at
                                                      reduced speed, so the primary
                                                      capability, SYTSYG_RCCCCAPF,
                                                      value applies.
     144  90  Unsigned      4  SYTSYG_SSI1PCPS        STSI 1.2.2 field. General
                                                      CPU/core speed, in
                                                      approximate CPU cycles per
                                                      microsecond.
     148  94  Unsigned      4  SYTSYG_SSI1SCPS        STSI 1.2.2 field. Specialty
                                                      CPU/core speed, in
                                                      approximate CPU cycles per
                                                      microsecond.
                                                      *****************************
                                                      *****************************
                                                      *** End of additional STSI
                                                      1.2.2 fields
                                                      *****************************
                                                      *****************************
                                                      ***
     152  98  Bitstring     1  SYTSYG_CALFLG1         Miscellaneous flags
              1... ....        SYTSYG_PFXSHLAV        1 => CPPROTECT avbl
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     153  99  Bitstring     1  SYTSYG_RCCSHELD        CPPROTECT bits
              1... ....        SYTSYG_RCCSHLDF        0=MODE2 DFLT OFF
                                                      1=MODE2 DFLT ON
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     154  9A  Bitstring     1  SYTSYG_RCCSHLPC        CPPROTECT bits
              1... ....        SYTSYG_RCCSHLR1         MODE1 rqstd
              .1.. ....        SYTSYG_RCCSHLR2         MODE2 rqstd
              ..1. ....        *
              ...1 ....        *
              .... 1...        SYTSYG_RCCSHLA1         MODE1 active
              .... .1..        SYTSYG_RCCSHLA2         MODE2 active
              .... ..1.        *
              .... ...1        *
     155  9B  Bitstring     1  SYTSYG_RCCSHLHC        CPPROTECT bits
              1... ....        SYTSYG_RCCSHLC1         MODE1 capable
              .1.. ....        SYTSYG_RCCSHLC2         MODE2 capable
              ..1. ....        *
              ...1 ....        *
              .... 1...        SYTSYG_RCCSHLI1         MODE1 inherent
              .... .1..        SYTSYG_RCCSHLI2         MODE2 inherent
              .... ..1.        *
              .... ...1        *
     156  9C  Character     4  *                      Reserved for IBM use
     160  A0  Character     4  *                      Reserved for IBM use
     164  A4  Character     0  SYTSYG_END

#### MRSYTSYG 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
    SYTSYG                     0    164
    SYTSYG_CALFLG1            98      1
    SYTSYG_CPUCAPAB           3C      4
    SYTSYG_CPUCFGCT           42      2
    SYTSYG_CPUCOUNT           40      2
    SYTSYG_CPURESVD           46      2
    SYTSYG_CPUSTNBY           44      2
    SYTSYG_CTNABORT           30      4
    SYTSYG_CTNDONE            2C      4
    SYTSYG_CTNNOTEL           34      4
    SYTSYG_END                98      0
    SYTSYG_FTRABORT           20      4
    SYTSYG_FTRDONE            1C      4
    SYTSYG_FTRNOTEL           24      4
    SYTSYG_FTRWRITE           28      4
    SYTSYG_FXRDONE            7C      4
    SYTSYG_FXRWRITE           80      4
    SYTSYG_MAI_MISS           70      4
    SYTSYG_MAI_UREC           74      4
    SYTSYG_MRHDR               0      0
    SYTSYG_NCPCAPAB           78      4
    SYTSYG_PFXSHLAV           98        80
    SYTSYG_RCCCCAPF           88      4
    SYTSYG_RCCNCAPF           8C      4
    SYTSYG_RCCSCAPF           84      4
    SYTSYG_RCCSHELD           99      1
    SYTSYG_RCCSHLA1           9A        08
    SYTSYG_RCCSHLA2           9A        04
    SYTSYG_RCCSHLC1           9B        80
    SYTSYG_RCCSHLC2           9B        40
    SYTSYG_RCCSHLDF           99        80
    SYTSYG_RCCSHLHC           9B
    SYTSYG_RCCSHLI1           9B        08
    SYTSYG_RCCSHLI2           9B        04
    SYTSYG_RCCSHLPC           9A      1
    SYTSYG_RCCSHLR1           9A        80
    SYTSYG_RCCSHLR2           9A        40
    SYTSYG_SCPCAPAB           38      4
    SYTSYG_SSI1PCPS           90      4
    SYTSYG_SSI1SCPS           94      4
    SYTSYG_VL3CAF             5C      4
    SYTSYG_VL3CFGCT           4C      2
    SYTSYG_VL3COUNT           4A      2
    SYTSYG_VL3CPNAM           60     16
    SYTSYG_VL3DBCT            48      1
    SYTSYG_VL3MNAME           54      8
    SYTSYG_VL3RESVD           50      2
    SYTSYG_VL3STNBY           4E      2
    SYTSYG_XCTMSACT           14      8

    This information is
    based on z/VM V7R2.0.

    Last updated on 08 August 2020 at 15:33:00.

    Copyright IBM Corporation, 1990, 2020