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

MRUSEACT

Prolog
Control Block Contents
Cross Reference

MRUSEACT Prolog

 DSECT NAME - USEACT
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRUSEACT
 DESCRIPTIVE NAME - Monitor Sample Record
                    Domain 4 - User Domain
                    Record 3 - User Activity Data
 DESCRIPTION - User activity data.  Generated for each virtual
               processor in a virtual configuration.
 NOTES -
      - For additional information about the format and meaning of
        the MRUSEACT_VMUTOPDA entries in this record, knowledge of
        system topology as reported by the STSI instruction is
        necessary.  For a description of system topology, refer to
        the following book:
          - Principles of Operation for the layout of the
            variable length STSI 15.1.x output which is
            documented in Chapter 10 under "STORE SYSTEM
            INFORMATION".  Anyone looking at the STSI data
            in this record should read about the format of
            the data and the CPU Topology Overview contained
            there. (SA22-7832-08)
      - 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.
 


MRUSEACT Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   864+ USEACT                 Start of monitor record
   0   0  Character     0  USEACT_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  USEACT_VMDUSER         Userid
  28  1C  Unsigned      2  USEACT_VMDCPUAD        Processor ID/CPU address of
                                                  virtual processor
  30  1E  Bitstring     1  USEACT_VMDMODE         Guest machine mode. This is
                                                  as set for internal use by
                                                  CP. See USEACT_CALMODE for
                                                  the mode 'calculated' at.
  31  1F  Bitstring     1  USEACT_CALMODE         Architectural mode of the
                                                  virtual machine
          1... ....        *
          .1.. ....        USEACT_CALMESA          ESA architecture
          ..1. ....        USEACT_CALMXA           XA architecture
          ...1 ....        USEACT_CALM370          370 architecture
          .... 1...        USEACT_CALMXC           XC architecture
          .... .1..        USEACT_CALMESAM         ESA mode machine has
                                                  entered z/Arch mode.
          .... ..1.        USEACT_CALVARCH         Guest's virtual
                                                  architecture is not the same
                                                  as the system's real
                                                  architecture
          .... ...1        *
  32  20  Bitstring     1  USEACT_VMDSLIST        Scheduling list that the
                                                  user is in: X'37' = Dispatch
                                                  List. X'21' = Eligible List.
                                                  X'0B' = Dormant List. X'00' =
                                                  user is not in any list.
  33  21  Unsigned      1  USEACT_VMDELIST        Class number (0,1,2,or 3)
                                                  of the scheduling list the
                                                  user is in
  34  22  Bitstring     1  USEACT_CALFLAG1        Flag byte
          1... ....        USEACT_CALBASE          If on, this is the base
                                                  VMDBK. VMDBASE
          .1.. ....        USEACT_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. ....        USEACT_CALDIAL          This user is a dialed user
          ...1 ....        USEACT_CALSNA           This user is connected
                                                  through System Network
                                                  Architecture (SNA)
          .... 1...        USEACT_VMDNOINS         User is prevented from
                                                  inserting any tracks into the
                                                  minidisk cache. (set when SET
                                                  MDC INS OFF command is
                                                  issued)
          .... .1..        USEACT_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.        USEACT_VMDMASST         Collaborative Memory
                                                  Management assist enabled.
          .... ...1        USEACT_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
                                                  (USEACT_VMDMAACT=1) and
                                                  available to this guest until
                                                  the next virtual machine
                                                  reset or IPL.
  35  23  Bitstring     1  USEACT_VMDSTYPE        Storage type this virtual
                                                  machine resides in. X'00' =>
                                                  V=V. X'80' => Reserved and no
                                                  longer available. X'40' =>
                                                  V=F.
  36  24  Character     8  USEACT_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.
  44  2C  Character     8  USEACT_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 elapsed time in TOD clock
                                                  units.
  52  34  Character     8  *                      Reserved for IBM use
                                                  Previous field is no longer
                                                  meaningful. (USEACT_VMDVFVTM)
  60  3C  Character     8  *                      Reserved for IBM use
                                                  Previous field is no longer
                                                  meaningful. (USEACT_VMDVFOTM)
  68  44  Unsigned      4  USEACT_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
                                                  USEACT_VMDCTPVG from
                                                  USEACT_VMDCTPVR.
  72  48  Unsigned      4  USEACT_VMDCTPVL        Cardinal count of locked
                                                  pages in private address
                                                  spaces <2G belonging to this
                                                  user. See USEACT_VMDCTPVLA
                                                  for the >2G value.
  76  4C  Unsigned      4  USEACT_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.
  80  50  Unsigned      4  USEACT_VMDCTXBK        Number of expanded storage
                                                  blocks allocated to a virtual
                                                  machine by CP for paging.
  84  54  Unsigned      4  USEACT_CALXSTOR        Size, in megabytes, of
                                                  expanded storage attached to
                                                  the user. If zero, no
                                                  expanded storage is attached.
                                                  VMDXSTOR
  88  58  Unsigned      4  USEACT_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.
  92  5C  Unsigned      4  *                      Reserved for IBM use
                                                  Previous field is no longer
                                                  meaningful. (USEACT_VMDCTVFL)
  96  60  Unsigned      4  *                      Reserved for IBM use - was
                                                  USEACT_VMDFLREO
 100  64  Unsigned      4  *                      Reserved for IBM use - was
                                                  USEACT_VMDCTORF
 104  68  Unsigned      4  USEACT_CALCTPGS        Cardinal count of
                                                  non-preferred paging slots
                                                  for private address spaces
                                                  belonging to this user.
 108  6C  Unsigned      4  *                      Reserved for IBM use
 112  70  Unsigned      4  USEACT_VMDCTPWT        Count of outstanding paging
                                                  and spooling I/O's for this
                                                  user
 116  74  Unsigned      4  USEACT_CALCPPGR        Cumulative count of pages
                                                  read from DASD to main
                                                  storage for this user's
                                                  address spaces while they
                                                  were private.
 120  78  Unsigned      4  USEACT_CALCPPGW        Cumulative count of pages
                                                  written from main storage to
                                                  DASD for this user's address
                                                  spaces while they were
                                                  private.
 124  7C  Unsigned      4  USEACT_VMDCTSPR        Number of times I/O was
                                                  issued for a spool read
                                                  request
 128  80  Unsigned      4  USEACT_VMDCTSPW        Number of times I/O was
                                                  issued for a spool write
                                                  request
 132  84  Unsigned      4  USEACT_VMDPGSPL        Number of pages spooled for
                                                  this user. This includes the
                                                  pages spooled for the virtual
                                                  reader, printer, punch,
                                                  console, dump, and trace
                                                  files.
 136  88  Unsigned      4  USEACT_VMDVCSCT        Count of start requests to
                                                  the virtual machine console
 140  8C  Unsigned      4  USEACT_VMDVDSCT        Cumulative count of virtual
                                                  I/O requests the virtual
                                                  machine has issued to DASD
                                                  devices
 144  90  Unsigned      4  USEACT_VMDVUSCT        Count of Start requests to
                                                  virtual Unit Record devices
 148  94  Unsigned      4  USEACT_VMDVTSCT        Count of Start requests to
                                                  virtual channel-to-channel
                                                  adapters
 152  98  Unsigned      4  USEACT_VMDVOSCT        Count of Start requests to
                                                  devices other than console,
                                                  DASDs, CTCAs, and unit
                                                  records. (see
                                                  USEACT_VMDVCSCT,
                                                  USEACT_VMDVDSCT,
                                                  USEACT_VMDVUSCT, and
                                                  USEACT_VMDVTSCT)
 156  9C  Unsigned      4  USEACT_CALCPPST        Cumulative count of pages
                                                  reclaimed from this user's
                                                  address spaces while they
                                                  were private.
 160  A0  Unsigned      4  USEACT_VMDISEVM        Number of times IUCV data
                                                  was successfully transferred
                                                  by 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.
 164  A4  Unsigned      4  USEACT_VMDISTVM        Number of times IUCV 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.
 168  A8  Unsigned      4  USEACT_VMDISUVM        Number of times IUCV data
                                                  was NOT successfully
                                                  transferred by 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.
 172  AC  Unsigned      4  USEACT_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.)
 176  B0  Unsigned      4  USEACT_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.)
 180  B4  Unsigned      4  USEACT_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.)
 184  B8  Signed        4  USEACT_CALIUCVS        Cardinal count of messages
                                                  on the IUCV SEND queue. The
                                                  SEND queue consists of
                                                  messages sent to this user
                                                  either by another user or by
                                                  a CP System Service. Note: A
                                                  zero value may mean that the
                                                  data could not be obtained as
                                                  well as that there weren't
                                                  any messages.
 188  BC  Signed        4  USEACT_CALIUCVR        Cardinal count of messages
                                                  on the IUCV RECEIVE queue
                                                  which consists of messages
                                                  this user has received from
                                                  other users or CP System
                                                  Services, but has not yet
                                                  replied to. Note: A zero
                                                  value may mean that the data
                                                  could not be obtained as well
                                                  as that there were not any
                                                  messages.
 192  C0  Signed        4  USEACT_CALIUCVY        Cardinal count of messages
                                                  on the IUCV REPLY queue which
                                                  consists of replies to
                                                  messages this user sent
                                                  either to other users or to
                                                  CP System Services. Note: A
                                                  zero value may mean that the
                                                  data could not be obtained as
                                                  well as that there were not
                                                  any messages.
 196  C4  Signed        4  USEACT_CALVMCF         Cardinal count of messages
                                                  on the VMCF queue. Note: A
                                                  zero value may mean that the
                                                  data could not be obtained as
                                                  well as that there were not
                                                  any messages.
 200  C8  Unsigned      4  USEACT_VMDX98CT        Cumulative number of times
                                                  Diagnose X'98' was issued by
                                                  this virtual machine
 204  CC  Unsigned      4  USEACT_CALCPMIG        Cumulative count of pages
                                                  migrated by CP from expanded
                                                  storage to DASD for this
                                                  user's address spaces while
                                                  they were private.
 208  D0  Unsigned      4  USEACT_CALCPXWT        Cumulative count of pages
                                                  written from main storage to
                                                  expanded storage for this
                                                  user's address spaces while
                                                  they were private.
 212  D4  Unsigned      4  USEACT_CALCPXRD        Cumulative count of pages
                                                  read from expanded storage to
                                                  main storage for this user's
                                                  address spaces while they
                                                  were private.
 216  D8  Unsigned      2  USEACT_VMDASMCT        Cardinal number of non-base
                                                  address spaces owned by this
                                                  user.
 218  DA  Bitstring     1  USEACT_CALSHARF        Set Share flags
          1... ....        USEACT_VMDMXSHA         Max share is Absolute if
                                                  ON. Max share is Relative if
                                                  OFF.
          .1.. ....        USEACT_VMDSTOP          This virtual CPU is in
                                                  soft stop
          ..1. ....        USEACT_VMDSTOPD         This virtual CPU is
                                                  stopped
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        USEACT_VMDLIMTH         Max Share is Limithard if
                                                  ON. Max Share is Limitsoft if
                                                  OFF.
          .... ...1        *
 219  DB  Bitstring     1  USEACT_LCLFLAGS        General flags
          1... ....        USEACT_RELO1            Indicates this is first
                                                  record since a live guest
                                                  relocation occurred
          .1.. ....        USEACT_VMDREOFL         Reorder is always off
          ..1. ....        USEACT_VMDVVECT         Vector regs in use
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 220  DC  Unsigned      4  USEACT_VMDBLKCT        Count of SSCH's issued by
                                                  BLOCKIO system service
                                                  (includes both read and write
                                                  requests)
 224  E0  Unsigned      4  USEACT_VMDMDCIA        Count of SSCH's avoided due
                                                  to Minidisk Cache read hit
 228  E4  Unsigned      4  *                      Reserved for IBM use
                                                  Previous field is no longer
                                                  meaningful. (USEACT_VMDCOPCT)
 232  E8  Unsigned      4  USEACT_VMDCTISO        Number of times ISOLATE
                                                  occurred for spaces owned by
                                                  this virtual system. Valid
                                                  only in base VMDBK
 236  EC  Unsigned      4  USEACT_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.
                                                  Note that if the
                                                  USEACT_VMDSTOP bit is ON,
                                                  this virtual CPU share value
                                                  should not be included when
                                                  calculating the user's share
                                                  value.
 240  F0  Unsigned      4  USEACT_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.
                                                  Note that if the
                                                  USEACT_VMDSTOP bit is ON,
                                                  this virtual CPU share value
                                                  should not be included when
                                                  calculating the user's share
                                                  value.
 244  F4  Unsigned      4  USEACT_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
                                                  USEACT_ASCDEFSZ
 248  F8  Unsigned      4  USEACT_VMDMXRVP        Number of pages reserved
                                                  for the user
 252  FC  Character     8  USEACT_VMDACTNO        User accounting number
 260 104  Character     8  USEACT_VMDGRPN         RACF ACI group name
 268 10C  Character     8  USEACT_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.
 276 114  Unsigned      4  USEACT_VMDVDISK        Count of virtual I/Os to a
                                                  virtual disk in storage.
 280 118  Unsigned      4  USEACT_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 USEACT_VMDMXSHA to
                                                  determine if Max share is
                                                  absolute or relative. Note
                                                  that if the USEACT_VMDSTOP
                                                  bit is ON, this virtual CPU
                                                  share value should not be
                                                  included when calculating the
                                                  user's share value.
 284 11C  Unsigned      4  USEACT_VMDTHRCT        Total number of times this
                                                  user was delayed doing I/O to
                                                  a throttled device
 288 120  Unsigned      2  USEACT_IUCTOTCN        Total number of connections
                                                  for IUCV. Valid only for base
                                                  VMDKBK
 290 122  Unsigned      2  USEACT_IUCMXCN         Maximum number of
                                                  connections from the MAXCONN
                                                  directory option or the
                                                  system default.
 292 124  Unsigned      4  USEACT_VMDCTPVG        Count of private address
                                                  space resident pages in DPA
                                                  owned by this virtual machine
                                                  which are >= 2G. Valid only
                                                  in base VMDBK.
 296 128  Character     8  USEACT_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').
 296 128  Character     4  USEACT_CALDEFHI        high four bytes
 300 12C  Character     4  USEACT_CALDEFLO        low four bytes
 304 130  Unsigned      4  USEACT_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.
 308 134  Bitstring     1  USEACT_IPQF0           I/O priority flag byte. See
                                                  CP SET IOPRIORITY command for
                                                  description of absolute and
                                                  relative ranges. Valid only
                                                  in base VMDBK.
          1... ....        USEACT_IPQRELRG         Using a relative range.
                                                  Valid only in base VMDBK.
          .1.. ....        USEACT_IPQABSRG         Using an absolute range.
                                                  Valid only in base VMDBK.
          ..1. ....        USEACT_IPQGSSC          Guest requested I/O
                                                  subsystem details which
                                                  includes I/O priority
                                                  facility status. This usually
                                                  indicates that the guest is
                                                  I/O priority aware. Valid
                                                  only in base VMDBK.
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 309 135  Unsigned      1  USEACT_IPQRQLO         I/O priority requested
                                                  range low value. See CP SET
                                                  IOPRIORITY command for
                                                  description of requested and
                                                  effective I/O priority
                                                  values. Valid only in base
                                                  VMDBK.
 310 136  Unsigned      1  USEACT_IPQRQHI         I/O priority requested
                                                  range high value. Valid only
                                                  in base VMDBK.
 311 137  Unsigned      1  USEACT_IPQEFLO         I/O priority effective
                                                  range low value. Valid only
                                                  in base VMDBK.
 312 138  Unsigned      1  USEACT_IPQEFHI         I/O priority effective
                                                  range high value. Valid only
                                                  in base VMDBK.
 313 139  Unsigned      1  USEACT_CALMNEST        When configuration-topology
                                                  facility is installed, this is
                                                  the selector 2 (x) value used
                                                  by CP on STSI 15.1.x to obtain
                                                  CPU topology information. When
                                                  the configuration-topology
                                                  facility is not installed,
                                                  this contains a value of 1.
 
                                                  This value is used to determine
                                                  the number of valid entries in
                                                  the USEACT_VMUPLTL,
                                                      USEACT_VMUVMTL, and
                                                      USEACT_VMUSTLTL arrays.
 314 13A  Character     2  *                      Reserved and available for
                                                  IBM use.
 316 13C  Unsigned      4  USEACT_IPQDSKIP        Count of times that a DASD
                                                  I/O request was
                                                  out-prioritized by another
                                                  virtual machine's I/O. Valid
                                                  only in base VMDBK.
 320 140  Unsigned      4  USEACT_VEBALERT        Number of alert
                                                  interruptions Collected only
                                                  for base VMDBK.
 324 144  Unsigned      4  USEACT_VEBTVSCT        Number of interceptions for
                                                  guest TVS instructions
                                                  Collected only for base
                                                  VMDBK.
 328 148  Unsigned      4  USEACT_VEBSVSCT        Number of interceptions for
                                                  guest SVS instructions
                                                  Collected only for base
                                                  VMDBK.
 332 14C  Unsigned      4  USEACT_VEBTPIAI        Number of adapter
                                                  interruptions delivered via
                                                  guest TPI Collected only for
                                                  base VMDBK.
 336 150  Unsigned      4  USEACT_VEBVIRAI        Number of adapter
                                                  interruptions stacked for
                                                  guest by CP Collected only
                                                  for base VMDBK.
 340 154  Unsigned      4  USEACT_VEBHDWAI        Number of adapter
                                                  interruptions delivered to
                                                  guest inside SIE Collected
                                                  only for base VMDBK.
 344 158  Character     8  USEACT_VMDCTPVLA       Cardinal count of locked
                                                  pages in private address
                                                  spaces >2G belonging to this
                                                  user. See USEACT_VMDCTPVL for
                                                  the <2G value.
 352 160  Unsigned      4  USEACT_VMDCTSHL        Count of shared address
                                                  space resident pages <2G.
                                                  Valid only in the SYSTEM
                                                  VMDBK.
 356 164  Character     8  USEACT_VMDCTSHLA       Count of shared address
                                                  space resident pages >2G.
                                                  Valid only in the SYSTEM
                                                  VMDBK.
 364 16C  Unsigned      4  USEACT_VMDUFOLKCT      Total count of times UFO
                                                  list lock has gone into the
                                                  formal spin routine when
                                                  attempting to get the lock in
                                                  exclusive mode
 368 170  Character     8  USEACT_VMDUFOLKTM      Total elapsed spin time on
                                                  UFO list lock when attempting
                                                  to get it in exclusive mode,
                                                  starting at zero and counting
                                                  up
 376 178  Unsigned      4  *                      Reserved for IBM use - was
                                                  USEACT_VMDTMORD
 380 17C  Unsigned      4  USEACT_VMDPBKCT        Count of PGMBKs that are
                                                  currently on the PGMBK List
 384 180  Unsigned      4  *                      Reserved for IBM use - was
                                                  USEACT_VMDCRPGM
 388 184  Unsigned      4  *                      Reserved for IBM use - was
                                                  USEACT_VMDCUPGM
                                                  last reorder
 392 188  Unsigned      1  USEACT_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)
 393 189  Bitstring     1  USEACT_VMDCFGEM        Virtual configuration
                                                  indicators. Valid in base
                                                  VMDBK only
          1... ....        *
          .1.. ....        USEACT_VMDCPUAF         User requested CPU
                                                  Affinity
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 394 18A  Bitstring     1  USEACT_VMDPUST         CPU Status flag
          1... ....        USEACT_VMDAFSUP         CPU Affinity suppressed
          .1.. ....        *
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 395 18B  Character     1  *                      Reserved for IBM use
 396 18C  Character     8  USEACT_VMDVTMP         Total raw virtual time for
                                                  user on primary processor
 404 194  Character     8  USEACT_VMDTTMP         Total raw virtual and
                                                  simulation time for the user
                                                  on primary processor
 412 19C  Character     8  USEACT_VMDVTMS         Total raw virtual time for
                                                  user on secondary processor
 420 1A4  Character     8  USEACT_VMDTTMS         Total raw virtual and
                                                  simulation time for the user
                                                  on secondary processor
 428 1AC  Unsigned      4  USEACT_VMDCACHN        Number of minidisk cache
                                                  inserts
 432 1B0  Unsigned      4  USEACT_VMDCTSTA        Count of times this virtual
                                                  CPU has been started by one
                                                  of the following methods:
                                                  -SIGP START -SIGP RESTART
                                                  -Begin Command
 436 1B4  Unsigned      4  USEACT_VMDCTSTO        Count of times this virtual
                                                  CPU has been stopped by one
                                                  of the following methods:
                                                  -SIGP STOP -SIGP STOP AND
                                                  STORE STATUS -SIGP INITIAL
                                                  CPU RESET -SIGP CPU RESET
                                                  -STOP Command
 440 1B8  Unsigned      4  USEACT_VMDLKTOT        Cumulative count of times
                                                  this user has issued the LINK
                                                  command. Valid only in base
                                                  VMDBK.
 444 1BC  Unsigned      4  USEACT_VMDLKPLX        Cumulative count of times
                                                  this user has issued the LINK
                                                  command and consulted with
                                                  the SSI. Valid only in base
                                                  VMDBK.
 448 1C0  Character     8  USEACT_VMDLKTOD        Total virtual time for LINK
                                                  commands to consult with the
                                                  SSI. Valid only in base
                                                  VMDBK.
 456 1C8  Unsigned      4  USEACT_VMDDTTOT        Cumulative count of times
                                                  this user has issued the
                                                  DETACH command. Valid only in
                                                  base VMDBK.
 460 1CC  Unsigned      4  USEACT_VMDDTPLX        Cumulative count of times
                                                  this user has issued the
                                                  DETACH command and consulted
                                                  with the SSI. Valid only in
                                                  base VMDBK.
 464 1D0  Character     8  USEACT_VMDDTTOD        Total virtual time for
                                                  DETACH commands to consult
                                                  with the SSI. Valid only in
                                                  base VMDBK.
 472 1D8  Unsigned      4  USEACT_VMDWKTOT        Cumulative count of times
                                                  this user has used WRKALLEG
                                                  (SET WRKALLEG, DASDOPT
                                                  WRKALLEG or MINIOPT
                                                  WRKALLEG). Valid only in base
                                                  VMDBK.
 476 1DC  Unsigned      4  USEACT_VMDWKPLX        Cumulative count of times
                                                  this user has used WRKALLEG
                                                  (SET WRKALLEG, DASDOPT
                                                  WRKALLEG or MINIOPT WRKALLEG)
                                                  and consulted with the SSI.
                                                  Valid only in base VMDBK.
 480 1E0  Character     8  USEACT_VMDWKTOD        Total virtual time for
                                                  WRKALLEG use to consult with
                                                  the SSI. Valid only in base
                                                  VMDBK.
 488 1E8  Character     8  USEACT_VMDRLLST        Time stamp of last
                                                  relocation of this user. Only
                                                  valid if USEACT_RELO1 is ON.
 496 1F0  Character     8  USEACT_RDMNAME         Name of the guest's
                                                  relocation domain
 504 1F8  Bitstring     4  USEACT_RDMMMASK        Relocation domain's member
                                                  mask - bit mask that
                                                  indicates the slots of SSI
                                                  members that are included in
                                                  this guest's domain. (Bit 0
                                                  means SSI slot 1)
 508 1FC  Unsigned      4  USEACT_VMUNRBAL        Cumulative count of the
                                                  number of configuration
                                                  rebalances.
                                                  Valid only in base VMDBK.
 512 200  Unsigned      1  USEACT_VMUTOPNE        Number of elements that fit
                                                  in the USEACT_VMUTOPDA array.
 513 201  Unsigned      1  USEACT_VMUTOPNS        The size in bytes of one
                                                  element of the USEACT_VMUTOPDA
                                                  array.
 514 202  Unsigned      1  USEACT_VMUTOPDX        Zero-based index into the
                                                  circular array called
                                                  USEACT_VMUTOPDA. This field
                                                  indicates which element is the
                                                  most recently updated of
                                                  the ten.  A value of zero
                                                  indicates the first array
                                                  element is the latest.  A
                                                  value of one indicates the
                                                  second element is the
                                                  latest and so on.
 515 203  Unsigned      1  USEACT_MAXTOPO         Maximum number of topology
                                                  levels currently architected.
                                                  The value should be used for
                                                  array size calculation for the
                                                  following fields:
                                                    USEACT_VMUPLTL,
                                                    USEACT_VMUVMTL,
                                                    USEACT_VMUSTLTL.
 516 204  Unsigned      2  USEACT_OFFPLTL         Offset within this record to
                                                  the USEACT_VMUPLTL array.
 518 206  Unsigned      2  USEACT_OFFVMTL         Offset within this record to
                                                  the USEACT_VMUVMTL array.
 520 208  Unsigned      2  USEACT_OFFSTLTL        Offset within this record to
                                                  the USEACT_VMUSTLTL array.
 522 20A  Unsigned      2  USEACT_OFFTOPDA        Offset within this record to
                                                  the USEACT_VMUTOPDA array.
 524 20C  Unsigned      4  USEACT_VMUREBAL        The value of RCCREBAL (the
                                                  count of the number of times
                                                  a rebalance was done on this
                                                  system) at the time of the
                                                  most recent rebalance.
 528 210  Unsigned      2  USEACT_VMDSTLFC        Steal weight factor. Used to
                                                  determine the level of aggressiveness
                                                  in reclaiming frames from this
                                                  user.
                                                  Valid only for the base VMDBK.
 530 212  Unsigned      2  USEACT_VMDSTFHW        Steal weight factor high wat
                                                  mark.
                                                  Valid only for the base VMDBK.
 532 214  Unsigned      4  USEACT_VMDUFACTC       The length (in frames)
                                                  of the active section of the UFO.
                                                  Valid only for the base VMDBK.
 536 218  Unsigned      4  USEACT_VMDUFIBRC       The length (in frames)
                                                  of the IBR section of the UFO.
                                                  Valid only for the base VMDBK.
 540 21C  Unsigned      4  USEACT_CALCTINS        Cardinal count of private
                                                  instantiated pages.
                                                  Valid only for the base VMDBK.
 544 220  Unsigned      4  USEACT_CALCTIBRB2G     Cardinal count of private
                                                  IBR pages on the UFO that are
                                                  backed by frames < 2G.
                                                  Valid only for the base VMDBK.
 548 224  Unsigned      4  USEACT_CALCTIBRA2G     Cardinal count of private
                                                  IBR pages on the UFO that are
                                                  backed by frames > 2G.
                                                  Valid only for the base VMDBK.
 552 228  Unsigned      4  USEACT_CALCTAGLB2G     Cardinal count of private
                                                  IBR pages on the global aging
                                                  list that are backed by frames
                                                  < 2G.
                                                  Valid only for the base VMDBK.
 556 22C  Unsigned      4  USEACT_CALCTAGLA2G     Cardinal count of private
                                                  IBR pages on the global aging
                                                  list that are backed by frames
                                                  > 2G.
                                                  Valid only for the base VMDBK.
 560 230  Unsigned      4  USEACT_CALCTRABISB2G   Cardinal count of priva
                                                  non-faulted pages read in by a
                                                  block read, made IBR, currently
                                                  on the UFO or the global aging
                                                  list, and backed by frames < 2G.
                                                  Valid only for the base VMDBK.
 564 234  Unsigned      4  USEACT_CALCTRABISA2G   Cardinal count of priva
                                                  non-faulted pages read in by a
                                                  block read, made IBR, currently
                                                  on the UFO or the global aging
                                                  list, and backed by frames > 2G.
                                                  Valid only for the base VMDBK.
 568 238  Unsigned      4  USEACT_CALCPINT        Cumulative count of private
                                                  instantiated pages.
                                                  Valid only for the base VMDBK.
 572 23C  Unsigned      4  USEACT_CALCPREL        Cumulative count of private
                                                  pages whose frames were reclaimed
                                                  without preserving page content
                                                  because of the guest page state
                                                  (that is, the collaborative
                                                  memory management state or because
                                                  the contents was released by the
                                                  guest via DIAG x10 or Diag x214)
                                                  Valid only for the base VMDBK.
 576 240  Unsigned      4  USEACT_CALCPINV        Cumulative count of private
                                                  pages made IBR.
                                                  Valid only for the base VMDBK.
 580 244  Unsigned      4  USEACT_CALCPPFI        Cumulative count of private
                                                  IBR pages revalidated while on
                                                  the UFO.
                                                  Valid only for the base VMDBK.
 584 248  Unsigned      4  USEACT_CALCPPFA        Cumulative count of private
                                                  IBR pages revalidated while on
                                                  the global aging list.
                                                  Valid only for the base VMDBK.
 588 24C  Unsigned      4  USEACT_CALCPFRY        Cumulative count of private
                                                  IBR pages on the global aging
                                                  list that were already backed on
                                                  auxiliary before the frames
                                                  needed to be reclaimed.
                                                  Valid only for the base VMDBK.
 592 250  Unsigned      4  USEACT_CALCPFNR        Cumulative count of private
                                                  IBR pages on the UFO list that
                                                  were written to XSTORE or
                                                  auxiliary storage immediately
                                                  before the frames were reclaimed.
                                                  Valid only for the base VMDBK.
 596 254  Unsigned      4  USEACT_CALCPXRL        Cumulative count of XSTORE
                                                  blocks released by migration
                                                  when the private page contents
                                                  was already on auxiliary storage.
                                                  Valid only for the base VMDBK.
 600 258  Unsigned      4  USEACT_VMDDSRSV        Cumulative count of times
                                                  demand scan could not move any
                                                  frames from the UFO to the
                                                  global aging list because it
                                                  would violate the user's SET
                                                  RESERVED setting.
                                                  Valid only for the base VMDBK.
 604 25C  Unsigned      4  USEACT_VMDWASTE        Cumulative count of times
                                                  page faults occurred for private
                                                  pages on the global aging list
                                                  that were already written to
                                                  auxiliary storage.
                                                  Valid only for the base VMDBK.
 608 260  Unsigned      4  USEACT_CALCTXBK        Cardinal count of expanded
                                                  storage paging blocks for
                                                  private address spaces
                                                  belonging to this user.
                                                  Valid only for the base VMDBK.
 612 264  Character     8  USEACT_LIMPOOL         CPU pool name that the user
                                                  is assigned to.
 620 26C  Character     8  USEACT_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.
 628 274  Character     8  USEACT_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.
 636 27C  Character     8  USEACT_VMDVTMP_MT1     MT-1 Equivalent virtual
                                                  time for the user on primary
                                                  processor.
 644 284  Character     8  USEACT_VMDTTMP_MT1     MT-1 Equivalent total
                                                  virtual and simulation time for
                                                  the user on primary processor.
 652 28C  Character     8  USEACT_VMDVTMS_MT1     MT-1 Equivalent total
                                                  virtual time for the user on
                                                  secondary processor.
 660 294  Character     8  USEACT_VMDTTMS_MT1     MT-1 Equivalent total
                                                  virtual and simulation time for
                                                  the user on secondary processor.
 668 29C  Character     8  USEACT_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.
 676 2A4  Character     8  USEACT_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.
 684 2AC  Character     8  USEACT_VMAVTMP_PRO     Total Prorated Core virtual
                                                  time for user on primary processor.
                                                  See the notes above.
 692 2B4  Character     8  USEACT_VMATTMP_PRO     Total Prorated Core virtual
                                                  and simulation time for the user
                                                  on primary processor.
                                                  See the notes above.
 700 2BC  Character     8  USEACT_VMAVTMS_PRO     Total Prorated Core virtual
                                                  time for user on secondary processor.
                                                  See the notes above.
 708 2C4  Character     8  USEACT_VMATTMS_PRO     Total Prorated Core virtual
                                                  and simulation time for the user
                                                  on secondary processor.
                                                  See the notes above.
 716 2CC  Unsigned      4  *                      Reserved for IBM use
 720 2D0  Bitstring     1  USEACT_PROBITS         Prorated Core Time bits needed
                                                  to understand those fields.
          1... ....        USEACT_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        *
 721 2D1  Unsigned      1  *                      Reserved for IBM use
 722 2D2  Unsigned      2  *                      Reserved for IBM use

