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

MRMTRSCH

Prolog
Control Block Contents
Cross Reference

MRMTRSCH Prolog

 DSECT NAME - MTRSCH
 FUNCTION - Map a Monitor record.
 LOCATED BY -
           Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRMTRSCH
 DESCRIPTIVE NAME - Monitor Sample Configuration Record
                    Domain 1  - Monitor Domain
                    Record 16 - Scheduler Settings
 DESCRIPTION - Provides current settings of scheduler tuning
               commands such as SET SRM DSPLICE.


MRMTRSCH Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure    96  MTRSCH                 Start of monitor record
   0   0  Character     0  MTRSCH_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      4  MTRSCH_SRMBIASI        Interactive bias intensity.
                                                  Set or defaulted by the SET
                                                  SRM IAB command.
  24  18  Character     8  MTRSCH_SRMTSLIC        Minor time slice size. Set
                                                  or defaulted by the SET SRM
                                                  DSPSLICE command.
  32  20  Character     8  MTRSCH_SRMTSHOT        The minor time slice used
                                                  for 'hotshot' users.
  40  28  Unsigned      2  MTRSCH_SRMBIASD        Interactive bias duration.
                                                  Set or defaulted by the SET
                                                  SRM IAB command.
  42  2A  Unsigned      2  MTRSCH_SRMLDGUS        Number of page reads a user
                                                  must do in a minor time slice
                                                  to be classified as a
                                                  'loading user'.
  44  2C  Unsigned      4  MTRSCH_SRMP1LDG        Percentage of 'Load
                                                  Capacity' which can be taken
                                                  by Q1, Q2, and Q3 users. Set
                                                  or defaulted by the SET SRM
                                                  LDUBUF command.
  48  30  Unsigned      4  MTRSCH_SRMP2LDG        Percentage of 'Load
                                                  Capacity' which can be taken
                                                  by Q2, and Q3 users. Set or
                                                  defaulted by the SET SRM
                                                  LDUBUF command.
  52  34  Unsigned      4  MTRSCH_SRMP3LDG        Percentage of 'Load
                                                  Capacity' which can be taken
                                                  by Q3 user. Set or defaulted
                                                  by the SET SRM LDUBUF
                                                  command.
  56  38  Unsigned      4  MTRSCH_SRMLDGCP        Loading user capacity of
                                                  the system
  60  3C  Unsigned      4  MTRSCH_SRMP1WSS        Percentage of available
                                                  memory which is assignable to
                                                  E1, E2 and E3 users. Set or
                                                  defaulted by the SET SRM
                                                  STORBUF command.
  64  40  Unsigned      4  MTRSCH_SRMP2WSS        Percentage of available
                                                  memory which is assignable to
                                                  E2 and E3 users. Set or
                                                  defaulted by the SET SRM
                                                  STORBUF command.
  68  44  Unsigned      4  MTRSCH_SRMP3WSS        Percentage of available
                                                  memory which is assignable to
                                                  E3 users. Set or defaulted by
                                                  the SET SRM STORBUF command.
  72  48  Unsigned      4  MTRSCH_SRMWSSMP        Maximum MAXWSS percentage.
                                                  Set or defaulted by the SET
                                                  SRM MAXWSS command.
  76  4C  Unsigned      4  MTRSCH_SRML1DSP        Number of openings in the
                                                  dispatch list made available
                                                  to users in the short-running
                                                  (E1) transactions. Set or
                                                  defaulted by the SET SRM
                                                  DSPBUF command.
  80  50  Unsigned      4  MTRSCH_SRML2DSP        Number of openings in the
                                                  dispatch list made available
                                                  to users in the
                                                  medium-running (E2)
                                                  transactions. This value is a
                                                  subset of MTRSCH_SRML1DSP.
                                                  Set or defaulted by the SET
                                                  SRM DSPBUF command.
  84  54  Unsigned      4  MTRSCH_SRML3DSP        Number of openings in the
                                                  dispatch list made available
                                                  to users in the long-running
                                                  (E3) transactions. This value
                                                  is a subset of
                                                  MTRSCH_SRML1DSP. Set or
                                                  defaulted by the SET SRM
                                                  DSPBUF command.
  88  58  Unsigned      4  MTRSCH_SRMXPCTG        Percentage of XSTORE to use
                                                  in WSS and available memory
                                                  calculations. Defaulted or
                                                  set by the SET SRM XSTORE
                                                  command. Units of value is a
                                                  hexadecimal factor scaled 8
                                                  bits. Examples-
                                                  X'00000200'=2.00(200%),
                                                  X'00000100'=1.00(100%),
                                                  X'000000C0'=0.75(75%), etc.
  92  5C  Bitstring     1  MTRSCH_SRMFLAGS        Flags from the SRMBK
          1... ....        MTRSCH_SRMAWAIT         Active wait is in use
          .1.. ....        MTRSCH_SRMLMCNS         Guest CPU usage is being
                                                  limited using the consumption
                                                  method.
          ..1. ....        *                       
          ...1 ....        *                       
          .... 1...        *                       
          .... .1..        *                       
          .... ..1.        *                       
          .... ...1        *                       
  93  5D  Character     3  *                      Reserved for IBM use
  96  60  Character     0  MTRSCH_END             

MRMTRSCH 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
MTRSCH                     0     96
MTRSCH_END                60      0
MTRSCH_MRHDR               0      0
MTRSCH_SRMAWAIT           5C           80
MTRSCH_SRMBIASD           28      2
MTRSCH_SRMBIASI           14      4
MTRSCH_SRMFLAGS           5C      1
MTRSCH_SRMLDGCP           38      4
MTRSCH_SRMLDGUS           2A      2
MTRSCH_SRMLMCNS           5C           40
MTRSCH_SRML1DSP           4C      4
MTRSCH_SRML2DSP           50      4
MTRSCH_SRML3DSP           54      4
MTRSCH_SRMP1LDG           2C      4
MTRSCH_SRMP1WSS           3C      4
MTRSCH_SRMP2LDG           30      4
MTRSCH_SRMP2WSS           40      4
MTRSCH_SRMP3LDG           34      4
MTRSCH_SRMP3WSS           44      4
MTRSCH_SRMTSHOT           20      8
MTRSCH_SRMTSLIC           18      8
MTRSCH_SRMWSSMP           48      4
MTRSCH_SRMXPCTG           58      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