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

#### MRUSEATE

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRUSEATE Prolog

####

####

     DSECT NAME - USEATE
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRUSEATE
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 4 - User Domain
                        Record 9 - User Activity Data at Transaction End
     DESCRIPTION - Provides information relating to a VMDBK's
                   consumption of system resources for a transaction.
                   A separate record is generated for each VMDBK in a
                   virtual complex that contributed to the transaction.

    MRUSEATE Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure  272  USEATE              Start of monitor record
      0   0  Character    0  USEATE_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  USEATE_VMDUSER      Userid
     28  1C  Unsigned     2  USEATE_VMDCPUAD     Processor ID
     30  1E  Bitstring    1  USEATE_VMDMODE      Guest machine mode. This is as
                                                 set for internal use by CP. See
                                                 USEATE_CALMODE for the mode
                                                 'calculated' at.
     31  1F  Bitstring    1  USEATE_CALMODE      Architectural mode of the
                                                 virtual machine
              1... ....      *
              .1.. ....      USEATE_CALMESA      ESA architecture
              ..1. ....      USEATE_CALMXA       XA architecture
              ...1 ....      USEATE_CALM370      370 architecture
              .... 1...      USEATE_CALMXC       XC architecture
              .... .1..      USEATE_CALMESAM     ESA mode machine has entered
                                                 ESAME mode
              .... ..1.      *
              .... ...1      *
     32  20  Character    8  USEATE_VMDTTIME     Total time which has been
                                                 expended on this VMDBK. This
                                                 includes time which the VMDBK
                                                 spent doing its own work and also
                                                 time which CP spent doing work on
                                                 behalf of the VMDBK. It is in CPU
                                                 timer format. The complement of
                                                 this field is the elapsed time in
                                                 TOD clock units.
     40  28  Character    8  USEATE_VMDVTIME     Total time that this user was
                                                 running, doing productive work. It
                                                 does not include any time that CP
                                                 spends on behalf of that user
                                                 doing such things as instruction
                                                 simulation or page translation.
                                                 This is in CPU timer FORMAT. The
                                                 complement of this field is the
                                                 elapsed time in TOD clock units.
     48  30  Character    8  USEATE_VMDVFVTM     Amount of time, in TOD clock
                                                 units, that is consumed by the
                                                 guest using vector instructions
                                                 while in SIE
     56  38  Character    8  USEATE_VMDVFOTM     Amount of time, in TOD clock
                                                 units, consumed by the system to
                                                 support this guest's loading and
                                                 unloading of its virtual vector
                                                 facility.
     64  40  Unsigned     4  USEATE_VMDCTPVR     Cardinal count of resident pages
                                                 in private address spaces
                                                 belonging to this user. This
                                                 monitor field is actually the sum
                                                 of VMDCTPVR + VMDCTPVG. To get the
                                                 count of resident pages below the
                                                 2GB line, subtract USEATE_VMDCTPVG
                                                 from USEATE_VMDCTPVR.
     68  44  Unsigned     4  USEATE_VMDCTPVL     Cardinal count of locked pages
                                                 in private address spaces
                                                 belonging to this user.
     72  48  Unsigned     4  USEATE_VMDWSSPR     This user's projected working
                                                 set size. This is the scheduler's
                                                 estimate of the amount of storage
                                                 this user will require to be
                                                 resident as it runs during its
                                                 next stay in the dispatch list. It
                                                 is based upon the user's past
                                                 behavior and in some cases, on the
                                                 behavior of similar types of
                                                 users.
     76  4C  Unsigned     4  USEATE_VMDCTXBK     The number of expanded storage
                                                 blocks allocated to a virtual
                                                 machine by CP for paging
     80  50  Unsigned     4  USEATE_VMDCTFLT     Count of host segment and page
                                                 faults on guest pages which
                                                 occurred while running this
                                                 virtual CPU. It does not include
                                                 faults on RCP pages.
     84  54  Unsigned     4  USEATE_VMDCTVFL     Number of times this virtual
                                                 system's vector facility was
                                                 loaded into a real vector
                                                 facility. If the virtual vector
                                                 facility is currently loaded, this
                                                 count would be approximately equal
                                                 to the number of saves.
     88  58  Unsigned     4  USEATE_VMDCTORF     Total number of referenced
                                                 frames resident when reset was
                                                 done for this virtual system's
                                                 private address spaces
     92  5C  Unsigned     4  USEATE_CALCTPGS     Cardinal count of non-preferred
                                                 paging slots for private address
                                                 spaces belonging to this user.
     96  60  Unsigned     4  *                   Reserved for IBM use
    100  64  Unsigned     4  USEATE_VMDCTPWT     Count of outstanding paging and
                                                 spooling I/O's for this user
    104  68  Unsigned     4  USEATE_CALCPPGR     Cumulative count of pages read
                                                 from DASD to main storage for this
                                                 user's address spaces while they
                                                 were private.
    108  6C  Unsigned     4  USEATE_CALCPPGW     Cumulative count of pages
                                                 written from main storage to DASD
                                                 for this user's address spaces
                                                 while they were private.
    112  70  Unsigned     4  USEATE_VMDCTSPR     Number of times I/O was issued
                                                 for a spool read request
    116  74  Unsigned     4  USEATE_VMDCTSPW     Number of times I/O was issued
                                                 for a spool write request
    120  78  Unsigned     4  USEATE_VMDPGSPL     Number of pages spooled for this
                                                 user. This includes the pages
                                                 spooled for the virtual reader,
                                                 printer, punch, console, dump, and
                                                 trace files.
    124  7C  Unsigned     4  USEATE_VMDVCSCT     Number of start requests to the
                                                 virtual machine console
    128  80  Unsigned     4  USEATE_VMDVDSCT     Cumulative count of virtual I/O
                                                 requests the virtual machine has
                                                 issued to DASD devices
    132  84  Unsigned     4  USEATE_VMDVUSCT     Count of Start requests to
                                                 virtual Unit Record devices
    136  88  Unsigned     4  USEATE_VMDVTSCT     Count of Start requests to
                                                 virtual channel-to-channel
                                                 adapters
    140  8C  Unsigned     4  USEATE_VMDVOSCT     Count of Start requests to
                                                 devices other than console, DASDs,
                                                 CTCAs, and unit records. (see
                                                 USEATE_VMDVCSCT, USEATE_VMDVDSCT,
                                                 USEATE_VMDVUSCT, and
                                                 USEATE_VMDVTSCT.)
    144  90  Unsigned     4  USEATE_CALCPPST     Cumulative count of pages stolen
                                                 from this user's address spaces
                                                 while they were private.
    148  94  Unsigned     4  USEATE_VMDISEVM     Number of times IUCV/APPC data
                                                 was successfully transferred from
                                                 this virtual complex. (SENDs and
                                                 REPLYs with RC=0 when this virtual
                                                 machine is the source). Not valid
                                                 in the SYSTEM VMDBK. Valid only in
                                                 base VMDBK.
    152  98  Unsigned     4  USEATE_VMDISTVM     Number of times IUCV/APPC data
                                                 was successfully transferred to
                                                 this virtual complex. (SENDs and
                                                 REPLYs with RC=0 when this virtual
                                                 machine is the target). Not valid
                                                 in the SYSTEM VMDBK. Valid only in
                                                 base VMDBK.
    156  9C  Unsigned     4  USEATE_VMDISUVM     Number of times IUCV/APPC data
                                                 was not successfully transferred
                                                 from this virtual complex. (SENDs
                                                 and REPLYs with RC=0 when this
                                                 virtual machine is the source).
                                                 Not valid in the SYSTEM VMDBK.
                                                 Valid only in base VMDBK.
    160  A0  Unsigned     4  USEATE_VMDVSEVM     Number of times VMCF data was
                                                 successfully transferred by this
                                                 virtual machine. (SENDs SENDXs,
                                                 SEND/RECEIVEs, and REPLYs with
                                                 RC=0 and this virtual machine is
                                                 source.)
    164  A4  Unsigned     4  USEATE_VMDVSTVM     Number of times VMCF data was
                                                 successfully transferred to this
                                                 virtual machine. (SENDs SENDXs,
                                                 SEND/RECEIVEs, and REPLYs with
                                                 RC=0 and this virtual machine is
                                                 target.)
    168  A8  Unsigned     4  USEATE_VMDVSUVM     Number of times VMCF data was
                                                 not successfully transferred by
                                                 this virtual machine. (SENDs
                                                 SENDXs, SEND/RECEIVEs, and REPLYs
                                                 with RC^=0 and this virtual
                                                 machine is source.)
    172  AC  Unsigned     4  USEATE_VMDX98CT     Cumulative number of times
                                                 Diagnose X'98' was issued by this
                                                 virtual machine
    176  B0  Unsigned     4  USEATE_CALCPMIG     Cumulative count of pages
                                                 migrated by CP from expanded
                                                 storage to DASD for this user's
                                                 address spaces while they were
                                                 private.
    180  B4  Unsigned     4  USEATE_CALCPXWT     Cumulative count of pages
                                                 written from main storage to
                                                 expanded storage for this user's
                                                 address spaces while they were
                                                 private.
    184  B8  Unsigned     4  USEATE_CALCPXRD     Cumulative count of pages read
                                                 from expanded storage to main
                                                 storage for this user's address
                                                 spaces while they were private.
    188  BC  Bitstring    1  USEATE_CALFLAG1     Flag byte
              1... ....      USEATE_CALBASE      If on, this is the base VMDBK.
                                                 VMDBASE
              .1.. ....      USEATE_VMDQDSPU     This user has the QUICKDSP
                                                 designation, either by default or
                                                 as set 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. ....      USEATE_CALDIAL      This user is a dialed user
              ...1 ....      USEATE_CALSNA       This user is connected through
                                                 System Network Architecture (SNA)
              .... 1...      USEATE_VMDNOINS     User is prevented from inserting
                                                 any tracks into the minidisk
                                                 cache. (set when SET MDC INS OFF
                                                 command is issued)
              .... .1..      USEATE_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      *
    189  BD  Bitstring    1  USEATE_VMDSTYPE     Storage type this virtual
                                                 machine resides in. X'00' => V=V.
                                                 X'80' => V=R. X'40' => V=F.
    190  BE  Bitstring    1  USEATE_CALSHARF     Set Share flags
              1... ....      USEATE_VMDMXSHA     Max share is Absolute if ON. Max
                                                 share is Relative if OFF.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      USEATE_VMDLIMTH     Max share is Limithard if ON.
                                                 Max share is Limitsoft if OFF.
              .... ...1      *
    191  BF  Unsigned     1  *                   Reserved and available for IBM
                                                 use.
    192  C0  Unsigned     4  USEATE_VMDBLKCT     Count of SSCH's issued by
                                                 BLOCKIO system service (includes
                                                 both read and write requests)
    196  C4  Unsigned     4  USEATE_VMDMDCIA     Count of SSCH's avoided due to
                                                 Minidisk Cache read hit
    200  C8  Unsigned     4  USEATE_VMDCOPCT     Number of times this virtual CPU
                                                 had to be redispatched due to a
                                                 crypto operation exception
    204  CC  Unsigned     4  USEATE_VMDCTISO     Number of times ISOLATE occurred
                                                 for spaces owned by this virtual
                                                 system. Valid only in base VMDBK
    208  D0  Unsigned     4  USEATE_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 if
                                                 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.
    212  D4  Unsigned     4  USEATE_VMDABSSH     This 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.
    216  D8  Unsigned     4  USEATE_VMDSSIZE     Virtual machine size, in bytes.
                                                 This field is kept for
                                                 compatability reasons, but may not
                                                 be accurate for ESAME systems
                                                 where larger virtual machines are
                                                 valid. The preferred field is
                                                 USEATE_ASCDEFSZ
    220  DC  Unsigned     4  USEATE_VMDMXRVP     Number of pages reserved for the
                                                 user
    224  E0  Character    8  USEATE_VMDACTNO     User accounting number
    232  E8  Character    8  USEATE_VMDGRPN      RACF ACI group name
    240  F0  Character    8  USEATE_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.
    248  F8  Unsigned     4  USEATE_VMDVDISK     Count of virtual I/Os to a
                                                 virtual disk in storage.
    252  FC  Unsigned     4  USEATE_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 USEATE_VMDMXSHA to determine
                                                 if Max share is absolute or
                                                 relative.
    256 100  Character    8  USEATE_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').
    256 100  Character    4  USEATE_CALDEFHI     high four bytes
    260 104  Character    4  USEATE_CALDEFLO     low four bytes
    264 108  Unsigned     4  USEATE_VMDCTPVG     Count of private address space
                                                 resident pages in DPA owned by
                                                 this virtual machine which are >=
                                                 2G. Valid only in base VMDBK.
    268 10C  Unsigned     4  USEATE_VMDMVB2G     Number of times page translation
                                                 moved a page on behalf of this us
                                                 user from a frame with address >=
                                                 2GB to one < 2GB. This field is
                                                 only valid in the base VMDBK.
    272 110  Character    0  USEATE_END

    MRUSEATE 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
    USEATE                  0    272
    USEATE_ASCDEFSZ       100      8
    USEATE_CALBASE         BC           80
    USEATE_CALCPMIG        B0      4
    USEATE_CALCPPGR        68      4
    USEATE_CALCPPGW        6C      4
    USEATE_CALCPPST        90      4
    USEATE_CALCPXRD        B8      4
    USEATE_CALCPXWT        B4      4
    USEATE_CALCTPGS        5C      4
    USEATE_CALDEFHI       100      4
    USEATE_CALDEFLO       104      4
    USEATE_CALDIAL         BC           20
    USEATE_CALFLAG1        BC      1
    USEATE_CALMESA         1F           40
    USEATE_CALMESAM        1F           04
    USEATE_CALMODE         1F      1
    USEATE_CALMXA          1F           20
    USEATE_CALMXC          1F           08
    USEATE_CALM370         1F           10
    USEATE_CALSHARF        BE      1
    USEATE_CALSNA          BC           10
    USEATE_CALTODON        F0      8
    USEATE_END            110      0
    USEATE_MRHDR            0      0
    USEATE_VMDABSSH        D4      4
    USEATE_VMDACTNO        E0      8
    USEATE_VMDBLKCT        C0      4
    USEATE_VMDCOPCT        C8      4
    USEATE_VMDCPUAD        1C      2
    USEATE_VMDCTFLT        50      4
    USEATE_VMDCTISO        CC      4
    USEATE_VMDCTORF        58      4
    USEATE_VMDCTPVG       108      4
    USEATE_VMDCTPVL        44      4
    USEATE_VMDCTPVR        40      4
    USEATE_VMDCTPWT        64      4
    USEATE_VMDCTSPR        70      4
    USEATE_VMDCTSPW        74      4
    USEATE_VMDCTVFL        54      4
    USEATE_VMDCTXBK        4C      4
    USEATE_VMDGRPN         E8      8
    USEATE_VMDISEVM        94      4
    USEATE_VMDISTVM        98      4
    USEATE_VMDISUVM        9C      4
    USEATE_VMDLIMTH        BE           02
    USEATE_VMDMDCIA        C4      4
    USEATE_VMDMODE         1E      1
    USEATE_VMDMVB2G       10C      4
    USEATE_VMDMXRVP        DC      4
    USEATE_VMDMXSHA        BE           80
    USEATE_VMDMXSHR        FC      4
    USEATE_VMDNOFSL        BC           04
    USEATE_VMDNOINS        BC           08
    USEATE_VMDPGSPL        78      4
    USEATE_VMDQDSPU        BC           40
    USEATE_VMDRELSH        D0      4
    USEATE_VMDSSIZE        D8      4
    USEATE_VMDSTYPE        BD      1
    USEATE_VMDTTIME        20      8
    USEATE_VMDUSER         14      8
    USEATE_VMDVCSCT        7C      4
    USEATE_VMDVDISK        F8      4
    USEATE_VMDVDSCT        80      4
    USEATE_VMDVFOTM        38      8
    USEATE_VMDVFVTM        30      8
    USEATE_VMDVOSCT        8C      4
    USEATE_VMDVSEVM        A0      4
    USEATE_VMDVSTVM        A4      4
    USEATE_VMDVSUVM        A8      4
    USEATE_VMDVTIME        28      8
    USEATE_VMDVTSCT        88      4
    USEATE_VMDVUSCT        84      4
    USEATE_VMDWSSPR        48      4
    USEATE_VMDX98CT        AC      4

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

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002