HOST SHARE IPTE INTERLOCK STATISTICS
 
There are two sets of IPTE Interlock statistics,
each of which is stored as a self-consistent set.
 
The first set is a quintuple relating to Interlock wait and
acquisition. It comprises:
 
   CAL_VMAIPTEI, VMAIIA, VMAIIADD, VMAIIWTM and VMAIIWTSSQ.
 
Embedded in this set is a triple comprising:
 
   CAL_VMAIPTEI (total IPTE Interlock acquisitions using methods
                 1 or 2)
 
   VMAIIA (IPTE interlock acquisitions using method 2)
 
   VMAIIWTM (accumulated time waiting for the interlock)
 
   VMAIIWTSSQ (accumulated sum of squares of time waiting for the
               interlock)
 
These three values are used to calculate the mean wait time per interlock
request and the variance of that wait time.
 
The remaining metric, VMAIIADD, provides an accumulated count of the
number of times an interlock was obtained while already held. It may
be used with the number of Interlock acquisitions to calculate the
mean proportion of overlapping Interlock host shares provided VMAIIA
and Interlock acquisitions are summed over all VMDBKs of the
virtual configuration.  See note about calculating mean and variance
of hold time below.
 
The second set is a triple relating to Interlock hold time. It comprises:
 
   CAL_VMAIINHLD, VMAIIHLD and VMAIIHDSSQ.
 
