|
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 96 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
2 2 Unsigned 2 MRHDRZER
4 4 Unsigned 1 MRHDRDM
5 5 Unsigned 1 *
6 6 Unsigned 2 MRHDRRC
8 8 Character 8 MRHDRTOD
16 10 Character 4 *
20 14 Character 0 MRHDR_END
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
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 is Absolute if ON.
Max share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. MTRUSR_VMDLIMTH Max share is Limithard if ON.
Max share is Limitsoft if OFF.
.... ...1 *
36 24 Unsigned 4 MTRUSR_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 this VMDBK has a
virtual processor dedicated to
it, and the user 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.
40 28 Unsigned 4 MTRUSR_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.
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.
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 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
MTRUSR_VMDMXSHA to determine if
Max share is absolute or
relative.
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 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 96
MTRUSR_ASCDEFSZ 58 8
MTRUSR_CALDEFHI 58 4
MTRUSR_CALDEFLO 5C 4
MTRUSR_CALDIAL 20 20
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_END 60 0
MTRUSR_MRHDR 0 0
MTRUSR_VMDABSSH 28 4
MTRUSR_VMDACTNO 30 8
MTRUSR_VMDBYVAL 4C 8
MTRUSR_VMDCPUAD 1C 2
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_VMDQDSPU 20 40
MTRUSR_VMDRELSH 24 4
MTRUSR_VMDSSIZE 2C 4
MTRUSR_VMDSTYPE 22 1
MTRUSR_VMDSVMST 20 80
MTRUSR_VMDUSER 14 8
This information is
based on z/VM V5R2.0.
Last updated on 11 Dec 2005 at 20:56:36.
Copyright IBM Corporation, 1990, 2005