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: 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.


MRSYTSYG Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   144  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 is 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 is 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 secondary CPU in the configuration. When zero, all CPUs of any CPU type in the configuration have the same capability, as specified by the CPU capability, SYTSYG_CPUCAPAB. In integer format. 60 3C Unsigned 4 SYTSYG_CPUCAPAB STSI 1.2.2 field. Specifies the capability of one of the CPUs in the current configuration. Used as an indication of the capability of the CPU relative to the capability of other CPU models. In integer format. 64 40 Unsigned 2 SYTSYG_CPUCOUNT The Total number of CPUs in the configuration. Includes all CPUs in the configured, standby, andthe reserved state. 66 42 Unsigned 2 SYTSYG_CPUCFGCT Specifies the number of CPUs 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 Specifies the number of CPUs in the standby state. A CPU 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 in the configured state. 70 46 Unsigned 2 SYTSYG_CPURESVD Specifies the number of CPUs in the reserved state. A CPU 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 in 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 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 The Total number of Logical CPUs that are provided for this level-3 configuration. Includes all of the logical CPUs that are in the configured, standby, and the reserved state. 76 4C Unsigned 2 SYTSYG_VL3CFGCT Specifies the number of logical CPUs for this level-3 configuration that are in the configured state. A logical CPU is in the configured state when it is in the level-3 configuration and available to be used to execute programs. 78 4E Unsigned 2 SYTSYG_VL3STNBY Specifies the number of logical CPUs for this level-3 configuration that are in the standby state. A logical 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 in the configured state. 80 50 Unsigned 2 SYTSYG_VL3RESVD Specifies the number of logical CPUs for this level-3 configuration that are in the reserved state. A logical 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 in the configured state. 82 52 Character 2 * Reserved and available for IBM use. 84 54 Character 8 SYTSYG_VL3MNAME Specifies the name of this level-3 configuration. 92 5C Unsigned 4 SYTSYG_VL3CAF The Capabiltiy 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 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 CPU in the configuration When zero, this means the system is not operating at reduced speed, so the primary capability, SYTSYG_CPUCAPAB, value applies. In integer format. 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 secondary CPU in the configuration. When zero, all CPUs of any CPU type in the configuration have the same capability, as specified by the CPU capability, SYTSYG_RCCCCAPF. In Binary Floating Point format. 136 88 Unsigned 4 SYTSYG_RCCCCAPF STSI 1.2.2 field. Specifies the capability of each primary CPU in the current configuration. Used as an indication of the capability of the CPU relative to the capability of other CPU models. In BFP format 140 8C Unsigned 4 SYTSYG_RCCNCAPF STSI 1.2.2 field. The nominal capability of a CPU in the configuration. When zero, this means the system is not operating at reduced speed, so the primary capability, SYTSYG_RCCCCAPF, value applies. In BFP format. 144 90 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    144
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                84      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_RCCCCAPF           88      4
SYTSYG_RCCNCAPF           8C      4
SYTSYG_RCCSCAPF           84      4
SYTSYG_SCPCAPAB           38      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 V6R2.0.
Last updated on 13 Feb 2015 at 21:17:04.
Copyright IBM Corporation, 1990, 2015