These three values are used to calculate the mean and variance of the
intervals over which the IPTE Interlock was continuously held.
 
Because an IPTE Interlock continuous-hold interval may begin on one
virtual CPU and terminate on another then the three values should be
summed over all VMDBKs of the virtual configuration before calculating
mean and variance.
 
If during the course of calculating any one of the metrics, within either
of the two tuples, we carry out of the high-order bit position then the
entire tuple affected is reset to zero. The only time any metric within
a tuple is observed not to increase monotonically per component between
successive sample records is where such an event has occurred. In all
cases the recorded triple is self-consistent. It may be used as the
base for a delta to the next sample provided each value in that next
sample is greater than or equal to the corresponding value in this
sample.

Offsets Dec Hex Type Len Name (Dim) Description 724 2D4 Unsigned 4 USEACT_CAL_VMAIPTEI Total count of IPTE Interlock acquisitions using methods 1 and 2. 728 2D8 Unsigned 4 USEACT_VMAIIA Count of IPTE Interlock acquisitions using method 2. 732 2DC Unsigned 4 USEACT_VMAIIADD Count of times IPTE Interlock was acquired as an additional host share. 736 2E0 Character 8 USEACT_VMAIIWTM Cumulative amount of time spent waiting for IPTE Interlock acquisition. 744 2E8 Character 16 USEACT_VMAIIWTSSQ Sum of squared time spent waiting for IPTE Interlock acquisition. 760 2F8 Unsigned 4 USEACT_CAL_VMAIINHLD Count of intervals over which one or more host shares of and IPTE Interlock were continuously held. 764 2FC Character 8 USEACT_VMAIIHLD Cumulative amount of time over which one or more of host shares of an IPTE Interlock were continuously held. 772 304 Character 16 USEACT_VMAIIHDSSQ Sum of squared time over which one or more of the host shares of an IPTE Interlock were continuously held.
The following fields are statistics gathered by the dispatcher about how
long a VMDBK has been dispatched and how long the VMDBK had to wait to be
dispatched once it was ready to consume CPU time. The deltas of these
fields between monitor intervals can be used to determine average
dispatch time and average wait times, and using the sum of squares, the
standard deviations of those time samples.

