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
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 z/Arch
                                                 mode. Note that at this time it is
                                                 impossible for a guest to show up
                                                 as having entered z/Arch mode 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' => 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 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_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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003