|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSELON
PrologControl Block Contents
Cross Reference
MRUSELON Prolog
DSECT NAME - USELON
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRUSELON
DESCRIPTIVE NAME - Monitor Event Record
Domain 4 - User Domain
Record 1 - User Logon
DESCRIPTION - Records a user that has logged on. Generated for
the base VMDBK only.
MRUSELON Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 96 USELON Start of monitor record
0 0 Character 0 USELON_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 USELON_VMDUSER User logon identification
28 1C Unsigned 2 USELON_VMDCPUAD Processor address
30 1E Bitstring 1 USELON_VMDMODE Guest machine mode. This is
as set for internal use by CP.
See USELON_CALMODE for mode
'calculated' at.
31 1F Bitstring 1 USELON_CALSTAT User information
1... .... USELON_VMDSVMST 'OPTION SVMSTAT' has been
specified in the user's
directory
.1.. .... USELON_VMDQDSPU This user has the QUICKDSP
designation, either by default
or as set 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. .... USELON_CALDIAL This user is a dialed user
...1 .... USELON_CALSNA This user is connected
through System Network
Architecture (SNA)
.... 1... USELON_VMDNOINS User is prevented from
inserting any tracks into the
minidisk cache. (set when SET
MDC INS OFF command is issued)
.... .1.. USELON_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. USELON_VMDMASST Collaborative Memory
Management assist enabled.
Note: The VMDMAACT bit is not
provided in this record because
a recently logged on user would
not yet be in a CMM-active or
CMM-pending-off state.
.... ...1 *
32 20 Unsigned 4 USELON_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 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.
36 24 Unsigned 4 USELON_VMDABSSH This 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.
40 28 Bitstring 1 USELON_CALMODE Architectural mode of the
virtual machine
1... .... *
.1.. .... USELON_CALMESA ESA architecture
..1. .... USELON_CALMXA XA architecture
...1 .... USELON_CALM370 370 architecture
.... 1... USELON_CALMXC XC architecture
.... .1.. USELON_CALMESAM ESA mode user has entered
z/Arch mode. Note that at this
time it is impossible for a
guest to show up as having
entered z/Arch at logon time
because guest has not had an
opportunity to issue SIGP in
order to enter z/Arch mode.
.... ..1. *
.... ...1 *
41 29 Bitstring 1 USELON_VMDSTYPE Storage type this virtual
machine resides in. X'00' =>
V=V. X'80' => Reserved and no
longer available. X'40' => V=F.
42 2A Bitstring 1 USELON_CALSHARF Set Share flags
1... .... USELON_VMDMXSHA Max share is Absolute if ON.
Max share is Relative if OFF.
.1.. .... *
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. USELON_VMDLIMTH Max share is Limithard is ON.
Max share is Limitsoft is OFF.
.... ...1 *
43 2B Unsigned 1 * Reserved and available for
IBM use.
44 2C Unsigned 4 USELON_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
USELON_ASCDEFSZ
48 30 Unsigned 4 USELON_VMDMXRVP Number of pages reserved for
the user
52 34 Character 8 USELON_VMDACTNO User accounting number
60 3C Character 8 USELON_VMDGRPN RACF ACI group name
68 44 Character 8 USELON_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 USELON_VMDBYVAL The BYUSER ID that logged on
this virtual machine. If there
is no BYUSER, this field is
binary zeros.
84 54 Unsigned 4 USELON_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
USELON_VMDMXSHA to determine if
Max share is absolute or
relative.
88 58 Character 8 USELON_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 USELON_CALDEFHI high four bytes
92 5C Character 4 USELON_CALDEFLO low four bytes
96 60 Character 0 USELON_END
MRUSELON 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
USELON 0 96
USELON_ASCDEFSZ 58 8
USELON_CALDEFHI 58 4
USELON_CALDEFLO 5C 4
USELON_CALDIAL 1F 20
USELON_CALMESA 28 40
USELON_CALMESAM 28 04
USELON_CALMODE 28 1
USELON_CALMXA 28 20
USELON_CALMXC 28 08
USELON_CALM370 28 10
USELON_CALSHARF 2A 1
USELON_CALSNA 1F 10
USELON_CALSTAT 1F 1
USELON_CALTODON 44 8
USELON_END 60 0
USELON_MRHDR 0 0
USELON_VMDABSSH 24 4
USELON_VMDACTNO 34 8
USELON_VMDBYVAL 4C 8
USELON_VMDCPUAD 1C 2
USELON_VMDGRPN 3C 8
USELON_VMDLIMTH 2A 02
USELON_VMDMASST 1F 02
USELON_VMDMODE 1E 1
USELON_VMDMXRVP 30 4
USELON_VMDMXSHA 2A 80
USELON_VMDMXSHR 54 4
USELON_VMDNOFSL 1F 04
USELON_VMDNOINS 1F 08
USELON_VMDQDSPU 1F 40
USELON_VMDRELSH 20 4
USELON_VMDSSIZE 2C 4
USELON_VMDSTYPE 29 1
USELON_VMDSVMST 1F 80
USELON_VMDUSER 14 8
This information is
based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007