Offsets Dec Hex Type Len Name (Dim) Description 788 314 Unsigned 4 USEACT_CALDWTCT Count of the number of times this VMDBK became ready to be dispatched (unsigned fullword). This is calculated using VMUDWTCT. 792 318 Character 8 USEACT_VMUDWTETM Accumulated elapsed time between when this VMDBK became ready to be dispatched and when it was dispatched (unsigned doubleword in microseconds) 800 320 Character 16 USEACT_VMUDWTTSQ Sum of the squares of the individual elapsed time samples which comprise USEACT_VMUDWTETM (unsigned quadword in squared microseconds) Note: Use deltas of USEACT_CALDWTCT, USEACT_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. 816 330 Unsigned 4 USEACT_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 USEACT_VMDTTIME values as those are all calculated at the same moment. 820 334 Character 8 USEACT_VMUDSPETM Accumulated elapsed time during which this VMDBK was dispatched (unsigned doubleword in microseconds) 828 33C Character 16 USEACT_VMUDSPTSQ Sum of the squares of the individual elapsed time samples which comprise USEACT_VMUDSPETM (unsigned quadword in squared microseconds) Note: Use deltas of USEACT_CALDSPCT, USEACT_VMUDSPETM, and this field to calculate the average amount of elapsed time this VMDBK was dispatched, and the standard deviation of those time samples. 844 34C Character 16 USEACT_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 USEACT_CALDSPCT, USEACT_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. 860 35C Unsigned 4 USEACT_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) 864 360 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 0 0 Unsigned 4 USEACT_VMUPLTL(0:MAXTOPO) Array of counters of maximum rebalance topology distance placement. One of these counts is incremented each time a workload rebalance operation assigns VMDBKs in this guest to two or more different DSVBKs. None of these counts are incremented if the rebalance operation placed the entire guest in one DSVBK. These are all cumulative counts. (Valid only in the base VMDBK.) Entry 0:Count of times rebalance placed VMDBKs of this guest at a maximum scatter distance of more than one DSVBK that are all in an equivalent nesting level 1 (NL1) topology location. Entry 1:Count of times rebalance placed VMDBKs of this guest at a maximum scatter distance of DSVBKs in different nesting level 1 (NL1) topology locations but the same NL2 location. Entry 2:Count of times rebalance placed VMDBKs of this guest at a maximum scatter distance of DSVBKs in different nesting level 2 (NL2) topology locations but the same NL3 location. Entry 3:Count of times rebalance placed VMDBKs of this guest at a maximum scatter distance of DSVBKs in different nesting level 3 (NL3) topology locations but the same NL4 location. Entry 4:Count of times rebalance placed VMDBKs of this guest at a maximum scatter distance of DSVBKs in different nesting level 4 (NL4) topology locations but the same NL5 location. Entry 5:Count of times rebalance placed VMDBKs of this guest at a maximum scatter distance of DSVBKs in different nesting level 5 (NL5) topology locations. USEACT_MAXTOPO+1 should be used to determine the number of elements of this array. Only the first USEACT_CALMNEST entries contain valid data. 0 0 Unsigned 4 USEACT_VMUVMTL(0:MAXTOPO) Array of counters of how far the VMDBK was moved topologically during work load rebalancing. None of these counts are incremented if the VMDBK is assigned to its previous home. These are all cumulative counts. (Valid in all VMDBKs.) Entry 0:Count of moves between two DSVBKs that are both in an equivalent nesting level 1 (NL1) topology location Entry 1:Count of moves between DSVBKs in two different nesting level 1 (NL1) topology locations but the same NL2 location. Entry 2:Count of moves between DSVBKs in two different nesting level 2 (NL2) topology locations but the same NL3 location. Entry 3:Count of moves between DSVBKs in two different nesting level 3 (NL3) topology locations but the same NL4 location. Entry 4:Count of moves between DSVBKs in two different nesting level 4 (NL4) topology locations but the same NL5 location. Entry 5:Count of moves between DSVBKs in two different nesting level 5 (NL5) topology locations. The USEACT_MAXTOPO+1 value should be used to determine the number of elements of this array. Only the first USEACT_CALMNEST entries contain valid data. 0 0 Unsigned 4 USEACT_VMUSTLTL(0:MAXTOPO) Array of counters indicating how many times this VMDBK was stolen across different topology levels. (Valid in all VMDBKs.) Entry 0:Count of times a CPU stole a VMDBK from a DSVBK that is in an equivalent nesting level 1 (NL1) topology location. Entry 1:Count of times a CPU stole a VMDBK from a DSVBK in a different nesting level 1 (NL1) topology location but the same NL2 location. Entry 2:Count of times a CPU stole a VMDBK from a DSVBK in a different nesting level 2 (NL2) topology location but the same NL3 location. Entry 3:Count of times a CPU stole a VMDBK from a DSVBK in a different nesting level 3 (NL3) topology location but the same NL4 location. Entry 4:Count of times a CPU stole a VMDBK from a DSVBK in a different nesting level 4 (NL4) topology location but the same NL5 location. Entry 5:Count of times a CPU stole a VMDBK from a DSVBK in a different nesting level 5 (NL5) topology location. The USEACT_MAXTOPO value plus one should be used to determine the number of elements of this array. Only the first USEACT_CALMNEST entries contain valid data. 0 0 Unsigned 16 USEACT_VMUTOPDA(VMUTOPNE) An array of elements that contain the DSVBK ID and topology descriptor of the last DSVBKs to which this VMDBK was assigned by the last rebalance functions. This is a circular array with the USEACT_VMUTOPDX field pointing to the most recent element. This array is contained in all VMDBK records, not just the base. Within a virtual configuration the Nth element of the array for each VMDBK represents the assignment made during the same rebalance operation. The USEACT_VMUTOPNS value defines the size of one array's element. The USEACT_VMUTOPNE value should be used to determine the number of elements in this array. Each entry is all FFs initially until it is used and made valid. 0 0 Character 2 USEACT_VMUTOPDI Dispatch vector ID 2 2 Character 4 USEACT_VMUTOPDS This topology descriptor or identifier consists of the container IDs for each level of the topology tree above the dispatch vector specified in USEACT_VMUTOPDI. These container IDs are positioned left to right with the highest nesting level listed first. 6 6 Character 1 * Reserved for possible future topology level expansion. 7 7 Bitstring 1 USEACT_VMUTOPFL Flag byte 1... .... USEACT_VMURROBN Placed via round robin algorithm .1.. .... USEACT_VMUMODRB Placed by a modified rebalance. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 8 8 Character 4 USEACT_VMUTOPLU Last CPU usage of this VMDBK which was used to do the home DSVBK assignment. This is a scaled number where x'10000' represents 100% of one CPU. 12 C Unsigned 4 USEACT_VMUASNORD DSV assignment order number that represents the relative position in which this guest was visited and assigned a home by rebalance. Valid in VMUBK for all VMDBKs. * * Character 0 USEACT_END

