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 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_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 V5R2.0.

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005