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            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  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 mode
              .... ..1.      *
              .... ...1      *
     34  22  Bitstring    1  MTRUSR_VMDSTYPE     Storage type this virtual
                                                 machine resides in. X'00' => V=V.
                                                 X'80' => V=R. 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 V4R4.0.

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

    Copyright IBM Corporation, 1990, 2003