Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRUSELON

Prolog
Control Block Contents
Storage Layout
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.      *                   
          .... ...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 64-bit
                                             mode. Note that at this time it is
                                             impossible for a guest to show up
                                             as having entered 64-bit mode at
                                             logon time because guest has not
                                             had an opportunity to issue SIGP
                                             in order to enter 64-bit mode.
          .... ..1.      *                   
          .... ...1      *                   
 41  29  Bitstring    1  USELON_VMDSTYPE     Storage type this virtual
                                             machine resides in. X'00' => V=V.
                                             X'80' => V=R. 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 64-bit 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_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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002