|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRUSR
PrologControl Block Contents
Cross Reference
MRMTRUSR Prolog
DSECT NAME - MTRUSR
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRMTRUSR
DESCRIPTIVE NAME - Monitor Sample Configuration Record
Domain 1 - Monitor Domain
Record 15 - Logged on User
DESCRIPTION - Description of a logged on user at the time the
MONITOR SAMPLE START command is issued. A separate
record is generated for each logged-on user.
MRMTRUSR Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 204 MTRUSR Start of monitor record
0 0 Character 0 MTRUSR_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 Character 8 MTRUSR_VMDUSER User identification
28 1C Unsigned 2 MTRUSR_VMDCPUAD Processor address
30 1E Bitstring 1 MTRUSR_VMDMODE Guest machine mode. This is
as set for internal use by CP.
See MTRUSR_CALMODE for the mode
'calculated' at.
31 1F Unsigned 1 MTRUSR_VMDCPUCT Number of guest defined CPUs
including secondary processors.
Note: This number is always one
less than the total number of
processors defined because the
base processor is not guest
defined.
32 20 Bitstring 1 MTRUSR_CALSTAT User information
1... .... MTRUSR_VMDSVMST 'OPTION SVMSTAT' has been
specified in the user's
directory
.1.. .... MTRUSR_VMDQDSPU This user has the QUICKDSP
designation, as set or
defaulted by the SET QUICKDSP
command. When the user has work
to do, it will be added to the
dispatch list immediately
without waiting in the eligible
list.
..1. .... MTRUSR_CALDIAL This user is a dialed user
...1 .... MTRUSR_CALSNA This user is connected
through System Network
Architecture (SNA)
.... 1... MTRUSR_VMDNOINS User is prevented from
inserting any tracks into the
minidisk cache. (set when SET
MDC INS OFF command is issued)
.... .1.. MTRUSR_VMDNOFSL No MDC fair share limit
applies. Set at LOGON if the
NOMDCFS option is specified on
the OPTIONS statement in the
user's directory.
.... ..1. *
.... ...1 *
33 21 Bitstring 1 MTRUSR_CALMODE Architectural mode of the
virtual machine
1... .... *
.1.. .... MTRUSR_CALMESA ESA architecture
..1. .... MTRUSR_CALMXA XA architecture
...1 .... MTRUSR_CALM370 370 architecture
.... 1... MTRUSR_CALMXC XC architecture
.... .1.. MTRUSR_CALMESAM ESA mode machine has entered
z/Arch
.... ..1. *
.... ...1 *
34 22 Bitstring 1 MTRUSR_VMDSTYPE Storage type this virtual
machine resides in. X'00' =>
V=V. X'80' => Reserved and no
longer available. X'40' => V=F.
35 23 Bitstring 1 MTRUSR_CALSHARF Set Share flags
1... .... MTRUSR_VMDMXSHA Max share for this CPU is
ABSOLUTE if on. Max share for
this CPU is RELATIVE if off.
.1.. .... MTRUSR_VMDSTOP This virtual CPU is in soft
stop
..1. .... MTRUSR_VMDSTOPD This virtual CPU is stopped
...1 .... *
.... 1... *
.... .1.. *
.... ..1. MTRUSR_VMDLIMTH Max share for this CPU is
LIMITHARD if on. Max share for
this CPU is LIMITSOFT if off.
.... ...1 *
36 24 Unsigned 4 MTRUSR_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. This field should
not be used if MTRUSR_VMDSTOP
is on.
40 28 Unsigned 4 MTRUSR_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. This
field should not be used if
MTRUSR_VMDSTOP is on.
44 2C Unsigned 4 MTRUSR_VMDSSIZE Virtual machine size, in
bytes. This field is kept for
compatability reasons, but may
not be accurate for z/Arch
systems where larger virtual
machines are valid. The
preferred field is
MTRUSR_ASCDEFSZ
48 30 Character 8 MTRUSR_VMDACTNO User accounting number
56 38 Character 8 MTRUSR_VMDGRPN External Security Manager
group name
64 40 Unsigned 4 MTRUSR_VMDMXRVP Number of pages reserved for
the user
68 44 Character 8 MTRUSR_CALTODON Time at which the user logged
on for this session. In
time-of-day (TOD) clock format.
To get the user's connect time,
subtract this time value from
the time stamp in the record
header's MRHDRTOD. Note: This
value captures the first 32
bits of the TOD clock which
gives approximately one second
of granularity.
76 4C Character 8 MTRUSR_VMDBYVAL The BYUSER ID that logged on
this virtual machine. If there
is no BYUSER, this field is
binary zeros.
84 54 Unsigned 4 MTRUSR_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 MTRUSR_VMDMXSHA to
determine if Max share is
absolute or relative. This
field should not be used if
MTRUSR_VMDSTOP is on.
88 58 Character 8 MTRUSR_ASCDEFSZ Defined storage size in
addressable bytes, minus one.
If DEF STOR CONFIG was used to
define multiple discontiguous
extents of addressable defined
storage, this field contains
the sum of the sizes in bytes
of all of the individual
extents (minus one). The minus
one notation is used so that a
total size of 16 Exabytes may
be represented without
ambiguity (as
x'FFFFFFFF_FFFFFFFF').
88 58 Character 4 MTRUSR_CALDEFHI high four bytes
92 5C Character 4 MTRUSR_CALDEFLO low four bytes
96 60 Unsigned 4 MTRUSR_CALCPCT Number of guest defined CP
CPUs
100 64 Unsigned 4 MTRUSR_CALZIPCT Number of guest defined zIIP
CPUs
104 68 Unsigned 4 MTRUSR_CALZAPCT Number of guest defined zAAP
CPUs
108 6C Unsigned 4 MTRUSR_CALIFLCT Number of guest defined IFL
CPUs
112 70 Bitstring 1 MTRUSR_VMDCFGEM Virtual configuration
indicators. Valid in base VMDBK
only
1... .... *
.1.. .... MTRUSR_VMDCPUAF User requested CPU Affinity
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
113 71 Bitstring 1 MTRUSR_VMDPUST CPU Status flag
1... .... MTRUSR_VMDAFSUP CPU Affinity suppressed
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
114 72 Character 2 * Reserved for IBM use
116 74 Unsigned 4 MTRUSR_CALICFCT Number of guest defined ICF
CPUs
120 78 Unsigned 4 MTRUSR_CP_SSHRELSH This user's RELATIVE share
setting for CPUs of type CP.
124 7C Unsigned 4 MTRUSR_CP_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type CP.
128 80 Unsigned 4 MTRUSR_CP_SSHMXSHR This user's Max share setting
for CPUs of type CP.
132 84 Bitstring 1 MTRUSR_CP_SSHFLG1 This user's share flags for
CPUs of type CP.
1... .... *
.1.. .... MTRUSR_CP_SSHLIMH Max share for type CP is
LIMITHARD if on. Max share for
type CP is LIMITSOFT if off.
..1. .... MTRUSR_CP_SSHNMSHA Normal share for type CP is
ABSOLUTE if on. Normal share
for type CP is RELATIVE if off.
...1 .... MTRUSR_CP_SSHMXSHA Max share for type CP is
ABSOLUTE if on. Max share for
type CP is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
133 85 Bitstring 3 * Reserved and available for
IBM use.
136 88 Unsigned 4 MTRUSR_ZAP_SSHRELSH This user's RELATIVE share
setting for CPUs of type zAAP.
140 8C Unsigned 4 MTRUSR_ZAP_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type zAAP.
144 90 Unsigned 4 MTRUSR_ZAP_SSHMXSHR This user's Max share setting
for CPUs of type zAAP.
148 94 Bitstring 1 MTRUSR_ZAP_SSHFLG1 This user's share flags for
CPUs of type zAAP.
1... .... *
.1.. .... MTRUSR_ZAP_SSHLIMH Max share for type zAAP is
LIMITHARD if on. Max share for
type zAAP is LIMITSOFT if off.
..1. .... MTRUSR_ZAP_SSHNMSHA Normal share for type zAAP is
ABSOLUTE if on. Normal share
for type zAAP is RELATIVE if
off.
...1 .... MTRUSR_ZAP_SSHMXSHA Max share for type zAAP is
ABSOLUTE if on. Max share for
type zAAP is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
149 95 Bitstring 3 * Reserved and available for
IBM use.
152 98 Unsigned 4 MTRUSR_IFL_SSHRELSH This user's RELATIVE share
setting for CPUs of type IFL.
156 9C Unsigned 4 MTRUSR_IFL_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type IFL.
160 A0 Unsigned 4 MTRUSR_IFL_SSHMXSHR This user's Max share setting
for CPUs of type IFL.
164 A4 Bitstring 1 MTRUSR_IFL_SSHFLG1 This user's share flags for
CPUs of type IFL.
1... .... *
.1.. .... MTRUSR_IFL_SSHLIMH Max share for type IFL is
LIMITHARD if on. Max share for
type IFL is LIMITSOFT if off.
..1. .... MTRUSR_IFL_SSHNMSHA Normal share for type IFL is
ABSOLUTE if on. Normal share
for type IFL is RELATIVE if
off.
...1 .... MTRUSR_IFL_SSHMXSHA Max share for type IFL is
ABSOLUTE if on. Max share for
type IFL is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
165 A5 Bitstring 3 * Reserved and available for
IBM use.
168 A8 Unsigned 4 MTRUSR_ICF_SSHRELSH This user's RELATIVE share
setting for CPUs of type ICF.
172 AC Unsigned 4 MTRUSR_ICF_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type ICF.
176 B0 Unsigned 4 MTRUSR_ICF_SSHMXSHR This user's Max share setting
for CPUs of type ICF.
180 B4 Bitstring 1 MTRUSR_ICF_SSHFLG1 This user's share flags for
CPUs of type ICF.
1... .... *
.1.. .... MTRUSR_ICF_SSHLIMH Max share for type ICF is
LIMITHARD if on. Max share for
type ICF is LIMITSOFT if off.
..1. .... MTRUSR_ICF_SSHNMSHA Normal share for type ICF is
ABSOLUTE if on. Normal share
for type ICF is RELATIVE if
off.
...1 .... MTRUSR_ICF_SSHMXSHA Max share for type ICF is
ABSOLUTE if on. Max share for
type ICF is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
181 B5 Bitstring 3 * Reserved and available for
IBM use.
184 B8 Unsigned 4 MTRUSR_ZIP_SSHRELSH This user's RELATIVE share
setting for CPUs of type zIIP.
188 BC Unsigned 4 MTRUSR_ZIP_SSHABSSH This user's ABSOLUTE share
setting for CPUs of type zIIP.
192 C0 Unsigned 4 MTRUSR_ZIP_SSHMXSHR This user's Max share setting
for CPUs of type zIIP.
196 C4 Bitstring 1 MTRUSR_ZIP_SSHFLG1 This user's share flags for
CPUs of type zIIP.
1... .... *
.1.. .... MTRUSR_ZIP_SSHLIMH Max share for type zIIP is
LIMITHARD if on. Max share for
type zIIP is LIMITSOFT if off.
..1. .... MTRUSR_ZIP_SSHNMSHA Normal share for type zIIP is
ABSOLUTE if on. Normal share
for type zIIP is RELATIVE if
off.
...1 .... MTRUSR_ZIP_SSHMXSHA Max share for type zIIP is
ABSOLUTE if on. Max share for
type zIIP is RELATIVE if off.
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
197 C5 Bitstring 3 * Reserved and available for
IBM use.
200 C8 Bitstring 1 MTRUSR_FLAGS Miscellaneous flag byte
1... .... MTRUSR_VMDREOFL SET REORDER is in effect for
this user
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
201 C9 Bitstring 3 * Reserved and available for
IBM use.
204 CC Character 0 MTRUSR_END
MRMTRUSR 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
MTRUSR 0 204
MTRUSR_ASCDEFSZ 58 8
MTRUSR_CALCPCT 60 4
MTRUSR_CALDEFHI 58 4
MTRUSR_CALDEFLO 5C 4
MTRUSR_CALDIAL 20 20
MTRUSR_CALICFCT 74 4
MTRUSR_CALIFLCT 6C 4
MTRUSR_CALMESA 21 40
MTRUSR_CALMESAM 21 04
MTRUSR_CALMODE 21 1
MTRUSR_CALMXA 21 20
MTRUSR_CALMXC 21 08
MTRUSR_CALM370 21 10
MTRUSR_CALSHARF 23 1
MTRUSR_CALSNA 20 10
MTRUSR_CALSTAT 20 1
MTRUSR_CALTODON 44 8
MTRUSR_CALZAPCT 68 4
MTRUSR_CALZIPCT 64 4
MTRUSR_CP_SSHABSSH 7C 4
MTRUSR_CP_SSHFLG1 84 1
MTRUSR_CP_SSHLIMH 84 40
MTRUSR_CP_SSHMXSHA 84 10
MTRUSR_CP_SSHMXSHR 80 4
MTRUSR_CP_SSHNMSHA 84 20
MTRUSR_CP_SSHRELSH 78 4
MTRUSR_END CC 0
MTRUSR_FLAGS C8 1
MTRUSR_ICF_SSHABSSH AC 4
MTRUSR_ICF_SSHFLG1 B4 1
MTRUSR_ICF_SSHLIMH B4 40
MTRUSR_ICF_SSHMXSHA B4 10
MTRUSR_ICF_SSHMXSHR B0 4
MTRUSR_ICF_SSHNMSHA B4 20
MTRUSR_ICF_SSHRELSH A8 4
MTRUSR_IFL_SSHABSSH 9C 4
MTRUSR_IFL_SSHFLG1 A4 1
MTRUSR_IFL_SSHLIMH A4 40
MTRUSR_IFL_SSHMXSHA A4 10
MTRUSR_IFL_SSHMXSHR A0 4
MTRUSR_IFL_SSHNMSHA A4 20
MTRUSR_IFL_SSHRELSH 98 4
MTRUSR_MRHDR 0 0
MTRUSR_VMDABSSH 28 4
MTRUSR_VMDACTNO 30 8
MTRUSR_VMDAFSUP 71 80
MTRUSR_VMDBYVAL 4C 8
MTRUSR_VMDCFGEM 70 1
MTRUSR_VMDCPUAD 1C 2
MTRUSR_VMDCPUAF 70 40
MTRUSR_VMDCPUCT 1F 1
MTRUSR_VMDGRPN 38 8
MTRUSR_VMDLIMTH 23 02
MTRUSR_VMDMODE 1E 1
MTRUSR_VMDMXRVP 40 4
MTRUSR_VMDMXSHA 23 80
MTRUSR_VMDMXSHR 54 4
MTRUSR_VMDNOFSL 20 04
MTRUSR_VMDNOINS 20 08
MTRUSR_VMDPUST 71 1
MTRUSR_VMDQDSPU 20 40
MTRUSR_VMDRELSH 24 4
MTRUSR_VMDREOFL C8 80
MTRUSR_VMDSSIZE 2C 4
MTRUSR_VMDSTOP 23 40
MTRUSR_VMDSTOPD 23 20
MTRUSR_VMDSTYPE 22 1
MTRUSR_VMDSVMST 20 80
MTRUSR_VMDUSER 14 8
MTRUSR_ZAP_SSHABSSH 8C 4
MTRUSR_ZAP_SSHFLG1 94 1
MTRUSR_ZAP_SSHLIMH 94 40
MTRUSR_ZAP_SSHMXSHA 94 10
MTRUSR_ZAP_SSHMXSHR 90 4
MTRUSR_ZAP_SSHNMSHA 94 20
MTRUSR_ZAP_SSHRELSH 88 4
MTRUSR_ZIP_SSHABSSH BC 4
MTRUSR_ZIP_SSHFLG1 C4 1
MTRUSR_ZIP_SSHLIMH C4 40
MTRUSR_ZIP_SSHMXSHA C4 10
MTRUSR_ZIP_SSHMXSHR C0 4
MTRUSR_ZIP_SSHNMSHA C4 20
MTRUSR_ZIP_SSHRELSH B8 4
This information is
based on z/VM V5R4.0.
Last updated on 14 Sep 2010 at 11:37:41.
Copyright IBM Corporation, 1990, 2010