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  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