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   224  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  Bitstring     1  MTRUSR_VMDLOGFG        Flag bits set at logon
          1... ....        MTRUSR_VMDIDENT         This is an IDENTITY VMDBK
          .1.. ....        *                       
          ..1. ....        *                       
          ...1 ....        *                       
          .... 1...        *                       
          .... .1..        *                       
          .... ..1.        *                       
          .... ...1        *                       
 205  CD  Bitstring     3  *                      Reserved and available for
                                                  IBM use.
 208  D0  Character     8  MTRUSR_VMDRLOLG        Name of system on which
                                                  this user was originally
                                                  logged on
 216  D8  Character     8  MTRUSR_VMDRLSRC        Name of last system from
                                                  which this user was relocated
 224  E0  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    224
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                E0      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_VMDIDENT           CC           80
MTRUSR_VMDLIMTH           23           02
MTRUSR_VMDLOGFG           CC      1
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_VMDRLOLG           D0      8
MTRUSR_VMDRLSRC           D8      8
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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011