|
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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004