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

#### MRMTRUSR

Prolog
Control 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