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
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.
     NOTES:
          - To give a fuller picture of time consumed, three
            sets of used processor time are reported in this
            monitor record.  When multithreading is enabled on
            the system, all three are also reported in the Type
            1 and F accounting records. Timer field names
            ending with _MT1 are MT-1 Equivalent times. Timer
            field names ending with _PRO are Prorated Core
            Times.  Timer field names without an _MT1 or _PRO
            suffix contain Raw Time values.
          - Raw Time is tracked for ALL users for their entire
            session.  Raw Time is the CPU time each virtual CPU
            spent dispatched on a thread and is the CPU Timer
            information provided directly by the hardware.
          - MT-1 Equivalent Time is tracked for ALL users for
            their entire session. This calculated CPU time
            approximates the time that would have been spent
            if the workload had been run with multithreading
            disabled, that is, with all core resources available
            to one thread.  When a user is running on a system
            where multithreading is not installed or not
            enabled, MT-1 Equivalent Time consumed will be
            identical to Raw Time.  However, if a guest has
            relocated from an MT-enabled system to an
            MT-disabled system, the cumulative raw and MT-1
            Equivalent times reported in monitor records may
            differ due to the prior execution in the MT
            environment.
          - Prorated Core Time charges for core utilization in
            a way suitable to core-based software licensing.
            Time is charged by dividing the time the core was
            dispatched evenly among the threads dispatched in
            that interval. Since Prorated Core Time is not
            always calculated, additional information
            is reported regarding the Prorated Core Time values:
            * The _VMAPRCAL bit indicates whether the Prorated
              Core Time values in this record are valid.
            When the user is relocated to any other system
            (even a Multithreading aware/enabled system),
            Prorated Core Time is reset. This means:
            * the _VMAPRCAL bit is set based on whether the
              source system will be calculating prorated core
              time or not.
            * all _VMAxxxxx_PRO fields are reset to PFXTMMAX.

