Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTSYG
PrologControl 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 124 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 The capability of a secondary CPU in the configuration 60 3C Unsigned 4 SYTSYG_CPUCAPAB 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. This value applies to each of the CPUs in this configuration. 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 The nominal capability of a CPU in the configuration 124 7C 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 124 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 7C 0 SYTSYG_FTRABORT 20 4 SYTSYG_FTRDONE 1C 4 SYTSYG_FTRNOTEL 24 4 SYTSYG_FTRWRITE 28 4 SYTSYG_MAI_MISS 70 4 SYTSYG_MAI_UREC 74 4 SYTSYG_MRHDR 0 0 SYTSYG_NCPCAPAB 78 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 V6R1.0.
Last updated on 14 Sep 2010 at 13:10:13.
Copyright IBM Corporation, 1990, 2010