MRUSEACT 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
USEACT                     0    864+
USEACT_ASCDEFSZ          128      8
USEACT_CAL_VMAIINHLD     2F8      4
USEACT_CAL_VMAIPTEI      2D4      4
USEACT_CALBASE            22           80
USEACT_CALCPFNR          250      4
USEACT_CALCPFRY          24C      4
USEACT_CALCPINT          238      4
USEACT_CALCPINV          240      4
USEACT_CALCPMIG           CC      4
USEACT_CALCPPFA          248      4
USEACT_CALCPPFI          244      4
USEACT_CALCPPGR           74      4
USEACT_CALCPPGW           78      4
USEACT_CALCPPST           9C      4
USEACT_CALCPREL          23C      4
USEACT_CALCPXRD           D4      4
USEACT_CALCPXRL          254      4
USEACT_CALCPXWT           D0      4
USEACT_CALCTAGLA2G       22C      4
USEACT_CALCTAGLB2G       228      4
USEACT_CALCTIBRA2G       224      4
USEACT_CALCTIBRB2G       220      4
USEACT_CALCTINS          21C      4
USEACT_CALCTPGS           68      4
USEACT_CALCTRABISA2G     234      4
USEACT_CALCTRABISB2G     230      4
USEACT_CALCTXBK          260      4
USEACT_CALDEFHI          128      4
USEACT_CALDEFLO          12C      4
USEACT_CALDIAL            22           20
USEACT_CALDSPCT          330      4
USEACT_CALDWTCT          314      4
USEACT_CALFLAG1           22      1
USEACT_CALIUCVR           BC      4
USEACT_CALIUCVS           B8      4
USEACT_CALIUCVY           C0      4
USEACT_CALMESA            1F           40
USEACT_CALMESAM           1F           04
USEACT_CALMNEST          139      1
USEACT_CALMODE            1F      1
USEACT_CALMXA             1F           20
USEACT_CALMXC             1F           08
USEACT_CALM370            1F           10
USEACT_CALSHARF           DA      1
USEACT_CALSNA             22           10
USEACT_CALTODON          10C      8
USEACT_CALVARCH           1F           02
USEACT_CALVMCF            C4      4
USEACT_CALXSTOR           54      4
USEACT_END                 *      *
USEACT_IPQABSRG          134           40
USEACT_IPQDSKIP          13C      4
USEACT_IPQEFHI           138      1
USEACT_IPQEFLO           137      1
USEACT_IPQF0             134      1
USEACT_IPQGSSC           134           20
USEACT_IPQRELRG          134           80
USEACT_IPQRQHI           136      1
USEACT_IPQRQLO           135      1
USEACT_IUCMXCN           122      2
USEACT_IUCTOTCN          120      2
USEACT_LCLFLAGS           DB      1
USEACT_LIMPOOL           612      8
USEACT_MAXTOPO           203      1
USEACT_MRHDR               0      0
USEACT_OFFPLTL           204      2
USEACT_OFFSTLTL          208      2
USEACT_OFFTOPDA          20A      2
USEACT_OFFVMTL           206      2
USEACT_PROBITS           2D0      1
USEACT_RDMMMASK          1F8      4
USEACT_RDMNAME           1F0      8
USEACT_RELO1              DB           80
USEACT_VEBALERT          140      4
USEACT_VEBHDWAI          154      4
USEACT_VEBSVSCT          148      4
USEACT_VEBTPIAI          14C      4
USEACT_VEBTVSCT          144      4
USEACT_VEBVIRAI          150      4
USEACT_VMAIIA            2D8      4
USEACT_VMAIIADD          2DC      4
USEACT_VMAIIHDSSQ        304     16
USEACT_VMAIIHLD          2FC      8
USEACT_VMAIIWTM          2E0      8
USEACT_VMAIIWTSSQ        2E8     16
USEACT_VMAPRCAL          2D0           80
USEACT_VMATTIME_PRO      29C      8
USEACT_VMATTMP_PRO       2B4      8
USEACT_VMATTMS_PRO       2C4      8
USEACT_VMAVTIME_PRO      2A4      8
USEACT_VMAVTMP_PRO       2AC      8
USEACT_VMAVTMS_PRO       2BC      8
USEACT_VMDABSSH           F0      4
USEACT_VMDACTNO           FC      8
USEACT_VMDAFSUP          18A           80
USEACT_VMDASMCT           D8      2
USEACT_VMDBLKCT           DC      4
USEACT_VMDCACHN          1AC      4
USEACT_VMDCFGEM          189      1
USEACT_VMDCPUAD           1C      2
USEACT_VMDCPUAF          189           40
USEACT_VMDCPUCH          35C      4
USEACT_VMDCTFLT           58      4
USEACT_VMDCTISO           E8      4
USEACT_VMDCTPVG          124      4
USEACT_VMDCTPVL           48      4
USEACT_VMDCTPVLA         158      8
USEACT_VMDCTPVR           44      4
USEACT_VMDCTPWT           70      4
USEACT_VMDCTSHL          160      4
USEACT_VMDCTSHLA         164      8
USEACT_VMDCTSPR           7C      4
USEACT_VMDCTSPW           80      4
USEACT_VMDCTSTA          1B0      4
USEACT_VMDCTSTO          1B4      4
USEACT_VMDCTXBK           50      4
USEACT_VMDCUPGM          184      4
USEACT_VMDDSRSV          252      4
USEACT_VMDDTPLX          1CC      4
USEACT_VMDDTTOD          1D0      8
USEACT_VMDDTTOT          1C8      4
USEACT_VMDELIST           21      1
USEACT_VMDGRPN           104      8
USEACT_VMDISEVM           A0      4
USEACT_VMDISTVM           A4      4
USEACT_VMDISUVM           A8      4
USEACT_VMDLIMTH           DA           02
USEACT_VMDLKPLX          1BC      4
USEACT_VMDLKTOD          1C0      8
USEACT_VMDLKTOT          1B8      4
USEACT_VMDMAACT           22           01
USEACT_VMDMASST           22           02
USEACT_VMDMDCIA           E0      4
USEACT_VMDMODE            1E      1
USEACT_VMDMVB2G          130      4
USEACT_VMDMXRVP           F8      4
USEACT_VMDMXSHA           DA           80
USEACT_VMDMXSHR          118      4
USEACT_VMDNOFSL           22           04
USEACT_VMDNOINS           22           08
USEACT_VMDPBKCT          17C      4
USEACT_VMDPGSPL           84      4
USEACT_VMDPUST           18A      1
USEACT_VMDPUTYP          188      1
USEACT_VMDQDSPU           22           40
USEACT_VMDRELSH           EC      4
USEACT_VMDREOFL           DB           40
USEACT_VMDRLLST          1E8      8
USEACT_VMDSLIST           20      1
USEACT_VMDSSIZE           F4      4
USEACT_VMDSTFHW          212      2
USEACT_VMDSTLFC          210      2
USEACT_VMDSTOP            DA           40
USEACT_VMDSTOPD           DA           20
USEACT_VMDSTYPE           23      1
USEACT_VMDTHRCT          11C      4
USEACT_VMDTTIME           24      8
USEACT_VMDTTIME_MT1      26C      8
USEACT_VMDTTMP           194      8
USEACT_VMDTTMP_MT1       284      8
USEACT_VMDTTMS           1A4      8
USEACT_VMDTTMS_MT1       294      8
USEACT_VMDUFACTC         214      4
USEACT_VMDUFIBRC         218      4
USEACT_VMDUFOLKCT        16C      4
USEACT_VMDUFOLKTM        170      8
USEACT_VMDUSER            14      8
USEACT_VMDVCSCT           88      4
USEACT_VMDVDISK          114      4
USEACT_VMDVDSCT           8C      4
USEACT_VMDVOSCT           98      4
USEACT_VMDVSEVM           AC      4
USEACT_VMDVSTVM           B0      4
USEACT_VMDVSUVM           B4      4
USEACT_VMDVTIME           2C      8
USEACT_VMDVTIME_MT1      274      8
USEACT_VMDVTMP           18C      8
USEACT_VMDVTMP_MT1       27C      8
USEACT_VMDVTMS           19C      8
USEACT_VMDVTMS_MT1       28C      8
USEACT_VMDVTSCT           94      4
USEACT_VMDVUSCT           90      4
USEACT_VMDVVECT           DB           20
USEACT_VMDWASTE          25C      4
USEACT_VMDWKPLX          1DC      4
USEACT_VMDWKTOD          1E0      8
USEACT_VMDWKTOT          1D8      4
USEACT_VMDWSSPR           4C      4
USEACT_VMDX98CT           C8      4
USEACT_VMUASNORD           C      4
USEACT_VMUDSPETM         334      8
USEACT_VMUDSPTSQ         33C     16
USEACT_VMUDWTETM         318      8
USEACT_VMUDWTTSQ         320     16
USEACT_VMUMODRB            6           40
USEACT_VMUNRBAL          1FC      4
USEACT_VMUPLTL             0      4
USEACT_VMUREBAL          20C      4
USEACT_VMURROBN            6           80
USEACT_VMUSTLTL            0      4
USEACT_VMUTOPDA            0     16
USEACT_VMUTOPDI            0      2
USEACT_VMUTOPDS            2      4
USEACT_VMUTOPDX          202      1
USEACT_VMUTOPFL            7      1
USEACT_VMUTOPLU            8      4
USEACT_VMUTOPNE          200      1
USEACT_VMUTOPNS          201      1
USEACT_VMUTTIMSQ         34C     16
USEACT_VMUVMTL             0      4

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

Last updated on 03 Jan 2017 at 20:57:38.
Copyright IBM Corporation, 1990, 2017