#### MRUSEATE Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   544  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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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         Machine has entered z/Arch
                                                      mode
              .... ..1.        *
              .... ...1        USEATE_CALMZONL         z/Architecture-only
      32  20  Character     8  USEATE_VMDTTIME        Total Raw 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 Raw Time that this
                                                      user was running and 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 accumulated time in TOD
                                                      clock units.
      48  30  Character     8  *                      Reserved for IBM use
                                                      Previous field is no longer
                                                      meaningful. (USEATE_VMDVFVTM)
      56  38  Character     8  *                      Reserved for IBM use
                                                      Previous field is no longer
                                                      meaningful. (USEATE_VMDVFOTM)
      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 <2G belonging to this
                                                      user. See USEATE_VMDCTPVLA
                                                      for the >2G value.
      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  *                      Reserved for IBM use - was
                                                      USEATE_VMDCTXBK
      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  *                      Reserved for IBM use
                                                      Previous field is no longer
                                                      meaningful. (USEATE_VMDCTVFL)
      88  58  Unsigned      4  *                      Reserved for IBM use - was
                                                      USEATE_VMDCTORF
      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        Cumulative count of virtual
                                                      SSCH requests to the
                                                      the virtual machine console
     128  80  Unsigned      4  USEATE_VMDVDSCT        Cumulative count of virtual
                                                      SSCH requests the virtual
                                                      machine has issued to DASD
                                                      devices
     132  84  Unsigned      4  USEATE_VMDVUSCT        Cumulative count of virtual
                                                      SSCH requests to
                                                      virtual Unit Record devices
     136  88  Unsigned      4  USEATE_VMDVTSCT        Cumulative count of virtual
                                                      SSCH requests to
                                                      virtual channel-to-channel
                                                      adapters
     140  8C  Unsigned      4  USEATE_VMDVOSCT        Cumulative count of virutal
                                                      SSCH request 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
                                                      reclaimed from this user's
                                                      addr spaces while they were
                                                      private. Valid only for base
                                                      VMDBK
     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  *                      Reserved for IBM use - was
                                                      USEATE_CALCPMIG
     180  B4  Unsigned      4  *                      Reserved for IBM use - was
                                                      USEATE_CALCPXWT
     184  B8  Unsigned      4  *                      Reserved for IBM use - was
                                                      USEATE_CALCPXRD
     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.        USEATE_VMDMASST         Collaborative Memory
                                                      Management assist enabled.
              .... ...1        USEATE_VMDMAACT         Collaborative Memory
                                                      Management assist is active,
                                                      i.e. in use by this virtual
                                                      machine. Note: This guest may
                                                      be in a pending off state if
                                                      either a global or per-user
                                                      SET MEMASSIST OFF has been
                                                      issued (SYSMASST or VMDMASST
                                                      is off). This indicates that
                                                      the system or user setting
                                                      was turned off after the
                                                      guest started using the
                                                      assist. The assist will
                                                      remain active
                                                      (USEATE_VMDMAACT=1) and
                                                      available to this guest until
                                                      the next virtual machine
                                                      reset or IPL.
     189  BD  Bitstring     1  USEATE_VMDSTYPE        Storage type this virtual
                                                      machine resides in. X'00' =>
                                                      V=V. X'80' => Reserved and no
                                                      longer available. 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.. ....        USEATE_VMDSTOP          This virtual CPU is in
                                                      soft stop
              ..1. ....        USEATE_VMDSTOPD         This virtual CPU is
                                                      stopped
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        USEATE_VMDLIMTH         Max share is Limithard if
                                                      ON. Max share is Limitsoft if
                                                      OFF.
              .... ...1        *
     191  BF  Bitstring     1  USEATE_LCLFLAGS        General Flags
              1... ....        USEATE_VMDVVECT         Vector Regs in Use
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     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  *                      Reserved for IBM use
                                                      Previous field is no longer
                                                      meaningful. (USEATE_VMDCOPCT)
     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 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.
     212  D4  Unsigned      4  USEATE_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.
     216  D8  Unsigned      4  USEATE_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
                                                      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        Cumulative count of virutual
                                                      SSCH requests to
                                                      virtual disk in storage.
     252  FC  Unsigned      4  USEATE_VMDMXSHR        The 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 USEATE_VMDMXSHA to
                                                      determine if Max share is
                                                      absolute or relative. This
                                                      field should not be used if
                                                      USEATE_VMDSTOP is on.
     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  Unsigned      4  USEATE_VEBALERT        Number of alert
                                                      interruptions Collected only
                                                      for base VMDBK.
     276 114  Unsigned      4  USEATE_VEBTVSCT        Number of interceptions for
                                                      guest TVS instructions
                                                      Collected only for base
                                                      VMDBK.
     280 118  Unsigned      4  USEATE_VEBSVSCT        Number of interceptions for
                                                      guest SVS instructions
                                                      Collected only for base
                                                      VMDBK.
     284 11C  Unsigned      4  USEATE_VEBTPIAI        Number of adapter
                                                      interruptions delivered via
                                                      guest TPI Collected only for
                                                      base VMDBK.
     288 120  Unsigned      4  USEATE_VEBVIRAI        Number of adapter
                                                      interruptions stacked for
                                                      guest by CP Collected only
                                                      for base VMDBK.
     292 124  Unsigned      4  USEATE_VEBHDWAI        Number of adapter
                                                      interruptions delivered to
                                                      guest inside SIE Collected
                                                      only for base VMDBK.
     296 128  Character     8  USEATE_VMDCTPVLA       Cardinal count of locked
                                                      pages in private address
                                                      spaces >2G belonging to this
                                                      user. See USEATE_VMDCTPVL for
                                                      the <2G value.
     304 130  Unsigned      4  USEATE_VMDCTSHL        Count of shared address
                                                      space resident pages <2G.
                                                      Valid only in the SYSTEM
                                                      VMDBK.
     308 134  Character     8  USEATE_VMDCTSHLA       Count of shared address
                                                      space resident pages >2G.
                                                      Valid only in the SYSTEM
                                                      VMDBK.
     316 13C  Unsigned      1  USEATE_VMDPUTYP        CPU Type. Valid values:
                                                      X'00' - General Purpose (CP)
                                                      X'02' - zSeries Application
                                                      Assist (zAAP) X'03' -
                                                      Integrated Facility for Linux
                                                      (IFL) X'04' - Internal
                                                      Coupling Facility (ICF) X'05'
                                                      - zSeries Integrated
                                                      Information (zIIP)
     317 13D  Bitstring     1  USEATE_VMDCFGEM        Virtual configuration
                                                      indicators. Valid in base
                                                      VMDBK only
              1... ....        *
              .1.. ....        USEATE_VMDCPUAF         User requested CPU
                                                      Affinity
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     318 13E  Bitstring     1  USEATE_VMDPUST         CPU Status flag
              1... ....        USEATE_VMDAFSUP         CPU Affinity suppressed
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     319 13F  Character     1  *                      Reserved for IBM use
     320 140  Character     8  USEATE_VMDVTMP         Total raw virtual time for
                                                      the user on primary
                                                      processor.
     328 148  Character     8  USEATE_VMDTTMP         Total raw virtual and
                                                      simulation time for the user
                                                      on primary processor.
     336 150  Character     8  USEATE_VMDVTMS         Total raw virtual time for
                                                      the user on secondary
                                                      processor.
     344 158  Character     8  USEATE_VMDTTMS         Total raw virtual and
                                                      simulation time for the user
                                                      on secondary processor.
     352 160  Character     8  USEATE_VMDTTIME_MT1    Total MT-1 Equivalent 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.
     360 168  Character     8  USEATE_VMDVTIME_MT1    Total MT-1 Equivalent time
                                                      that this user was running
                                                      and 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.
     368 170  Character     8  USEATE_VMDVTMP_MT1     MT-1 Equivalent virtual
                                                      time for the user on primary
                                                      processor
     376 178  Character     8  USEATE_VMDTTMP_MT1     MT-1 Equivalent total
                                                      virtual and simulation time
                                                      for the user on primary
                                                      processor.
     384 180  Character     8  USEATE_VMDVTMS_MT1     MT-1 Equivalent total
                                                      virtual time for the user on
                                                      secondary processor.
     392 188  Character     8  USEATE_VMDTTMS_MT1     MT-1 Equivalent total
                                                      virtual and simulation time
                                                      for the user on secondary
                                                      processor.
     400 190  Character     8  USEATE_VMATTIME_PRO    Total Prorated Core 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.
                                                      See the notes above.
     408 198  Character     8  USEATE_VMAVTIME_PRO    Total Prorated Core Time
                                                      that this user was running
                                                      and 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. See the
                                                      notes above.
     416 1A0  Character     8  USEATE_VMAVTMP_PRO     Total Prorated Core virtual
                                                      time for user on primary
                                                      processor. See the notes
                                                      above.
     424 1A8  Character     8  USEATE_VMATTMP_PRO     Total Prorated Core virtual
                                                      and simulation time for the
                                                      user on primary processor.
                                                      See the notes above.
     432 1B0  Character     8  USEATE_VMAVTMS_PRO     Total Prorated Core virtual
                                                      time for user on secondary
                                                      processor. See the notes
                                                      above.
     440 1B8  Character     8  USEATE_VMATTMS_PRO     Total Prorated Core virtual
                                                      and simulation time for the
                                                      user on secondary processor.
                                                      See the notes above.
     448 1C0  Unsigned      4  *                      Reserved for IBM use
     452 1C4  Bitstring     1  USEATE_PROBITS         Prorated Core Time bits
                                                      needed to understand those
                                                      fields.
              1... ....        USEATE_VMAPRCAL         Indicates whether the
                                                      Prorated Core Time values in
                                                      this record are valid (only
                                                      use if valid): 0 = values not
                                                      valid 1 = values are valid
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     453 1C5  Bitstring     1  *                      Reserved for IBM use
     454 1C6  Unsigned      2  *                      Reserved for IBM use
     456 1C8  Unsigned      4  USEATE_CALDWTCT        Count of the number of
                                                      times this VMDBK became ready
                                                      to be dispatched (unsigned
                                                      fullword). This is calculated
                                                      using VMUDWTCT.
     460 1CC  Character     8  USEATE_VMUDWTETM       Accumulated elapsed time
                                                      between when this VMDBK
                                                      became ready to be dispatched
                                                      and when it was dispatched
                                                      (unsigned doubleword in
                                                      microseconds)
     468 1D4  Character    16  USEATE_VMUDWTTSQ       Sum of the squares of the
                                                      individual elapsed time
                                                      samples which comprise
                                                      USEATE_VMUDWTETM (unsigned
                                                      quadword in squared
                                                      microseconds) Note: Use
                                                      deltas of USEATE_CALDWTCT,
                                                      USEATE_VMUDWTETM, and this
                                                      field to calculate the
                                                      average amount of elapsed
                                                      time this VMDBK waited to be
                                                      dispatched once it became
                                                      ready, and the standard
                                                      deviation of those time
                                                      samples.
     484 1E4  Unsigned      4  USEATE_CALDSPCT        Count of the number of
                                                      times this VMDBK was
                                                      dispatched (unsigned
                                                      fullword). This is calculated
                                                      using VMUDSPCT. Note: This
                                                      count can be used with both
                                                      the dispatched times and the
                                                      USEATE_VMDTTIME values as
                                                      those are all calculated at
                                                      the same moment.
     488 1E8  Character     8  USEATE_VMUDSPETM       Accumulated elapsed time
                                                      during which this VMDBK was
                                                      dispatched (unsigned
                                                      doubleword in microseconds)
     496 1F0  Character    16  USEATE_VMUDSPTSQ       Sum of the squares of the
                                                      individual elapsed time
                                                      samples which comprise
                                                      USEATE_VMUDSPETM (unsigned
                                                      quadword in squared
                                                      microseconds) Note: Use
                                                      deltas of USEATE_CALDSPCT,
                                                      USEATE_VMUDSPETM, and this
                                                      field to calculate the
                                                      average amount of elapsed
                                                      time this VMDBK was
                                                      dispatched, and the standard
                                                      deviation of those time
                                                      samples.
     512 200  Character    16  USEATE_VMUTTIMSQ       Sum of the squares of the
                                                      individual CPU timer samples
                                                      added to VMDTTIME at
                                                      undispatch (unsigned quadword
                                                      in squared TOD clock units)
                                                      Note: Use deltas of
                                                      USEATE_CALDSPCT,
                                                      USEATE_VMDTTIME and this
                                                      field to calculate the
                                                      average amount of CPU time
                                                      this VMDBK consumed while it
                                                      was dispatched, and the
                                                      standard deviation of those
                                                      time samples.
     528 210  Unsigned      4  USEATE_VMDCPUCH        Count of SIE entries with
                                                      SIEIHCPU <> x'FFFF' and this
                                                      is a different logical CPU
                                                      than the one on which this
                                                      VMDBK was last run (i.e. CPU
                                                      CHanged)
     532 214  Unsigned      4  USEATE_VMDRUNCP        Count of SIE instructions
                                                      issued for this VMDBK in the
                                                      HCPRUN long path

                                                      Guest Control Program Identification

                                                      Control Program Name Codes
                                                      for USEATE_VMACPNC:

                                                      X'00'           No CPNC specified
                                                      X'01'           PR/SM
                                                      X'02'           z/VM
                                                      X'04'           Linux (including KVM)
                                                      X'06'           z/OS
                                                      X'07'           z/TPF
                                                      X'08'           z/VSE
                                                      X'20'-X'23' Supplemental codes for z/VM
                                                      X'24'-X'27' Supplemental codes for
                                                                  Linux/KVM
                                                      X'28'-X'2B' Supplemental codes for z/OS
                                                      X'2C'-X'2F' Supplemental codes for z/TPF
                                                      X'30'-X'33' Supplemental codes for z/VSE
                                                      Supplemental codes for z/VSE
     536 218  Unsigned      1  USEATE_VMACPNC         Control Program name code.
     537 219  Character     7  USEATE_VMACPVC         Control Program version
                                                      code.
     544 220  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    544
    USEATE_ASCDEFSZ          100      8
    USEATE_CALBASE            BC           80
    USEATE_CALCPPGR           68      4
    USEATE_CALCPPGW           6C      4
    USEATE_CALCPPST           90      4
    USEATE_CALCTPGS           5C      4
    USEATE_CALDEFHI          100      4
    USEATE_CALDEFLO          104      4
    USEATE_CALDIAL            BC           20
    USEATE_CALDSPCT          1E4      4
    USEATE_CALDWTCT          1C8      4
    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_CALMZONL           1F           01
    USEATE_CALM370            1F           10
    USEATE_CALSHARF           BE      1
    USEATE_CALSNA             BC           10
    USEATE_CALTODON           F0      8
    USEATE_END               220      0
    USEATE_LCLFLAGS           BF      1
    USEATE_MRHDR               0      0
    USEATE_PROBITS           1C4      1
    USEATE_VEBALERT          110      4
    USEATE_VEBHDWAI          124      4
    USEATE_VEBSVSCT          118      4
    USEATE_VEBTPIAI          11C      4
    USEATE_VEBTVSCT          114      4
    USEATE_VEBVIRAI          120      4
    USEATE_VMACPNC           218      1
    USEATE_VMACPVC           219      7
    USEATE_VMAPRCAL          1C4           80
    USEATE_VMATTIME_PRO      190      8
    USEATE_VMATTMP_PRO       1A8      8
    USEATE_VMATTMS_PRO       1B8      8
    USEATE_VMAVTIME_PRO      198      8
    USEATE_VMAVTMP_PRO       1A0      8
    USEATE_VMAVTMS_PRO       1B0      8
    USEATE_VMDABSSH           D4      4
    USEATE_VMDACTNO           E0      8
    USEATE_VMDAFSUP          13E           80
    USEATE_VMDBLKCT           C0      4
    USEATE_VMDCFGEM          13D      1
    USEATE_VMDCPUAD           1C      2
    USEATE_VMDCPUAF          13D           40
    USEATE_VMDCPUCH          210      4
    USEATE_VMDCTFLT           50      4
    USEATE_VMDCTISO           CC      4
    USEATE_VMDCTPVG          108      4
    USEATE_VMDCTPVL           44      4
    USEATE_VMDCTPVLA         128      8
    USEATE_VMDCTPVR           40      4
    USEATE_VMDCTPWT           64      4
    USEATE_VMDCTSHL          130      4
    USEATE_VMDCTSHLA         134      8
    USEATE_VMDCTSPR           70      4
    USEATE_VMDCTSPW           74      4
    USEATE_VMDGRPN            E8      8
    USEATE_VMDISEVM           94      4
    USEATE_VMDISTVM           98      4
    USEATE_VMDISUVM           9C      4
    USEATE_VMDLIMTH           BE           02
    USEATE_VMDMAACT           BC           01
    USEATE_VMDMASST           BC           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_VMDPUST           13E      1
    USEATE_VMDPUTYP          13C      1
    USEATE_VMDQDSPU           BC           40
    USEATE_VMDRELSH           D0      4
    USEATE_VMDRUNCP          214      4
    USEATE_VMDSSIZE           D8      4
    USEATE_VMDSTOP            BE           40
    USEATE_VMDSTOPD           BE           20
    USEATE_VMDSTYPE           BD      1
    USEATE_VMDTTIME           20      8
    USEATE_VMDTTIME_MT1      160      8
    USEATE_VMDTTMP           148      8
    USEATE_VMDTTMP_MT1       178      8
    USEATE_VMDTTMS           158      8
    USEATE_VMDTTMS_MT1       188      8
    USEATE_VMDUSER            14      8
    USEATE_VMDVCSCT           7C      4
    USEATE_VMDVDISK           F8      4
    USEATE_VMDVDSCT           80      4
    USEATE_VMDVOSCT           8C      4
    USEATE_VMDVSEVM           A0      4
    USEATE_VMDVSTVM           A4      4
    USEATE_VMDVSUVM           A8      4
    USEATE_VMDVTIME           28      8
    USEATE_VMDVTIME_MT1      168      8
    USEATE_VMDVTMP           140      8
    USEATE_VMDVTMP_MT1       170      8
    USEATE_VMDVTMS           150      8
    USEATE_VMDVTMS_MT1       180      8
    USEATE_VMDVTSCT           88      4
    USEATE_VMDVUSCT           84      4
    USEATE_VMDVVECT           BF           80
    USEATE_VMDWSSPR           48      4
    USEATE_VMDX98CT           AC      4
    USEATE_VMUDSPETM         1E8      8
    USEATE_VMUDSPTSQ         1F0     16
    USEATE_VMUDWTETM         1CC      8
    USEATE_VMUDWTTSQ         1D4     16
    USEATE_VMUTTIMSQ         200     16

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

    Last updated on 18 February 2021 at 15:23:27.

    Copyright IBM Corporation, 1990, 2021