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   156+ 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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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 scheduler lock requests
                                                      that spun attempting to acquire
                                                      exclusive or a share including
                                                      HCPDSP's local spin loop.
     120  78  Character     8  SYTSCG_CALSLKTM        Elapsed spin time on the
                                                      scheduler lock starting at
                                                      zero and counting up when
                                                      spinning on a lock acquisition.
                                                      Value is in TOD units.  This
                                                      includes the time HCPDSP spends
                                                      in its internal spin loop.
     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 (SYNXSCNT).
     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 (SYNXTIME).
     140  8C  Character     8  SYTSCG_SRMCPUWT        Mask of CPUs in wait state
                                                      containing the first 64 CPUs.
                                                      This field is being retained
                                                      only for compatibility and
                                                      SYTSCG_SRMCPUWG should be used
                                                      instead. If more than 64 CPUs
                                                      are defined this field will
                                                      contain information for the first
                                                      64 CPUs only.
     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  Unsigned      2  SYTSCG_MAXVMPRC        This value defines the
                                                      number of valid bits in
                                                      bit mask: SYTSCG_SRMCPUWG
     154  9A  Unsigned      2  SYTSCG_OFCPUWG         SYTSCG_SRMPUWG field offset
     156  9C  Unsigned      *  SYTSCG_SRMCPUWG(MAXVMPRC) Mask of CPUs in wait
                                                      state
       *   *  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    156+
    SYTSCG_CALSLKCT           74      4
    SYTSCG_CALSLKTM           78      8
    SYTSCG_CALTLKCT           80      4
    SYTSCG_CALTLKTM           84      8
    SYTSCG_END                 *      0
    SYTSCG_MAXVMPRC           98      2
    SYTSCG_MRHDR               0      0
    SYTSCG_OFCPUWG            9A      2
    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_SRMCPUWG           9C      *
    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 V7R2.0.

    Last updated on 08 August 2020 at 15:28:06.

    Copyright IBM Corporation, 1990, 2020