|
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