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  204  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
                                                    including secondary processors.
                                                    Note: This number is always one
                                                    less than the total number of
                                                    processors defined because the
                                                    base processor is not guest
                                                    defined.
     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 for this CPU is
                                                    ABSOLUTE if on. Max share for
                                                    this CPU is RELATIVE if off.
              .1.. ....      MTRUSR_VMDSTOP         This virtual CPU is in soft
                                                    stop
              ..1. ....      MTRUSR_VMDSTOPD        This virtual CPU is stopped
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      MTRUSR_VMDLIMTH        Max share for this CPU is
                                                    LIMITHARD if on. Max share for
                                                    this CPU is LIMITSOFT if off.
              .... ...1      *
     36  24  Unsigned     4  MTRUSR_VMDRELSH        This virtual CPU's RELATIVE
                                                    share of the system, as set in
                                                    the user's directory or via the
                                                    SET SHARE command. Set to zero
                                                    when this VMDBK has an ABSOLUTE
                                                    share value, or has a virtual
                                                    processor dedicated to it, or
                                                    is in the process of being
                                                    logged off. This field should
                                                    not be used if MTRUSR_VMDSTOP
                                                    is on.
     40  28  Unsigned     4  MTRUSR_VMDABSSH        This virtual CPU'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 when this VMDBK has
                                                    a RELATIVE share value. This
                                                    field should not be used if
                                                    MTRUSR_VMDSTOP is on.
     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. Note: This
                                                    value captures the first 32
                                                    bits of the TOD clock which
                                                    gives approximately one second
                                                    of granularity.
     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        This virtual CPU'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. This
                                                    field should not be used if
                                                    MTRUSR_VMDSTOP is on.
     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  Unsigned     4  MTRUSR_CALCPCT         Number of guest defined CP
                                                    CPUs
    100  64  Unsigned     4  MTRUSR_CALZIPCT        Number of guest defined zIIP
                                                    CPUs
    104  68  Unsigned     4  MTRUSR_CALZAPCT        Number of guest defined zAAP
                                                    CPUs
    108  6C  Unsigned     4  MTRUSR_CALIFLCT        Number of guest defined IFL
                                                    CPUs
    112  70  Bitstring    1  MTRUSR_VMDCFGEM        Virtual configuration
                                                    indicators. Valid in base VMDBK
                                                    only
              1... ....      *
              .1.. ....      MTRUSR_VMDCPUAF        User requested CPU Affinity
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    113  71  Bitstring    1  MTRUSR_VMDPUST         CPU Status flag
              1... ....      MTRUSR_VMDAFSUP        CPU Affinity suppressed
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    114  72  Character    2  *                      Reserved for IBM use
    116  74  Unsigned     4  MTRUSR_CALICFCT        Number of guest defined ICF
                                                    CPUs
    120  78  Unsigned     4  MTRUSR_CP_SSHRELSH     This user's RELATIVE share
                                                    setting for CPUs of type CP.
    124  7C  Unsigned     4  MTRUSR_CP_SSHABSSH     This user's ABSOLUTE share
                                                    setting for CPUs of type CP.
    128  80  Unsigned     4  MTRUSR_CP_SSHMXSHR     This user's Max share setting
                                                    for CPUs of type CP.
    132  84  Bitstring    1  MTRUSR_CP_SSHFLG1      This user's share flags for
                                                    CPUs of type CP.
              1... ....      *
              .1.. ....      MTRUSR_CP_SSHLIMH      Max share for type CP is
                                                    LIMITHARD if on. Max share for
                                                    type CP is LIMITSOFT if off.
              ..1. ....      MTRUSR_CP_SSHNMSHA     Normal share for type CP is
                                                    ABSOLUTE if on. Normal share
                                                    for type CP is RELATIVE if off.
              ...1 ....      MTRUSR_CP_SSHMXSHA     Max share for type CP is
                                                    ABSOLUTE if on. Max share for
                                                    type CP is RELATIVE if off.
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    133  85  Bitstring    3  *                      Reserved and available for
                                                    IBM use.
    136  88  Unsigned     4  MTRUSR_ZAP_SSHRELSH    This user's RELATIVE share
                                                    setting for CPUs of type zAAP.
    140  8C  Unsigned     4  MTRUSR_ZAP_SSHABSSH    This user's ABSOLUTE share
                                                    setting for CPUs of type zAAP.
    144  90  Unsigned     4  MTRUSR_ZAP_SSHMXSHR    This user's Max share setting
                                                    for CPUs of type zAAP.
    148  94  Bitstring    1  MTRUSR_ZAP_SSHFLG1     This user's share flags for
                                                    CPUs of type zAAP.
              1... ....      *
              .1.. ....      MTRUSR_ZAP_SSHLIMH     Max share for type zAAP is
                                                    LIMITHARD if on. Max share for
                                                    type zAAP is LIMITSOFT if off.
              ..1. ....      MTRUSR_ZAP_SSHNMSHA    Normal share for type zAAP is
                                                    ABSOLUTE if on. Normal share
                                                    for type zAAP is RELATIVE if
                                                    off.
              ...1 ....      MTRUSR_ZAP_SSHMXSHA    Max share for type zAAP is
                                                    ABSOLUTE if on. Max share for
                                                    type zAAP is RELATIVE if off.
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    149  95  Bitstring    3  *                      Reserved and available for
                                                    IBM use.
    152  98  Unsigned     4  MTRUSR_IFL_SSHRELSH    This user's RELATIVE share
                                                    setting for CPUs of type IFL.
    156  9C  Unsigned     4  MTRUSR_IFL_SSHABSSH    This user's ABSOLUTE share
                                                    setting for CPUs of type IFL.
    160  A0  Unsigned     4  MTRUSR_IFL_SSHMXSHR    This user's Max share setting
                                                    for CPUs of type IFL.
    164  A4  Bitstring    1  MTRUSR_IFL_SSHFLG1     This user's share flags for
                                                    CPUs of type IFL.
              1... ....      *
              .1.. ....      MTRUSR_IFL_SSHLIMH     Max share for type IFL is
                                                    LIMITHARD if on. Max share for
                                                    type IFL is LIMITSOFT if off.
              ..1. ....      MTRUSR_IFL_SSHNMSHA    Normal share for type IFL is
                                                    ABSOLUTE if on. Normal share
                                                    for type IFL is RELATIVE if
                                                    off.
              ...1 ....      MTRUSR_IFL_SSHMXSHA    Max share for type IFL is
                                                    ABSOLUTE if on. Max share for
                                                    type IFL is RELATIVE if off.
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    165  A5  Bitstring    3  *                      Reserved and available for
                                                    IBM use.
    168  A8  Unsigned     4  MTRUSR_ICF_SSHRELSH    This user's RELATIVE share
                                                    setting for CPUs of type ICF.
    172  AC  Unsigned     4  MTRUSR_ICF_SSHABSSH    This user's ABSOLUTE share
                                                    setting for CPUs of type ICF.
    176  B0  Unsigned     4  MTRUSR_ICF_SSHMXSHR    This user's Max share setting
                                                    for CPUs of type ICF.
    180  B4  Bitstring    1  MTRUSR_ICF_SSHFLG1     This user's share flags for
                                                    CPUs of type ICF.
              1... ....      *
              .1.. ....      MTRUSR_ICF_SSHLIMH     Max share for type ICF is
                                                    LIMITHARD if on. Max share for
                                                    type ICF is LIMITSOFT if off.
              ..1. ....      MTRUSR_ICF_SSHNMSHA    Normal share for type ICF is
                                                    ABSOLUTE if on. Normal share
                                                    for type ICF is RELATIVE if
                                                    off.
              ...1 ....      MTRUSR_ICF_SSHMXSHA    Max share for type ICF is
                                                    ABSOLUTE if on. Max share for
                                                    type ICF is RELATIVE if off.
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    181  B5  Bitstring    3  *                      Reserved and available for
                                                    IBM use.
    184  B8  Unsigned     4  MTRUSR_ZIP_SSHRELSH    This user's RELATIVE share
                                                    setting for CPUs of type zIIP.
    188  BC  Unsigned     4  MTRUSR_ZIP_SSHABSSH    This user's ABSOLUTE share
                                                    setting for CPUs of type zIIP.
    192  C0  Unsigned     4  MTRUSR_ZIP_SSHMXSHR    This user's Max share setting
                                                    for CPUs of type zIIP.
    196  C4  Bitstring    1  MTRUSR_ZIP_SSHFLG1     This user's share flags for
                                                    CPUs of type zIIP.
              1... ....      *
              .1.. ....      MTRUSR_ZIP_SSHLIMH     Max share for type zIIP is
                                                    LIMITHARD if on. Max share for
                                                    type zIIP is LIMITSOFT if off.
              ..1. ....      MTRUSR_ZIP_SSHNMSHA    Normal share for type zIIP is
                                                    ABSOLUTE if on. Normal share
                                                    for type zIIP is RELATIVE if
                                                    off.
              ...1 ....      MTRUSR_ZIP_SSHMXSHA    Max share for type zIIP is
                                                    ABSOLUTE if on. Max share for
                                                    type zIIP is RELATIVE if off.
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    197  C5  Bitstring    3  *                      Reserved and available for
                                                    IBM use.
    200  C8  Bitstring    1  MTRUSR_FLAGS           Miscellaneous flag byte
              1... ....      MTRUSR_VMDREOFL        SET REORDER is in effect for
                                                    this user
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    201  C9  Bitstring    3  *                      Reserved and available for
                                                    IBM use.
    204  CC  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    204
    MTRUSR_ASCDEFSZ           58      8
    MTRUSR_CALCPCT            60      4
    MTRUSR_CALDEFHI           58      4
    MTRUSR_CALDEFLO           5C      4
    MTRUSR_CALDIAL            20           20
    MTRUSR_CALICFCT           74      4
    MTRUSR_CALIFLCT           6C      4
    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_CALZAPCT           68      4
    MTRUSR_CALZIPCT           64      4
    MTRUSR_CP_SSHABSSH        7C      4
    MTRUSR_CP_SSHFLG1         84      1
    MTRUSR_CP_SSHLIMH         84           40
    MTRUSR_CP_SSHMXSHA        84           10
    MTRUSR_CP_SSHMXSHR        80      4
    MTRUSR_CP_SSHNMSHA        84           20
    MTRUSR_CP_SSHRELSH        78      4
    MTRUSR_END                CC      0
    MTRUSR_FLAGS              C8      1
    MTRUSR_ICF_SSHABSSH       AC      4
    MTRUSR_ICF_SSHFLG1        B4      1
    MTRUSR_ICF_SSHLIMH        B4           40
    MTRUSR_ICF_SSHMXSHA       B4           10
    MTRUSR_ICF_SSHMXSHR       B0      4
    MTRUSR_ICF_SSHNMSHA       B4           20
    MTRUSR_ICF_SSHRELSH       A8      4
    MTRUSR_IFL_SSHABSSH       9C      4
    MTRUSR_IFL_SSHFLG1        A4      1
    MTRUSR_IFL_SSHLIMH        A4           40
    MTRUSR_IFL_SSHMXSHA       A4           10
    MTRUSR_IFL_SSHMXSHR       A0      4
    MTRUSR_IFL_SSHNMSHA       A4           20
    MTRUSR_IFL_SSHRELSH       98      4
    MTRUSR_MRHDR               0      0
    MTRUSR_VMDABSSH           28      4
    MTRUSR_VMDACTNO           30      8
    MTRUSR_VMDAFSUP           71           80
    MTRUSR_VMDBYVAL           4C      8
    MTRUSR_VMDCFGEM           70      1
    MTRUSR_VMDCPUAD           1C      2
    MTRUSR_VMDCPUAF           70           40
    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_VMDPUST            71      1
    MTRUSR_VMDQDSPU           20           40
    MTRUSR_VMDRELSH           24      4
    MTRUSR_VMDREOFL           C8           80
    MTRUSR_VMDSSIZE           2C      4
    MTRUSR_VMDSTOP            23           40
    MTRUSR_VMDSTOPD           23           20
    MTRUSR_VMDSTYPE           22      1
    MTRUSR_VMDSVMST           20           80
    MTRUSR_VMDUSER            14      8
    MTRUSR_ZAP_SSHABSSH       8C      4
    MTRUSR_ZAP_SSHFLG1        94      1
    MTRUSR_ZAP_SSHLIMH        94           40
    MTRUSR_ZAP_SSHMXSHA       94           10
    MTRUSR_ZAP_SSHMXSHR       90      4
    MTRUSR_ZAP_SSHNMSHA       94           20
    MTRUSR_ZAP_SSHRELSH       88      4
    MTRUSR_ZIP_SSHABSSH       BC      4
    MTRUSR_ZIP_SSHFLG1        C4      1
    MTRUSR_ZIP_SSHLIMH        C4           40
    MTRUSR_ZIP_SSHMXSHA       C4           10
    MTRUSR_ZIP_SSHMXSHR       C0      4
    MTRUSR_ZIP_SSHNMSHA       C4           20
    MTRUSR_ZIP_SSHRELSH       B8      4

    This information is
    based on z/VM V6R1.0.

    Last updated on 14 Sep 2010 at 23:05:13.

    Copyright IBM Corporation, 1990, 2010