|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSCLSHR
PrologControl Block Contents
Cross Reference
MRSCLSHR Prolog
DSECT NAME - SCLSHR
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSCLSHR
DESCRIPTIVE NAME - Monitor Event Record
Domain 2 - Scheduler Domain
Record 9 - SET SHARE Changes
DESCRIPTION - Records changes made by a SET SHARE command.
Generated only if the user who is the target of the
command is enabled for scheduler domain (not to be
confused with the user that issued the command).
MRSCLSHR Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 128 SCLSHR Start of monitor record
0 0 Character 0 SCLSHR_MRHDR Record header
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 Character 8 SCLSHR_VMDUSER Userid
28 1C Unsigned 4 SCLSHR_VMDRELSH This virtual CPU's RELATIVE
share of the system, as set in
the user's directory or via the
SET SHARE command. Set to zero
when this VMDBK has an ABSOLUTE
share value, or has a virtual
processor dedicated to it, or
is in the process of being
logged off.
32 20 Unsigned 4 SCLSHR_VMDABSSH This virtual CPU's ABSOLUTE
share of the system, as set in
the user's directory or via the
SET SHARE command. 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 when this VMDBK has
a RELATIVE share value.
36 24 Bitstring 1 SCLSHR_CALSHARF Set Share flags
1... .... SCLSHR_VMDMXSHA Max share for this CPU is
ABSOLUTE if on. Max share for
this CPU is RELATIVE if off.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. SCLSHR_VMDLIMTH Max share for this CPU is
LIMITHARD if on. Max share for
this CPU is LIMITSOFT if off.
.... ...1 *
37 25 Unsigned 3 * Reserved and available for
IBM use.
40 28 Unsigned 4 SCLSHR_VMDMXSHR This virtual CPU's Max share
of the system, as set in the
user's directory or via the SET
SHARE command. This value is
set to zero if no Max share
exists. If the Max share is
Absolute, then the unit of the
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.
Check SCLSHR_VMDMXSHA to
determine if Max share is
absolute or relative.
44 2C Bitstring 1 SCLSHR_VMDCFGEM Virtual configuration
indicators. Valid in base VMDBK
only
1... .... *
.1.. .... SCLSHR_VMDCPUAF User requested CPU Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
45 2D Bitstring 1 SCLSHR_VMDPUST CPU Status flag
1... .... SCLSHR_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
46 2E Character 2 * Reserved for IBM use
48 30 Unsigned 4 SCLSHR_CP_SSHRELSH This user's RELATIVE share
setting for CPUs of type CP.
52 34 Unsigned 4 SCLSHR_CP_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type CP.
56 38 Unsigned 4 SCLSHR_CP_SSHMXSHR This user's Max share setting
for CPUs of type CP.
60 3C Bitstring 1 SCLSHR_CP_SSHFLG1 This user's share flags for
CPUs of type CP.
1... .... *
.1.. .... SCLSHR_CP_SSHLIMH Max share for type CP is
LIMITHARD if on. Max share for
type CP is LIMITSOFT if off.
..1. .... SCLSHR_CP_SSHNMSHA Normal share for type CP is
ABSOLUTE if on. Normal share
for type CP is RELATIVE if off.
...1 .... SCLSHR_CP_SSHMXSHA Max share for type CP is
ABSOLUTE if on. Max share for
type CP is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
61 3D Bitstring 3 * Reserved and available for
IBM use.
64 40 Unsigned 4 SCLSHR_ZAP_SSHRELSH This user's RELATIVE share
setting for CPUs of type zAAP.
68 44 Unsigned 4 SCLSHR_ZAP_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type zAAP.
72 48 Unsigned 4 SCLSHR_ZAP_SSHMXSHR This user's Max share setting
for CPUs of type zAAP.
76 4C Bitstring 1 SCLSHR_ZAP_SSHFLG1 This user's share flags for
CPUs of type zAAP.
1... .... *
.1.. .... SCLSHR_ZAP_SSHLIMH Max share for type zAAP is
LIMITHARD if on. Max share for
type zAAP is LIMITSOFT if off.
..1. .... SCLSHR_ZAP_SSHNMSHA Normal share for type zAAP is
ABSOLUTE if on. Normal share
for type zAAP is RELATIVE if
off.
...1 .... SCLSHR_ZAP_SSHMXSHA Max share for type zAAP is
ABSOLUTE if on. Max share for
type zAAP is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
77 4D Bitstring 3 * Reserved and available for
IBM use.
80 50 Unsigned 4 SCLSHR_IFL_SSHRELSH This user's RELATIVE share
setting for CPUs of type IFL.
84 54 Unsigned 4 SCLSHR_IFL_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type IFL.
88 58 Unsigned 4 SCLSHR_IFL_SSHMXSHR This user's Max share setting
for CPUs of type IFL.
92 5C Bitstring 1 SCLSHR_IFL_SSHFLG1 This user's share flags for
CPUs of type IFL.
1... .... *
.1.. .... SCLSHR_IFL_SSHLIMH Max share for type IFL is
LIMITHARD if on. Max share for
type IFL is LIMITSOFT if off.
..1. .... SCLSHR_IFL_SSHNMSHA Normal share for type IFL is
ABSOLUTE if on. Normal share
for type IFL is RELATIVE if
off.
...1 .... SCLSHR_IFL_SSHMXSHA Max share for type IFL is
ABSOLUTE if on. Max share for
type IFL is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
93 5D Bitstring 3 * Reserved and available for
IBM use.
96 60 Unsigned 4 SCLSHR_ICF_SSHRELSH This user's RELATIVE share
setting for CPUs of type ICF.
100 64 Unsigned 4 SCLSHR_ICF_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type ICF.
104 68 Unsigned 4 SCLSHR_ICF_SSHMXSHR This user's Max share setting
for CPUs of type ICF.
108 6C Bitstring 1 SCLSHR_ICF_SSHFLG1 This user's share flags for
CPUs of type ICF.
1... .... *
.1.. .... SCLSHR_ICF_SSHLIMH Max share for type ICF is
LIMITHARD if on. Max share for
type ICF is LIMITSOFT if off.
..1. .... SCLSHR_ICF_SSHNMSHA Normal share for type ICF is
ABSOLUTE if on. Normal share
for type ICF is RELATIVE if
off.
...1 .... SCLSHR_ICF_SSHMXSHA Max share for type ICF is
ABSOLUTE if on. Max share for
type ICF is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
109 6D Bitstring 3 * Reserved and available for
IBM use.
112 70 Unsigned 4 SCLSHR_ZIP_SSHRELSH This user's RELATIVE share
setting for CPUs of type zIIP.
116 74 Unsigned 4 SCLSHR_ZIP_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type zIIP.
120 78 Unsigned 4 SCLSHR_ZIP_SSHMXSHR This user's Max share setting
for CPUs of type zIIP.
124 7C Bitstring 1 SCLSHR_ZIP_SSHFLG1 This user's share flags for
CPUs of type zIIP.
1... .... *
.1.. .... SCLSHR_ZIP_SSHLIMH Max share for type zIIP is
LIMITHARD if on. Max share for
type zIIP is LIMITSOFT if off.
..1. .... SCLSHR_ZIP_SSHNMSHA Normal share for type zIIP is
ABSOLUTE if on. Normal share
for type zIIP is RELATIVE if
off.
...1 .... SCLSHR_ZIP_SSHMXSHA Max share for type zIIP is
ABSOLUTE if on. Max share for
type zIIP is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
125 7D Bitstring 3 * Reserved and available for
IBM use.
128 80 Character 0 SCLSHR_END
MRSCLSHR 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
SCLSHR 0 128
SCLSHR_CALSHARF 24 1
SCLSHR_CP_SSHABSSH 34 4
SCLSHR_CP_SSHFLG1 3C 1
SCLSHR_CP_SSHLIMH 3C 40
SCLSHR_CP_SSHMXSHA 3C 10
SCLSHR_CP_SSHMXSHR 38 4
SCLSHR_CP_SSHNMSHA 3C 20
SCLSHR_CP_SSHRELSH 30 4
SCLSHR_END 80 0
SCLSHR_ICF_SSHABSSH 64 4
SCLSHR_ICF_SSHFLG1 6C 1
SCLSHR_ICF_SSHLIMH 6C 40
SCLSHR_ICF_SSHMXSHA 6C 10
SCLSHR_ICF_SSHMXSHR 68 4
SCLSHR_ICF_SSHNMSHA 6C 20
SCLSHR_ICF_SSHRELSH 60 4
SCLSHR_IFL_SSHABSSH 54 4
SCLSHR_IFL_SSHFLG1 5C 1
SCLSHR_IFL_SSHLIMH 5C 40
SCLSHR_IFL_SSHMXSHA 5C 10
SCLSHR_IFL_SSHMXSHR 58 4
SCLSHR_IFL_SSHNMSHA 5C 20
SCLSHR_IFL_SSHRELSH 50 4
SCLSHR_MRHDR 0 0
SCLSHR_VMDABSSH 20 4
SCLSHR_VMDAFSUP 2D 80
SCLSHR_VMDCFGEM 2C 1
SCLSHR_VMDCPUAF 2C 40
SCLSHR_VMDLIMTH 24 02
SCLSHR_VMDMXSHA 24 80
SCLSHR_VMDMXSHR 28 4
SCLSHR_VMDPUST 2D 1
SCLSHR_VMDRELSH 1C 4
SCLSHR_VMDUSER 14 8
SCLSHR_ZAP_SSHABSSH 44 4
SCLSHR_ZAP_SSHFLG1 4C 1
SCLSHR_ZAP_SSHLIMH 4C 40
SCLSHR_ZAP_SSHMXSHA 4C 10
SCLSHR_ZAP_SSHMXSHR 48 4
SCLSHR_ZAP_SSHNMSHA 4C 20
SCLSHR_ZAP_SSHRELSH 40 4
SCLSHR_ZIP_SSHABSSH 74 4
SCLSHR_ZIP_SSHFLG1 7C 1
SCLSHR_ZIP_SSHLIMH 7C 40
SCLSHR_ZIP_SSHMXSHA 7C 10
SCLSHR_ZIP_SSHMXSHR 78 4
SCLSHR_ZIP_SSHNMSHA 7C 20
SCLSHR_ZIP_SSHRELSH 70 4
This information is
based on z/VM V6R1.0.
Last updated on 8 Oct 2009 at 21:08:13.
Copyright IBM Corporation, 1990, 2009