|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLSRM
PrologControl 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 V5R4.0.
Last updated on 16 October 2009 at 10:12:41.
Copyright IBM Corporation, 1990, 2009