|
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 152 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. 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 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 8 SYTSCG_SRMCPUWT Mask of CPUs in wait state.
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 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 152
SYTSCG_CALSLKCT 74 4
SYTSCG_CALSLKTM 78 8
SYTSCG_CALTLKCT 80 4
SYTSCG_CALTLKTM 84 8
SYTSCG_END 98 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_SRMCPUWT 8C 8
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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011