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

MRSCLSRM

Prolog
Control Block Contents
Cross Reference

MRSCLSRM Prolog

 DSECT NAME - SCLSRM
 FUNCTION - Map a Monitor record.
 LOCATED BY -
           Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRSCLSRM
 DESCRIPTIVE NAME - Monitor Event Record
                    Domain 2 - Scheduler Domain
                    Record 7 - SET SRM Changes
 DESCRIPTION - Indicates that the SET SRM command has been issued.
               The record is created regardless of which users
               are being monitored for the scheduler domain.
               System-wide fields are set, depending on the
               nature of the SET SRM command. All potential fields
               pertaining to that command will be set while others
               will remain unchanged (they may be zero or contain
               data set by prior SET SRM commands).


MRSCLSRM Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure    96  SCLSRM                 Start of monitor record
   0   0  Character     0  SCLSRM_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  SCLSRM_SRMBIASI        Interactive bias intensity.
                                                  Set by the SET SRM IAB
                                                  command.
  24  18  Unsigned      2  SCLSRM_SRMBIASD        Interactive bias duration.
                                                  Set by the SET SRM IAB
                                                  command.
  26  1A  Character     8  SCLSRM_SRMTSLIC        Minor time slice size. Set
                                                  by the SET SRM DSPSLICE
                                                  command.
  34  22  Character     8  SCLSRM_SRMTSHOT        The minor time slice used
                                                  for 'hotshot' users.
  42  2A  Unsigned      2  SCLSRM_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  SCLSRM_SRMP1LDG        Percentage of 'LOAD
                                                  CAPACITY' which can be taken
                                                  by Q1, Q2 and Q3 users. Set
                                                  by the SET SRM LDUBUF
                                                  command.
  48  30  Unsigned      4  SCLSRM_SRMP2LDG        Percentage of 'LOAD
                                                  CAPACITY' which can be taken
                                                  by Q2 and Q3 users. Set by
                                                  SET SRM LDUBUF command.
  52  34  Unsigned      4  SCLSRM_SRMP3LDG        Percentage of 'LOAD
                                                  CAPACITY' which can be taken
                                                  by Q3 users. Set by the SET
                                                  SRM LDUBUF command. It
                                                  relates to Q3 users.
  56  38  Unsigned      4  SCLSRM_SRMLDGCP        Loading user capacity of
                                                  the system
  60  3C  Unsigned      4  SCLSRM_SRMP1WSS        Percentage of available
                                                  memory which is assignable to
                                                  E1, E2 and E3 user. May be
                                                  set by the SET SRM STORBUF
                                                  command.
  64  40  Unsigned      4  SCLSRM_SRMP2WSS        Percentage of available
                                                  memory which is assignable to
                                                  E2 and E3 users. May be set
                                                  by the SET SRM STORBUF
                                                  command.
  68  44  Unsigned      4  SCLSRM_SRMP3WSS        Percentage of available
                                                  memory which is assignable to
                                                  E3 users. May be set by the
                                                  SET SRM STORBUF command.
  72  48  Unsigned      4  SCLSRM_SRMWSSMP        Maximum MAXWSS percentage
                                                  as specified by the SET SRM
                                                  MAXWSS command
  76  4C  Unsigned      4  SCLSRM_SRML1DSP        Number of openings in the
                                                  dispatch list made available
                                                  to users in the short-running
                                                  (E1) transactions
  80  50  Unsigned      4  SCLSRM_SRML2DSP        Number of openings in the
                                                  dispatch list made available
                                                  to users in the
                                                  medium-running (E2)
                                                  transactions. This value is a
                                                  subset of SCLSRM_SRML1DSP.
  84  54  Unsigned      4  SCLSRM_SRML3DSP        Number of openings in the
                                                  dispatch list made available
                                                  to users in the long-running
                                                  (E3) transactions. This value
                                                  is a subset of
                                                  SCLSRM_SRML2DSP.
  88  58  Unsigned      4  SCLSRM_SRMXPCTG        Percentage of XSTORE to use
                                                  in WSS and available memory
                                                  calculations. Set or
                                                  defaulted by the SET SRM
                                                  XSTORE command. Unit 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  SCLSRM_SRMFLAGS        Flags from the SRMBK
          1... ....        SCLSRM_SRMAWAIT         Active wait is in use
          .1.. ....        SCLSRM_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  SCLSRM_END             

MRSCLSRM 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
SCLSRM                     0     96
SCLSRM_END                60      0
SCLSRM_MRHDR               0      0
SCLSRM_SRMAWAIT           5C           80
SCLSRM_SRMBIASD           18      2
SCLSRM_SRMBIASI           14      4
SCLSRM_SRMFLAGS           5C      1
SCLSRM_SRMLDGCP           38      4
SCLSRM_SRMLDGUS           2A      2
SCLSRM_SRMLMCNS           5C           40
SCLSRM_SRML1DSP           4C      4
SCLSRM_SRML2DSP           50      4
SCLSRM_SRML3DSP           54      4
SCLSRM_SRMP1LDG           2C      4
SCLSRM_SRMP1WSS           3C      4
SCLSRM_SRMP2LDG           30      4
SCLSRM_SRMP2WSS           40      4
SCLSRM_SRMP3LDG           34      4
SCLSRM_SRMP3WSS           44      4
SCLSRM_SRMTSHOT           22      8
SCLSRM_SRMTSLIC           1A      8
SCLSRM_SRMWSSMP           48      4
SCLSRM_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