Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRSYTSCG

Prolog
Control 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  148  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  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    148
SYTSCG_CALSLKCT           74      4
SYTSCG_CALSLKTM           78      8
SYTSCG_CALTLKCT           80      4
SYTSCG_CALTLKTM           84      8
SYTSCG_END                94      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_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 V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007