|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTSCG
PrologControl Block Contents
Cross Reference
MRSYTSCG Prolog
DSECT NAME - SYTSCG
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTSCG
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 10 - Scheduler Activity (global)
DESCRIPTION - Provides information concerning scheduling
of work in the system to aid an installation
in the use of tuning commands. This information
should be used with record MRSYTSCP (Domain 0,
Record 13) for a complete picture of scheduling
in the system.
MRSYTSCG Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 156+ SYTSCG start of monitor record 0 0 Character 0 SYTSCG_MRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Unsigned 2 SYTSCG_SRMCDISP Cardinal count of users in the dispatch list. 22 16 Unsigned 2 SYTSCG_SRMCDLDG Cardinal count of all 'loading' users in the dispatch list. 24 18 Unsigned 2 SYTSCG_SRMC1DSP Cardinal count of short, medium, and long running users in the dispatch list. 26 1A Unsigned 2 SYTSCG_SRMC2DSP Cardinal count of medium and long running users in the dispatch list. This includes all Q2 and Q3 users, but does not include Q1 or Q0 users. 28 1C Unsigned 2 SYTSCG_SRMC3DSP Cardinal count of long running users in the dispatch list. This includes all Q3 users. It does not include Q0, Q1, or Q2 users. 30 1E Unsigned 2 SYTSCG_SRMC1ELG Cardinal count of short, medium, and long running users in the eligible list. This includes all E1, E2, and E3 users. It includes no E0 users. 32 20 Unsigned 2 SYTSCG_SRMC2ELG Cardinal count of medium and long running users in the eligible list. This includes all E2 and E3 users. It includes no E0 or E1 users. 34 22 Unsigned 2 SYTSCG_SRMC3ELG Cardinal count of long-running users in the eligible list. This includes all E3 users. It includes no E0, E1, or E2 users. 36 24 Unsigned 2 SYTSCG_SRMC1DLD Cardinal count of all 'loading users' in Q1, Q2, and Q3. 38 26 Unsigned 2 SYTSCG_SRMC2DLD Cardinal count of all 'loading users' in Q2 and Q3. 40 28 Unsigned 2 SYTSCG_SRMC3DLD Cardinal count of all 'loading users' in Q3. 42 2A Unsigned 2 SYTSCG_SRMC1ELD Cardinal count of all 'loading users' in E1, E2, and E3. 44 2C Unsigned 2 SYTSCG_SRMC2ELD Cardinal count of all 'loading users' in E2 and E3. 46 2E Unsigned 2 SYTSCG_SRMC3ELD Cardinal count of all 'loading users' in E3. 48 30 Character 8 SYTSCG_SRME1ETS Amount of time, in TOD clock units, of a Q1 user's elapsed time slice. The elapsed time slice is the wall clock time this user will be allowed to remain in the dispatch list at one time. This time will change as the load on the system changes. 56 38 Unsigned 2 SYTSCG_SRME2ETF The elapsed time slice factor for Q2. To obtain the elapsed time slice for a Q2 user, multiply this value by the Q1 elapsed time slice. This time will change as the load on the system changes. 58 3A Unsigned 2 SYTSCG_SRME3ETF The elapsed time slice factor for Q3. To obtain the elapsed time slice for a Q3 user, multiply this value by the Q1 elapsed time slice. This time will change as the load on the system changes. 60 3C Signed 4 SYTSCG_SRMABSDL Cardinal count of total absolute shares of all VMDBKs in the dispatch list. Unit of value is a hexadecimal factor scaled 16 bits. For example, X'00010000' = 1.00(100%), X'0000C000' = 0.75(75%), X'00008000' = 0.50(50%), etc. Set to zero if user is a RELATIVE share user. Applies to real primary processor (CP/IFL) 64 40 Signed 4 SYTSCG_SRMRELDL Cardinal count of total relative shares of all VMDBKs in the dispatch list. Applies to real primary processor (CP/IFL) 68 44 Unsigned 4 SYTSCG_SRMTOTST Total storage to consider when selecting VMDBKs for the dispatch list. 72 48 Unsigned 4 SYTSCG_SRMWSSDL Sum of Working Set Sizes for all users (Q0...Q3) currently in the dispatch list. 76 4C Unsigned 4 SYTSCG_SRMWSSD1 Sum of WSS's for all Q1, Q2, and Q3 users currently in the dispatch list. 80 50 Unsigned 4 SYTSCG_SRMWSSD2 Sum of WSS's for all Q2 and Q3 users currently in the dispatch list. 84 54 Unsigned 4 SYTSCG_SRMWSSD3 Sum of WSS's for all Q3 users currently in the dispatch list. 88 58 Unsigned 4 SYTSCG_SRMLLCNT Count of adds to the limit-list. This count does not include adds resulting from virtual-MP priority drop. Applies to real primary processor (CP/IFL) 92 5C Unsigned 4 SYTSCG_SRMCONLL Count of users actually ON the Limit List. Applies to real primary processor (CP/IFL) 96 60 Character 8 SYTSCG_SRMATOD Artificial TOD. This TOD only advances at the rate the system is running user work. Applies to real primary processor (CP/IFL) 104 68 Character 8 SYTSCG_SRMATOD2 Artificial TOD2. This TOD only advances with each CPU's user time and each CPU's wait time. Applies to real primary processor (CP/IFL) 112 70 Unsigned 4 * Reserved and not available for future use. This field used to be SYTSCG_SRMWTCPU and was filled in from SRMWTCPU. However, the field in the SRMBK was expanded to support 64 CPUs and was renamed to SRMCPUWT. See SYTSCG_SRMCPUWT for CPUs in wait state. 116 74 Unsigned 4 SYTSCG_CALSLKCT Count of scheduler lock requests that spun attempting to acquire exclusive or a share including HCPDSP's local spin loop. 120 78 Character 8 SYTSCG_CALSLKTM Elapsed spin time on the scheduler lock starting at zero and counting up when spinning on a lock acquisition. Value is in TOD units. This includes the time HCPDSP spends in its internal spin loop. 128 80 Unsigned 4 SYTSCG_CALTLKCT Count of formal spin requests for the TRQBK queue lock. This field is part of the HCPTRQLK synchronization lock control block (SYNXSCNT). 132 84 Character 8 SYTSCG_CALTLKTM Elapsed spin time on the TRQBK queue lock starting at zero and counting up when formally spinning on lock. Value is in TOD units. This field is part of the HCPTRQLK synchronization lock control block (SYNXTIME). 140 8C Character 8 SYTSCG_SRMCPUWT Mask of CPUs in wait state containing the first 64 CPUs. This field is being retained only for compatibility and SYTSCG_SRMCPUWG should be used instead. If more than 64 CPUs are defined this field will contain information for the first 64 CPUs only. 148 94 Unsigned 2 SYTSCG_SRME0ETF The elapsed time slice factor for Q0. To obtain the elapsed time slice for a Q0 user, multiply this value by the Q1 elapsed time slice. This time will change as the load on the system changes. 150 96 Unsigned 2 * Reserved and available for future use 152 98 Unsigned 2 SYTSCG_MAXVMPRC This value defines the number of valid bits in bit mask: SYTSCG_SRMCPUWG 154 9A Unsigned 2 SYTSCG_OFCPUWG SYTSCG_SRMPUWG field offset 156 9C Unsigned * SYTSCG_SRMCPUWG(MAXVMPRC) Mask of CPUs in wait state * * Character 0 SYTSCG_END
MRSYTSCG 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
SYTSCG 0 156+
SYTSCG_CALSLKCT 74 4
SYTSCG_CALSLKTM 78 8
SYTSCG_CALTLKCT 80 4
SYTSCG_CALTLKTM 84 8
SYTSCG_END * 0
SYTSCG_MAXVMPRC 98 2
SYTSCG_MRHDR 0 0
SYTSCG_OFCPUWG 9A 2
SYTSCG_SRMABSDL 3C 4
SYTSCG_SRMATOD 60 8
SYTSCG_SRMATOD2 68 8
SYTSCG_SRMCDISP 14 2
SYTSCG_SRMCDLDG 16 2
SYTSCG_SRMCONLL 5C 4
SYTSCG_SRMCPUWT 8C 8
SYTSCG_SRMCPUWG 9C *
SYTSCG_SRMC1DLD 24 2
SYTSCG_SRMC1DSP 18 2
SYTSCG_SRMC1ELD 2A 2
SYTSCG_SRMC1ELG 1E 2
SYTSCG_SRMC2DLD 26 2
SYTSCG_SRMC2DSP 1A 2
SYTSCG_SRMC2ELD 2C 2
SYTSCG_SRMC2ELG 20 2
SYTSCG_SRMC3DLD 28 2
SYTSCG_SRMC3DSP 1C 2
SYTSCG_SRMC3ELD 2E 2
SYTSCG_SRMC3ELG 22 2
SYTSCG_SRME0ETF 94 2
SYTSCG_SRME1ETS 30 8
SYTSCG_SRME2ETF 38 2
SYTSCG_SRME3ETF 3A 2
SYTSCG_SRMLLCNT 58 4
SYTSCG_SRMRELDL 40 4
SYTSCG_SRMTOTST 44 4
SYTSCG_SRMWSSDL 48 4
SYTSCG_SRMWSSD1 4C 4
SYTSCG_SRMWSSD2 50 4
SYTSCG_SRMWSSD3 54 4
This information is based on z/VM V7R1.0.
Last updated on 12 Sept 2018 at 09:52:06.
Copyright IBM Corporation, 1990, 2018