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 V5R4.0.
Last updated on 14 Sep 2010 at 11:37:41.
Copyright IBM Corporation, 1990, 2010