|
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.
Note: This field is
maintained for compatibility.
The per- CPU type fields
below should be used instead,
as they contain the share
settings for the virtual
machine, not just one of the
virtual CPUs
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.
$NULL Note: This field is
maintained for compatibility.
The per- CPU type fields
below should be used instead,
as they contain the share
settings for the virtual
machine, not just one of the
virtual CPUs
36 24 Bitstring 1 SCLSHR_CALSHARF Set Share flags Note: This
field is maintained for
compatibility. The per- CPU
type fields below should be
used instead, as they contain
the share settings for the
virtual machine, not just one
of the virtual CPUs
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. Note:
This field is maintained for
compatibility. The per- CPU
type fields below should be
used instead, as they contain
the share settings for the
virtual machine, not just one
of the virtual CPUs
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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011