|
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 44 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 user's RELATIVE share of
the system, as set in the user's
directory or via the SET SHARE
command. Set to zero if the user
is an ABSOLUTE share user or if
this VMDBK has a virtual processor
dedicated to it, and this is a
virtual MP user. Set to a negative
value if VMDBK has a virtual
processor dedicated to it, and the
user is a virtual UP user.
32 20 Unsigned 4 SCLSHR_VMDABSSH The user'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 if
user is a RELATIVE share user.
36 24 Bitstring 1 SCLSHR_CALSHARF Set Share flags
1... .... SCLSHR_VMDMXSHA Max share is Absolute if ON. Max
share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. SCLSHR_VMDLIMTH Max Share is Limithard if ON.
Max Share is Limitsoft if OFF.
.... ...1 *
37 25 Unsigned 3 * Reserved and available for IBM
use.
40 28 Unsigned 4 SCLSHR_VMDMXSHR The user'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 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 44
SCLSHR_CALSHARF 24 1
SCLSHR_END 2C 0
SCLSHR_MRHDR 0 0
SCLSHR_VMDABSSH 20 4
SCLSHR_VMDLIMTH 24 02
SCLSHR_VMDMXSHA 24 80
SCLSHR_VMDMXSHR 28 4
SCLSHR_VMDRELSH 1C 4
SCLSHR_VMDUSER 14 8
This information is
based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003