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 140 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 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 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. 64 40 Signed 4 SYTSCG_SRMRELDL Cardinal count of total relative shares of all VMDBKs in the dispatch list. 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. 92 5C Unsigned 4 SYTSCG_SRMCONLL Count of users actually ON the Limit List. 96 60 Character 8 SYTSCG_SRMATOD Artificial TOD. This TOD only advances at the rate the system is running user work. 104 68 Character 8 SYTSCG_SRMATOD2 Artificial TOD2. This TOD only advances with each CPU's user time and each CPU's wait time. 112 70 Unsigned 4 SYTSCG_SRMWTCPU Mask of CPUs in wait state. 116 74 Unsigned 4 SYTSCG_CALSLKCT Count of formal spin requests for the scheduler lock. This field is part of the SRMSLOCK synchronization lock control block (SYNCOUNT). 120 78 Character 8 SYTSCG_CALSLKTM Elapsed spin time on the scheduler lock starting at zero and counting up when formally spinning on lock. Value is in TOD units. This field is part of the SRMSLOCK synchronization lock control block (SYNTIME). 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 (SYNCOUNT). In z/VM 4.3.0 and earlier the serialization for this function was done using the scheduler lock so the count in this field would have been included in the scheduler lock field called SYTSCG_CALSLKCT. 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 (SYNTIME). In z/VM 4.3.0 and earlier the serialization for this function was done using the scheduler lock so the spin time in this field would have been included in the scheduler lock field called SYTSCG_CALSLKTM. 140 8C 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 140 SYTSCG_CALSLKCT 74 4 SYTSCG_CALSLKTM 78 8 SYTSCG_CALTLKCT 80 4 SYTSCG_CALTLKTM 84 8 SYTSCG_END 8C 0 SYTSCG_MRHDR 0 0 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_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_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 SYTSCG_SRMWTCPU 70 4
This information is based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003