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

MRUSELOF

Prolog
Control Block Contents
Cross Reference

MRUSELOF Prolog

 DSECT NAME - USELOF
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRUSELOF
 DESCRIPTIVE NAME - Monitor Event Record
                    Domain 4 - User Domain
                    Record 2 - User Logoff Data
 DESCRIPTION - Records a user that has logged off.  A record
               is created for the base VMDBK and each virtual@SQ534PQ
               CPU that is active at LOGOFF.
 NOTES:
      - Alternate VMDBKs of the user that has logged off are
        recorded in MRUSEDTC (Domain 4, Record 6).
      - Fields which are valid only for the base VMDBK are
        indicated in the comments for the fields.
      - 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.

MRUSELOF Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   848+ USELOF                 Start of monitor record
   0   0  Character     0  USELOF_MRHDR           record header
   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  USELOF_VMDUSER         USERID
  28  1C  Unsigned      2  USELOF_VMDCPUAD        Processor ID
  30  1E  Bitstring     1  USELOF_VMDMODE         Guest machine mode. This is
                                                  as set for internal use by
                                                  CP. See USELOF_CALMODE for
                                                  the mode 'calculated' at.
  31  1F  Bitstring     1  USELOF_CALMODE         Architectural mode of the
                                                  virtual machine
          1... ....        *
          .1.. ....        USELOF_CALMESA          ESA architecture
          ..1. ....        USELOF_CALMXA           XA architecture
          ...1 ....        USELOF_CALM370          370 architecture
          .... 1...        USELOF_CALMXC           XC architecture
          .... .1..        USELOF_CALMESAM         ESA mode machine has
                                                  entered z/Arch mode.
          .... ..1.        *
          .... ...1        *
  32  20  Bitstring     1  USELOF_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  USELOF_VMDELIST        Class number (0,1,2,or 3)
                                                  of the scheduling list the
                                                  user is in
  34  22  Bitstring     1  USELOF_CALFLAG1        Flag byte
          1... ....        USELOF_CALBASE          This is base VCPU.
          .1.. ....        USELOF_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. ....        USELOF_CALDIAL          This user is a dialed user
          ...1 ....        USELOF_CALSNA           This user is connected
                                                  through System Network
                                                  Architecture (SNA)
          .... 1...        USELOF_VMDNOINS         User is prevented from
                                                  inserting any tracks into the
                                                  minidisk cache. (set when SET
                                                  MDC INS OFF command is
                                                  issued)
          .... .1..        USELOF_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.        USELOF_VMDMASST         Collaborative Memory
                                                  Management assist enabled.
          .... ...1        USELOF_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
                                                  (USELOF_VMDMAACT=1) and
                                                  available to this guest until
                                                  the next virtual machine
                                                  reset or IPL.
  35  23  Bitstring     1  USELOF_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  USELOF_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  USELOF_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.
  52  34  Character     8  *                      Reserved for IBM use.
                                                  Previous field is no longer
                                                  meaningful. (USELOF_VMDVFVTM)
  60  3C  Character     8  *                      Reserved for IBM use.
                                                  Previous field is no longer
                                                  meaningful. (USELOF_VMDVFOTM)
  68  44  Unsigned      4  USELOF_VMDCTPVR        Cardinal count of private
                                                  resident pages in the virtual
                                                  machine. This monitor field
                                                  is actually the sum of
                                                  VMDCTPVR + VMDCTPVG, which
                                                  includes pages above and
                                                  below the 2GB line. To get
                                                  the count of the resident
                                                  pages below the 2GB line,
                                                  subtract USELOF_VMDCTPVG from
                                                  USELOF_VMDCTPVR. Valid only
                                                  on base VMDBK.
  72  48  Unsigned      4  USELOF_VMDCTPVL        Cardinal count of locked
                                                  pages in private address
                                                  spaces <2G belonging to this
                                                  user. See USELOF_VMDCTPVLA
                                                  for the >2G value. Valid only
                                                  on base VMDBK.
  76  4C  Unsigned      4  USELOF_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. Valid only on
                                                  base VMDBK.
  80  50  Unsigned      4  USELOF_VMDCTXBK        Number of expanded storage
                                                  blocks allocated to a virtual
                                                  machine by CP for paging.
                                                  Valid only on base VMDBK.
  84  54  Unsigned      4  USELOF_CALXSTOR        Size, in megabytes, of
                                                  expanded storage attached to
                                                  the user. If zero, no
                                                  expanded storage is attached.
                                                  VMDXSTOR
  88  58  Unsigned      4  USELOF_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. (USELOF_VMDCTVFL)
  96  60  Unsigned      4  *                      Reserved for IBM use - was
                                                  USELOF_VMDFLREO
 100  64  Unsigned      4  *                      Reserved for IBM use - was
                                                  USELOF_VMDCTORF
 104  68  Unsigned      4  USELOF_CALCTPGS        Cardinal count of
                                                  non-preferred paging slots
                                                  for private address spaces
                                                  belonging to this user. Valid
                                                  only on base VMDBK.
 108  6C  Unsigned      4  USELOF_VMDCTPWT        Count of outstanding paging
                                                  and spooling I/O's for this
                                                  user
 112  70  Unsigned      4  USELOF_CALCPPGR        Cumulative count of pages
                                                  read from DASD to main
                                                  storage for this user's
                                                  address spaces while they
                                                  were private. Valid only on
                                                  base VMDBK.
 116  74  Unsigned      4  USELOF_CALCPPGW        Cumulative count of pages
                                                  written from main storage to
                                                  DASD for this user's address
                                                  spaces while they were
                                                  private. Valid only on base
                                                  VMDBK.
 120  78  Unsigned      4  USELOF_VMDCTSPR        Number of times I/O was
                                                  issued for a spool read
                                                  request Valid only on base
                                                  VMDBK.
 124  7C  Unsigned      4  USELOF_VMDCTSPW        Number of times I/O was
                                                  issued for a spool write
                                                  request Valid only on base
                                                  VMDBK.
 128  80  Unsigned      4  USELOF_VMDPGSPL        Number of pages spooled for
                                                  this user. This includes the
                                                  pages spooled for the virtual
                                                  reader, printer, punch,
                                                  console, dump, and trace
                                                  files.
 132  84  Unsigned      4  USELOF_VMDVCSCT        Count of start requests to
                                                  the virtual machine console
 136  88  Unsigned      4  USELOF_VMDVDSCT        Cumulative count of virtual
                                                  I/O requests the virtual
                                                  machine has issued to DASD
                                                  devices
 140  8C  Unsigned      4  USELOF_VMDVUSCT        Count of Start requests to
                                                  virtual Unit Record devices
 144  90  Unsigned      4  USELOF_VMDVTSCT        Count of Start requests to
                                                  virtual channel-to-channel
                                                  adapters
 148  94  Unsigned      4  USELOF_VMDVOSCT        Count of Start requests to
                                                  devices other than console,
                                                  DASDs, CTCAs, and unit
                                                  records. (see
                                                  USELOF_VMDVCSCT,
                                                  USELOF_VMDVDSCT,
                                                  USELOF_VMDVUSCT, and
                                                  USELOF_VMDVTSCT)
 152  98  Unsigned      4  USELOF_CALCPPST        Cumulative count of pages
                                                  reclaimed/offt this user's
                                                  address spaces while they
                                                  were private. Valid only on
                                                  base VMDBK.
 156  9C  Unsigned      4  USELOF_VMDISEVM        Number of times IUCV data
                                                  was successfully transferred
                                                  by this virtual machine.
                                                  (SENDs and REPLYs with RC=0
                                                  when this virtual machine is
                                                  the source). Valid only in
                                                  base VMDBK.
 160  A0  Unsigned      4  USELOF_VMDISTVM        Number of times IUCV data
                                                  was successfully transferred
                                                  to this virtual machine.
                                                  (SENDs and REPLYs with RC=0
                                                  when this virtual machine is
                                                  the target). Valid only in
                                                  base VMDBK.
 164  A4  Unsigned      4  USELOF_VMDISUVM        Number of times IUCV data
                                                  was NOT successfully
                                                  transferred by this virtual
                                                  machine. (SENDs and REPLYs
                                                  with RC^=0 when this virtual
                                                  machine is the source). Valid
                                                  only in the base VMDBK.
 168  A8  Unsigned      4  USELOF_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.)
                                                  Valid only on base VMDBK.
 172  AC  Unsigned      4  USELOF_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.)
                                                  Valid only on base VMDBK.
 176  B0  Unsigned      4  USELOF_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.) Valid
                                                  only on base VMDBK.
 180  B4  Unsigned      4  USELOF_VMDX98CT        Cumulative number of times
                                                  Diagnose X'98' was issued by
                                                  this virtual machine
 184  B8  Unsigned      4  USELOF_CALCPMIG        Cumulative count of pages
                                                  migrated by CP from expanded
                                                  storage to DASD for this
                                                  user's address spaces while
                                                  they were private. Valid only
                                                  on base VMDBK.
 188  BC  Unsigned      4  USELOF_CALCPXWT        Cumulative count of pages
                                                  written from main storage to
                                                  expanded storage for this
                                                  user's address spaces while
                                                  they were private. Valid only
                                                  on base VMDBK.
 192  C0  Unsigned      4  USELOF_CALCPXRD        Cumulative count of pages
                                                  read from expanded storage to
                                                  main storage for this user's
                                                  address spaces while they
                                                  were private. Valid only on
                                                  base VMDBK.
 196  C4  Unsigned      2  USELOF_VMDASMCT        Cardinal number of non-base
                                                  address spaces owned by this
                                                  user.
 198  C6  Bitstring     1  USELOF_CALSHARF        Set Share flags
          1... ....        USELOF_VMDMXSHA         Max share for this CPU is
                                                  ABSOLUTE if on. Max share for
                                                  this CPU is RELATIVE if off.
          .1.. ....        *
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        USELOF_VMDLIMTH         Max share for this CPU is
                                                  LIMITHARD if on. Max share
                                                  for this CPU is LIMITSOFT if
                                                  off.
          .... ...1        *
 199  C7  Bitstring     1  USELOF_CALOSTAT        Virtual machine operating
                                                  status
          1... ....        USELOF_VMDSYSOP         User is primary system
                                                  operator
          .1.. ....        USELOF_VMDUSRCT         User is counted as being
                                                  logged on
          ..1. ....        *
          ...1 ....        USELOF_VMDFORCE         User is to be logged off.
                                                  This may be requested by CP,
                                                  a forced logoff, or user's
                                                  logoff command.
          .... 1...        USELOF_VMDUFORC         User is forced to logoff
                                                  the system
          .... .1..        USELOF_VMDDISC          User is running
                                                  disconnected
          .... ..1.        USELOF_VMDAUTOL         AUTOLOG/XAUTOLOG in
                                                  progress. User has been
                                                  automatically logged on. This
                                                  bit is set off when the
                                                  user's IPL statement is
                                                  processed, or (if there is no
                                                  IPL to process) when the user
                                                  enters a LOGON command from a
                                                  terminal to RECONNECT.
          .... ...1        USELOF_VMDXAUTO         The original command was
                                                  XAUTOLOG. Valid for the base
                                                  VMDBK only (see
                                                  USEINT_CALBASE).
 200  C8  Unsigned      4  USELOF_VMDBLKCT        Count of SSCH's issued by
                                                  BLOCKIO system service
                                                  (includes both read and write
                                                  requests)
 204  CC  Unsigned      4  USELOF_VMDMDCIA        Count of SSCH's avoided due
                                                  to Minidisk Cache read hit
 208  D0  Unsigned      4  *                      Reserved for IBM use
                                                  Previous field is no longer
                                                  meaningful. (USELOF_VMDCOPCT)
 212  D4  Unsigned      4  USELOF_VMDCTISO        Number of times ISOLATE
                                                  occurred for spaces owned by
                                                  this virtual system. Valid
                                                  only in base VMDBK
 216  D8  Unsigned      4  USELOF_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.
 220  DC  Unsigned      4  USELOF_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.
 224  E0  Unsigned      4  USELOF_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
                                                  USELOF_ASCDEFSZ
 228  E4  Unsigned      4  USELOF_VMDMXRVP        Number of pages reserved
                                                  for the user
 232  E8  Character     8  USELOF_VMDACTNO        User accounting number
 240  F0  Character     8  USELOF_VMDGRPN         RACF ACI group name
 248  F8  Character     8  USELOF_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. If virtual CPUs are
                                                  active at LOGOFF the value in
                                                  this field represents the
                                                  time-of-day when the virtual
                                                  CPU was defined.
 256 100  Unsigned      4  USELOF_VMDVDISK        Count of virtual I/Os to a
                                                  virtual disk in storage.
 260 104  Unsigned      4  USELOF_VMDMXSHR        This virtual CPU's Max
                                                  share of the system, as set
                                                  in the user's directory or
                                                  via the SET SHARE command.
                                                  This value is set to zero if
                                                  no Max share exists. If the
                                                  Max share is Absolute, then
                                                  the unit of the value is a
                                                  hexadecimal factor scaled 16
                                                  bits. For example,
                                                  X'00010000' = 1.00(100%),
                                                  X'0000C000' = 0.75(75%),
                                                  X'00008000' = 0.50(50%), etc.
                                                  Check USELOF_VMDMXSHA to
                                                  determine if Max share is
                                                  absolute or relative.
 264 108  Unsigned      4  USELOF_VMDTHRCT        Total number of times this
                                                  user was delayed doing I/O to
                                                  a throttled device
 268 10C  Character     8  USELOF_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'). Valid
                                                  only on base VMDBK.
 268 10C  Character     4  USELOF_CALDEFHI        high four bytes
 272 110  Character     4  USELOF_CALDEFLO        low four bytes
 276 114  Unsigned      4  USELOF_VMDCTPVG        Count of private address
                                                  space resident pages in DPA
                                                  owned by this virtual machine
                                                  which are >= 2G. Valid only
                                                  in base VMDBK.
 280 118  Unsigned      4  USELOF_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.
 284 11C  Unsigned      4  USELOF_VEBALERT        Number of alert
                                                  interruptions Collected only
                                                  for base VMDBK.
 288 120  Unsigned      4  USELOF_VEBTVSCT        Number of interceptions for
                                                  guest TVS instructions
                                                  Collected only for base
                                                  VMDBK.
 292 124  Unsigned      4  USELOF_VEBSVSCT        Number of interceptions for
                                                  guest SVS instructions
                                                  Collected only for base
                                                  VMDBK.
 296 128  Unsigned      4  USELOF_VEBTPIAI        Number of adapter
                                                  interruptions delivered via
                                                  guest TPI Collected only for
                                                  base VMDBK.
 300 12C  Unsigned      4  USELOF_VEBVIRAI        Number of adapter
                                                  interruptions stacked for
                                                  guest by CP Collected only
                                                  for base VMDBK.
 304 130  Unsigned      4  USELOF_VEBHDWAI        Number of adapter
                                                  interruptions delivered to
                                                  guest inside SIE Collected
                                                  only for base VMDBK.
 308 134  Character     8  USELOF_VMDCTPVLA       Cardinal count of locked
                                                  pages in private address
                                                  spaces >2G belonging to this
                                                  user. See USELOF_VMDCTPVL for
                                                  the <2G value. Valid only on
                                                  base VMDBK.
 316 13C  Unsigned      4  USELOF_VMDCTSHL        Count of shared address
                                                  space resident pages <2G.
                                                  Valid only in the SYSTEM
                                                  VMDBK.
 320 140  Character     8  USELOF_VMDCTSHLA       Count of shared address
                                                  space resident pages >2G.
                                                  Valid only in the SYSTEM
                                                  VMDBK.
 328 148  Unsigned      1  USELOF_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)
 329 149  Unsigned      1  USELOF_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 USELOF_VMUPLTL,
                                                      USELOF_VMUVMTL, and
                                                      USELOF_VMUSTLTL arrays.
 330 14A  Character     2  *                      Reserved and available for
                                                  IBM use.
 332 14C  Character     8  USELOF_VMDVTMP         Total raw virtual time for the
                                                  user on primary processor.
 340 154  Character     8  USELOF_VMDTTMP         Total raw virtual and
                                                  simulation time for the user
                                                  on primary processor.
 348 15C  Character     8  USELOF_VMDVTMS         Total raw virtual time for the
                                                  user on secondary processor.
 356 164  Character     8  USELOF_VMDTTMS         Total raw virtual and
                                                  simulation time for the user
                                                  on secondary processor.
 364 16C  Unsigned      4  USELOF_CP_SSHRELSH     This user's RELATIVE share
                                                  setting for CPUs of type CP.
 368 170  Unsigned      4  USELOF_CP_SSHABSSH     This user's ABSOLUTE share
                                                  setting for CPUs of type CP.
 372 174  Unsigned      4  USELOF_CP_SSHMXSHR     This user's Max share
                                                  setting for CPUs of type CP.
 376 178  Bitstring     1  USELOF_CP_SSHFLG1      This user's share flags for
                                                  CPUs of type CP.
          1... ....        *
          .1.. ....        USELOF_CP_SSHLIMH       Max share for type CP is
                                                  LIMITHARD if on. Max share
                                                  for type CP is LIMITSOFT if
                                                  off.
          ..1. ....        USELOF_CP_SSHNMSHA      Normal share for type CP
                                                  is ABSOLUTE if on. Normal
                                                  share for type CP is RELATIVE
                                                  if off.
          ...1 ....        USELOF_CP_SSHMXSHA      Max share for type CP is
                                                  ABSOLUTE if on. Max share for
                                                  type CP is RELATIVE if off.
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 377 179  Bitstring     3  *                      Reserved and available for
                                                  IBM use.
 380 17C  Unsigned      4  USELOF_ZAP_SSHRELSH    This user's RELATIVE share
                                                  setting for CPUs of type
                                                  zAAP.
 384 180  Unsigned      4  USELOF_ZAP_SSHABSSH    This user's ABSOLUTE share
                                                  setting for CPUs of type
                                                  zAAP.
 388 184  Unsigned      4  USELOF_ZAP_SSHMXSHR    This user's Max share
                                                  setting for CPUs of type
                                                  zAAP.
 392 188  Bitstring     1  USELOF_ZAP_SSHFLG1     This user's share flags for
                                                  CPUs of type zAAP.
          1... ....        *
          .1.. ....        USELOF_ZAP_SSHLIMH      Max share for type zAAP is
                                                  LIMITHARD if on. Max share
                                                  for type zAAP is LIMITSOFT if
                                                  off.
          ..1. ....        USELOF_ZAP_SSHNMSHA     Normal share for type zAAP
                                                  is ABSOLUTE if on. Normal
                                                  share for type zAAP is
                                                  RELATIVE if off.
          ...1 ....        USELOF_ZAP_SSHMXSHA     Max share for type zAAP is
                                                  ABSOLUTE if on. Max share for
                                                  type zAAP is RELATIVE if off.
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 393 189  Bitstring     3  *                      Reserved and available for
                                                  IBM use.
 396 18C  Unsigned      4  USELOF_IFL_SSHRELSH    This user's RELATIVE share
                                                  setting for CPUs of type IFL.
 400 190  Unsigned      4  USELOF_IFL_SSHABSSH    This user's ABSOLUTE share
                                                  setting for CPUs of type IFL.
 404 194  Unsigned      4  USELOF_IFL_SSHMXSHR    This user's Max share
                                                  setting for CPUs of type IFL.
 408 198  Bitstring     1  USELOF_IFL_SSHFLG1     This user's share flags for
                                                  CPUs of type IFL.
          1... ....        *
          .1.. ....        USELOF_IFL_SSHLIMH      Max share for type IFL is
                                                  LIMITHARD if on. Max share
                                                  for type IFL is LIMITSOFT if
                                                  off.
          ..1. ....        USELOF_IFL_SSHNMSHA     Normal share for type IFL
                                                  is ABSOLUTE if on. Normal
                                                  share for type IFL is
                                                  RELATIVE if off.
          ...1 ....        USELOF_IFL_SSHMXSHA     Max share for type IFL is
                                                  ABSOLUTE if on. Max share for
                                                  type IFL is RELATIVE if off.
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 409 199  Bitstring     3  *                      Reserved and available for
                                                  IBM use.
 412 19C  Unsigned      4  USELOF_ICF_SSHRELSH    This user's RELATIVE share
                                                  setting for CPUs of type ICF.
 416 1A0  Unsigned      4  USELOF_ICF_SSHABSSH    This user's ABSOLUTE share
                                                  setting for CPUs of type ICF.
 420 1A4  Unsigned      4  USELOF_ICF_SSHMXSHR    This user's Max share
                                                  setting for CPUs of type ICF.
 424 1A8  Bitstring     1  USELOF_ICF_SSHFLG1     This user's share flags for
                                                  CPUs of type ICF.
          1... ....        *
          .1.. ....        USELOF_ICF_SSHLIMH      Max share for type ICF is
                                                  LIMITHARD if on. Max share
                                                  for type ICF is LIMITSOFT if
                                                  off.
          ..1. ....        USELOF_ICF_SSHNMSHA     Normal share for type ICF
                                                  is ABSOLUTE if on. Normal
                                                  share for type ICF is
                                                  RELATIVE if off.
          ...1 ....        USELOF_ICF_SSHMXSHA     Max share for type ICF is
                                                  ABSOLUTE if on. Max share for
                                                  type ICF is RELATIVE if off.
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 425 1A9  Bitstring     3  *                      Reserved and available for
                                                  IBM use.
 428 1AC  Unsigned      4  USELOF_ZIP_SSHRELSH    This user's RELATIVE share
                                                  setting for CPUs of type
                                                  zIIP.
 432 1B0  Unsigned      4  USELOF_ZIP_SSHABSSH    This user's ABSOLUTE share
                                                  setting for CPUs of type
                                                  zIIP.
 436 1B4  Unsigned      4  USELOF_ZIP_SSHMXSHR    This user's Max share
                                                  setting for CPUs of type
                                                  zIIP.
 440 1B8  Bitstring     1  USELOF_ZIP_SSHFLG1     This user's share flags for
                                                  CPUs of type zIIP.
          1... ....        *
          .1.. ....        USELOF_ZIP_SSHLIMH      Max share for type zIIP is
                                                  LIMITHARD if on. Max share
                                                  for type zIIP is LIMITSOFT if
                                                  off.
          ..1. ....        USELOF_ZIP_SSHNMSHA     Normal share for type zIIP
                                                  is ABSOLUTE if on. Normal
                                                  share for type zIIP is
                                                  RELATIVE if off.
          ...1 ....        USELOF_ZIP_SSHMXSHA     Max share for type zIIP is
                                                  ABSOLUTE if on. Max share for
                                                  type zIIP is RELATIVE if off.
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 441 1B9  Bitstring     3  *                      Reserved and available for
                                                  IBM use.
 444 1BC  Unsigned      4  USELOF_VMDLKTOT        Cumulative count of times
                                                  this user has issued the LINK
                                                  command. Valid only in base
                                                  VMDBK.
 448 1C0  Unsigned      4  USELOF_VMDLKPLX        Cumulative count of times
                                                  this user has issued the LINK
                                                  command and consulted with
                                                  the SSI. Valid only in base
                                                  VMDBK.
 452 1C4  Character     8  USELOF_VMDLKTOD        Total virtual time for LINK
                                                  commands to consult with the
                                                  SSI. Valid only in base
                                                  VMDBK.
 460 1CC  Unsigned      4  USELOF_VMDDTTOT        Cumulative count of times
                                                  this user has issued the
                                                  DETACH command. Valid only in
                                                  base VMDBK.
 464 1D0  Unsigned      4  USELOF_VMDDTPLX        Cumulative count of times
                                                  this user has issued the
                                                  DETACH command and consulted
                                                  with the SSI. Valid only in
                                                  base VMDBK.
 468 1D4  Character     8  USELOF_VMDDTTOD        Total virtual time for
                                                  DETACH commands to consult
                                                  with the SSI. Valid only in
                                                  base VMDBK.
 476 1DC  Unsigned      4  USELOF_VMDWKTOT        Cumulative count of times
                                                  this user has used WRKALLEG
                                                  (SET WRKALLEG, DASDOPT
                                                  WRKALLEG or MINIOPT
                                                  WRKALLEG). Valid only in base
                                                  VMDBK.
 480 1E0  Unsigned      4  USELOF_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.
 484 1E4  Character     8  USELOF_VMDWKTOD        Total virtual time for
                                                  WRKALLEG use to consult with
                                                  the SSI. Valid only in base
                                                  VMDBK.
 492 1EC  Bitstring     1  USELOF_LCLFLAGS        General flags
          1... ....        USELOF_RELO1            Record cut due to a live
                                                  guest relocation
          .1.. ....        USELOF_VMDVVECT        Vector regs in use
          ..1. ....        *
          ...1 ....        *
          .... 1...        *
          .... .1..        *
          .... ..1.        *
          .... ...1        *
 493 1ED  Unsigned      1  *                      Reserved for IBM Use
 494 1EE  Unsigned      1  *                      Reserved for IBM Use
 495 1EF  Unsigned      1  *                      Reserved for IBM Use
 496 1F0  Unsigned      4  USELOF_VMUNRBAL        Cumulative count of the
                                                  number of configuration
                                                  rebalances.
                                                  Valid only in base VMDBK.
 500 1F4  Unsigned      1  USELOF_VMUTOPNE        Number of elements that fit
                                                  in the USELOF_VMUTOPDA array.
 501 1F5  Unsigned      1  USELOF_VMUTOPNS        The size in bytes of one
                                                  element of the USELOF_VMUTOPDA
                                                  array.
 502 1F6  Unsigned      1  USELOF_VMUTOPDX        Zero-based index into the
                                                  circular array called
                                                  USELOF_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.
 503 1F7  Unsigned      1  USELOF_MAXTOPO         Maximum number of topology
                                                  levels currently architected.
                                                  The value should be used for
                                                  array size calculation for the
                                                  following fields:
                                                    USELOF_VMUPLTL,
                                                    USELOF_VMUVMTL,
                                                    USELOF_VMUSTLTL.
 504 1F8  Unsigned      2  USELOF_OFFPLTL         Offset within this record to
                                                  the USELOF_VMUPLTL array.
 506 1FA  Unsigned      2  USELOF_OFFVMTL         Offset within this record to
                                                  the USELOF_VMUVMTL array.
 508 1FC  Unsigned      2  USELOF_OFFSTLTL        Offset within this record to
                                                  the USELOF_VMUSTLTL array.
 510 1FE  Unsigned      2  USELOF_OFFTOPDA        Offset within this record to
                                                  the USELOF_VMUTOPDA array.
 512 200  Unsigned      4  USELOF_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.
 516 204  Unsigned      4  *                      Reserved for IBM use
 520 208  Unsigned      2  USELOF_VMDSTLFC        Steal weight factor. Used to
                                                  determine the level of aggressiveness
                                                  in reclaiming frames from this
                                                  user.
                                                  Valid only for the base VMDBK.
 522 20A  Unsigned      2  USELOF_VMDSTFHW        Steal weight factor high water
                                                  mark.
                                                  Valid only for the base VMDBK.
 524 20C  Unsigned      4  USELOF_VMDUFACTC       The length (in frames)
                                                  of the active section of the UFO.
                                                  Valid only for the base VMDBK.
 528 210  Unsigned      4  USELOF_VMDUFIBRC       The length (in frames)
                                                  of the IBR section of the UFO.
                                                  Valid only for the base VMDBK.
 532 214  Unsigned      4  USELOF_CALCTINS        Cardinal count of private
                                                  instantiated pages.
                                                  Valid only for the base VMDBK.
 536 218  Unsigned      4  USELOF_CALCTIBRB2G     Cardinal count of private
                                                  IBR pages on the UFO that are
                                                  backed by frames < 2G.
                                                  Valid only for the base VMDBK.
 540 21C  Unsigned      4  USELOF_CALCTIBRA2G     Cardinal count of private
                                                  IBR pages on the UFO that are
                                                  backed by frames > 2G.
                                                  Valid only for the base VMDBK.
 544 220  Unsigned      4  USELOF_CALCTAGLB2G     Cardinal count of private
                                                  IBR pages on the global aging
                                                  list that are backed by frames
                                                  < 2G.
                                                  Valid only for the base VMDBK.
 548 224  Unsigned      4  USELOF_CALCTAGLA2G     Cardinal count of private
                                                  IBR pages on the global aging
                                                  list that are backed by frames
                                                  > 2G.
                                                  Valid only for the base VMDBK.
 552 228  Unsigned      4  USELOF_CALCTRABISB2G   Cardinal count of private
                                                  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.
 556 22C  Unsigned      4  USELOF_CALCTRABISA2G   Cardinal count of private
                                                  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.
 560 230  Unsigned      4  USELOF_CALCPINT        Cumulative count of private
                                                  instantiated pages.
                                                  Valid only for the base VMDBK.
 564 234  Unsigned      4  USELOF_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.
 568 238  Unsigned      4  USELOF_CALCPINV        Cumulative count of private
                                                  pages made IBR.
                                                  Valid only for the base VMDBK.
 572 23C  Unsigned      4  USELOF_CALCPPFI        Cumulative count of private
                                                  IBR pages revalidated while on
                                                  the UFO.
                                                  Valid only for the base VMDBK.
 576 240  Unsigned      4  USELOF_CALCPPFA        Cumulative count of private
                                                  IBR pages revalidated while on
                                                  the global aging list.
                                                  Valid only for the base VMDBK.
 580 244  Unsigned      4  USELOF_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.
 584 248  Unsigned      4  USELOF_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.
 588 24C  Unsigned      4  USELOF_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.
 592 250  Unsigned      4  USELOF_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.
 596 254  Unsigned      4  USELOF_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.
 600 258  Unsigned      4  USELOF_CALCTXBK        Cardinal count of expanded
                                                  storage paging blocks for
                                                  private address spaces
                                                  belonging to this user.
                                                  Valid only for the base VMDBK.
 604 25C  Character     8  USELOF_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.
 612 264  Character     8  USELOF_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.
 620 26C  Character     8  USELOF_VMDVTMP_MT1     MT-1 Equivalent virtual
                                                  time for the user on primary
                                                  processor.
 628 274  Character     8  USELOF_VMDTTMP_MT1     MT-1 Equivalent total
                                                  virtual and simulation time for
                                                  the user on primary processor.
 636 27C  Character     8  USELOF_VMDVTMS_MT1     MT-1 Equivalent total
                                                  virtual time for the user on
                                                  secondary processor.
 644 284  Character     8  USELOF_VMDTTMS_MT1     MT-1 Equivalent total
                                                  virtual and simulation time for
                                                  the user on secondary processor.
 652 28C  Character     8  USELOF_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.
 660 294  Character     8  USELOF_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.
 668 29C  Character     8  USELOF_VMAVTMP_PRO     Total Prorated Core virtual
                                                  time for user on primary processor.
                                                  See the notes above.
 676 2A4  Character     8  USELOF_VMATTMP_PRO     Total Prorated Core virtual
                                                  and simulation time for the user
                                                  on primary processor.
                                                  See the notes above.
 684 2AC  Character     8  USELOF_VMAVTMS_PRO     Total Prorated Core virtual
                                                  time for user on secondary processor.
                                                  See the notes above.
 692 2B4  Character     8  USELOF_VMATTMS_PRO     Total Prorated Core virtual
                                                  and simulation time for the user
                                                  on secondary processor.
                                                  See the notes above.
 700 2BC  Unsigned      4  *                      Reserved for IBM use
 704 2C0  Bitstring     1  USELOF_PROBITS         Prorated Core Time bits needed
                                                  to understand those fields.
          1... ....        USELOF_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        *
 705 2C1  Unsigned      1  *                      Reserved for IBM use
 706 2C2  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 708 2C4 Unsigned 4 USELOF_CAL_VMAIPTEI Total count of IPTE Interlock acquisitions using methods 1 or 2. 712 2C8 Unsigned 4 USELOF_VMAIIA Count IPTE Interlock acquisitions using method 2. 716 2CC Unsigned 4 USELOF_VMAIIADD Count of times an IPTE Interlock was acquired as an additional host share. 720 2D0 Character 8 USELOF_VMAIIWTM Cumulative amount of time spent waiting for an IPTE Interlock acquisition. 728 2D8 Character 16 USELOF_VMAIIWTSSQ Sum of squared time spent waiting for an IPTE Interlock acquisition. 744 2E8 Unsigned 4 USELOF_CAL_VMAIINHLD Count of intervals over which one or more host shares of an IPTE Interlock were continuously held. 748 2Ec Character 8 USELOF_VMAIIHLD Cumulative amount of time over which one or more host shares of an IPTE Interlock were continuously held. 756 2F4 Character 16 USELOF_VMAIIHDSSQ Sum of squared time over which one or more 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 772 304 Unsigned 4 USELOF_CALDWTCT Count of the number of times this VMDBK became ready to be dispatched (unsigned fullword). This is calculated using VMUDWTCT. 776 308 Character 8 USELOF_VMUDWTETM Accumulated elapsed time between when this VMDBK became ready to be dispatched and when it was dispatched (unsigned doubleword in microseconds) 784 310 Character 16 USELOF_VMUDWTTSQ Sum of the squares of the individual elapsed time samples which comprise USELOF_VMUDWTETM (unsigned quadword in squared microseconds) Note: Use deltas of USELOF_CALDWTCT, USELOF_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. 800 320 Unsigned 4 USELOF_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 USELOF_VMDTTIME values as those are all calculated at the same moment. 804 324 Character 8 USELOF_VMUDSPETM Accumulated elapsed time during which this VMDBK was dispatched (unsigned doubleword in microseconds) 812 32C Character 16 USELOF_VMUDSPTSQ Sum of the squares of the individual elapsed time samples which comprise USELOF_VMUDSPETM (unsigned quadword in squared microseconds) Note: Use deltas of USELOF_CALDSPCT, USELOF_VMUDSPETM, and this field to calculate the average amount of elapsed time this VMDBK was dispatched, and the standard deviation of those time samples. 828 33C Character 16 USELOF_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 USELOF_CALDSPCT, USELOF_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. 844 34C Unsigned 4 USELOF_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) 848 350 Character 0 * Additional fields may be inserted before here. Use offsets to locate any fields after this point. 0 0 Unsigned 4 USELOF_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. USELOF_MAXTOPO+1 should be used to determine the number of elements of this array. Only the first USELOF_CALMNEST entries contain valid data. 0 0 Unsigned 4 USELOF_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 USELOF_MAXTOPO+1 value should be used to determine the number of elements of this array. Only the first USELOF_CALMNEST entries contain valid data. 0 0 Unsigned 4 USELOF_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 USELOF_MAXTOPO value plus one should be used to determine the number of elements of this array. Only the first USELOF_CALMNEST entries contain valid data. 0 0 Unsigned 12 USELOF_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 USELOF_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 USELOF_VMUTOPNS value defines the size of one array's element. The USELOF_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 USELOF_VMUTOPDI Dispatch vector ID 2 2 Character 4 USELOF_VMUTOPDS This topology descriptor or identifier consists of the container IDs for each level of the topology tree above the dispatch vector specified in USELOF_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 USELOF_VMUTOPFL Flag byte 1... .... USELOF_VMURROBN Placed via round robin algorithm .1.. .... USELOF_VMUMODRB Placed by a modified rebalance. ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 8 8 Character 4 USELOF_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 USELOF_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 USELOF_END

MRUSELOF 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
USELOF                     0    848+
USELOF_ASCDEFSZ          10C      8
USELOF_CAL_VMAIINHLD     2E8      4
USELOF_CAL_VMAIPTEI      2C4      4
USELOF_CALBASE            22           80
USELOF_CALCPFNR          248      4
USELOF_CALCPFRY          244      4
USELOF_CALCPINT          230      4
USELOF_CALCPINV          238      4
USELOF_CALCPMIG           B8      4
USELOF_CALCPPFA          240      4
USELOF_CALCPPFI          23C      4
USELOF_CALCPPGR           70      4
USELOF_CALCPPGW           74      4
USELOF_CALCPPST           98      4
USELOF_CALCPREL          234      4
USELOF_CALCPXRD           C0      4
USELOF_CALCPXRL          24C      4
USELOF_CALCPXWT           BC      4
USELOF_CALCTAGLA2G       224      4
USELOF_CALCTAGLB2G       220      4
USELOF_CALCTIBRA2G       21C      4
USELOF_CALCTIBRB2G       218      4
USELOF_CALCTINS          214      4
USELOF_CALCTPGS           68      4
USELOF_CALCTRABISA2G     22C      4
USELOF_CALCTRABISB2G     228      4
USELOF_CALCTXBK          258      4
USELOF_CALDEFHI          10C      4
USELOF_CALDEFLO          110      4
USELOF_CALDIAL            22           20
USELOF_CALDSPCT          320      4
USELOF_CALDWTCT          304      4
USELOF_CALFLAG1           22      1
USELOF_CALMESA            1F           40
USELOF_CALMESAM           1F           04
USELOF_CALMNEST          149      1
USELOF_CALMODE            1F      1
USELOF_CALMXA             1F           20
USELOF_CALMXC             1F           08
USELOF_CALM370            1F           10
USELOF_CALOSTAT           C7      1
USELOF_CALSHARF           C6      1
USELOF_CALSNA             22           10
USELOF_CALTODON           F8      8
USELOF_CALXSTOR           54      4
USELOF_CP_SSHABSSH       170      4
USELOF_CP_SSHFLG1        178      1
USELOF_CP_SSHLIMH        178           40
USELOF_CP_SSHMXSHA       178           10
USELOF_CP_SSHMXSHR       174      4
USELOF_CP_SSHNMSHA       178           20
USELOF_CP_SSHRELSH       16C      4
USELOF_END                 *      *
USELOF_ICF_SSHABSSH      1A0      4
USELOF_ICF_SSHFLG1       1A8      1
USELOF_ICF_SSHLIMH       1A8           40
USELOF_ICF_SSHMXSHA      1A8           10
USELOF_ICF_SSHMXSHR      1A4      4
USELOF_ICF_SSHNMSHA      1A8           20
USELOF_ICF_SSHRELSH      19C      4
USELOF_IFL_SSHABSSH      190      4
USELOF_IFL_SSHFLG1       198      1
USELOF_IFL_SSHLIMH       198           40
USELOF_IFL_SSHMXSHA      198           10
USELOF_IFL_SSHMXSHR      194      4
USELOF_IFL_SSHNMSHA      198           20
USELOF_IFL_SSHRELSH      18C      4
USELOF_LCLFLAGS          1EC      1
USELOF_MAXTOPO           1F7      1
USELOF_MRHDR               0      0
USELOF_OFFPLTL           1F8      2
USELOF_OFFSTLTL          1FC      2
USELOF_OFFTOPDA          1FE      2
USELOF_OFFVMTL           1FA      2
USELOF_PROBITS           2C0      1
USELOF_RELO1             1EC           80
USELOF_VEBALERT          11C      4
USELOF_VEBHDWAI          130      4
USELOF_VEBSVSCT          124      4
USELOF_VEBTPIAI          128      4
USELOF_VEBTVSCT          120      4
USELOF_VEBVIRAI          12C      4
USELOF_VMAIIA            2C8      4
USELOF_VMAIIADD          2CC      4
USELOF_VMAIIHLD          2EC      8
USELOF_VMAIIHDSSQ        2F4     16
USELOF_VMAIIWTM          2D0      8
USELOF_VMAIIWTSSQ        2D8     16
USELOF_VMAPRCAL          2C0           80
USELOF_VMATTIME_PRO      28C      8
USELOF_VMATTMP_PRO       2A4      8
USELOF_VMATTMS_PRO       2B4      8
USELOF_VMAVTIME_PRO      294      8
USELOF_VMAVTMP_PRO       29C      8
USELOF_VMAVTMS_PRO       2AC      8
USELOF_VMDABSSH           DC      4
USELOF_VMDACTNO           E8      8
USELOF_VMDASMCT           C4      2
USELOF_VMDAUTOL           C7           02
USELOF_VMDBLKCT           C8      4
USELOF_VMDCPUAD           1C      2
USELOF_VMDCPUCH          34C      4
USELOF_VMDCTFLT           58      4
USELOF_VMDCTISO           D4      4
USELOF_VMDCTPVG          114      4
USELOF_VMDCTPVL           48      4
USELOF_VMDCTPVLA         134      8
USELOF_VMDCTPVR           44      4
USELOF_VMDCTPWT           6C      4
USELOF_VMDCTSHL          13C      4
USELOF_VMDCTSHLA         140      8
USELOF_VMDCTSPR           78      4
USELOF_VMDCTSPW           7C      4
USELOF_VMDCTXBK           50      4
USELOF_VMDDISC            C7           04
USELOF_VMDDSRSV          250      4
USELOF_VMDDTPLX          1D0      4
USELOF_VMDDTTOD          1D4      8
USELOF_VMDDTTOT          1CC      4
USELOF_VMDELIST           21      1
USELOF_VMDFORCE           C7           10
USELOF_VMDGRPN            F0      8
USELOF_VMDISEVM           9C      4
USELOF_VMDISTVM           A0      4
USELOF_VMDISUVM           A4      4
USELOF_VMDLIMTH           C6           02
USELOF_VMDLKPLX          1C0      4
USELOF_VMDLKTOD          1C4      8
USELOF_VMDLKTOT          1BC      4
USELOF_VMDMAACT           22           01
USELOF_VMDMASST           22           02
USELOF_VMDMDCIA           CC      4
USELOF_VMDMODE            1E      1
USELOF_VMDMVB2G          118      4
USELOF_VMDMXRVP           E4      4
USELOF_VMDMXSHA           C6           80
USELOF_VMDMXSHR          104      4
USELOF_VMDNOFSL           22           04
USELOF_VMDNOINS           22           08
USELOF_VMDPGSPL           80      4
USELOF_VMDPUTYP          148      1
USELOF_VMDQDSPU           22           40
USELOF_VMDRELSH           D8      4
USELOF_VMDSLIST           20      1
USELOF_VMDSSIZE           E0      4
USELOF_VMDSTFHW          20A      2
USELOF_VMDSTLFC          208      2
USELOF_VMDSTYPE           23      1
USELOF_VMDSYSOP           C7           80
USELOF_VMDTHRCT          108      4
USELOF_VMDTTIME           24      8
USELOF_VMDTTIME_MT1      25C      8
USELOF_VMDTTMP           154      8
USELOF_VMDTTMP_MT1       274      8
USELOF_VMDTTMS           164      8
USELOF_VMDTTMS_MT1       284      8
USELOF_VMDUFACTC         20C      4
USELOF_VMDUFIBRC         210      4
USELOF_VMDUFORC           C7           08
USELOF_VMDUSER            14      8
USELOF_VMDUSRCT           C7           40
USELOF_VMDVCSCT           84      4
USELOF_VMDVDISK          100      4
USELOF_VMDVDSCT           88      4
USELOF_VMDVOSCT           94      4
USELOF_VMDVSEVM           A8      4
USELOF_VMDVSTVM           AC      4
USELOF_VMDVSUVM           B0      4
USELOF_VMDVTIME           2C      8
USELOF_VMDVTIME_MT1      264      8
USELOF_VMDVTMP           14C      8
USELOF_VMDVTMP_MT1       26C      8
USELOF_VMDVTMS           15C      8
USELOF_VMDVTMS_MT1       27C      8
USELOF_VMDVTSCT           90      4
USELOF_VMDVUSCT           8C      4
USELOF_VMDVVECT          1EC           40
USELOF_VMDWASTE          254      4
USELOF_VMDWKPLX          1E0      4
USELOF_VMDWKTOD          1E4      8
USELOF_VMDWKTOT          1DC      4
USELOF_VMDWSSPR           4C      4
USELOF_VMDXAUTO           C7           01
USELOF_VMDX98CT           B4      4
USELOF_VMUASNORD           C      4
USELOF_VMUDSPETM         324      8
USELOF_VMUDSPTSQ         32C     16
USELOF_VMUDWTETM         308      8
USELOF_VMUDWTTSQ         310     16
USELOF_VMUMODRB            6           40
USELOF_VMUNRBAL          1F0      4
USELOF_VMUPLTL             0      4
USELOF_VMUREBAL          200      4
USELOF_VMURROBN            6           80
USELOF_VMUSTLTL            0      4
USELOF_VMUTOPDA            0     12
USELOF_VMUTOPDI            0      2
USELOF_VMUTOPDS            2      4
USELOF_VMUTOPDX          1F6      1
USELOF_VMUTOPFL            7      1
USELOF_VMUTOPLU            8      4
USELOF_VMUTOPNE          1F4      1
USELOF_VMUTOPNS          1F5      1
USELOF_VMUTTIMSQ         33C     16
USELOF_VMUVMTL             0      4
USELOF_ZAP_SSHABSSH      180      4
USELOF_ZAP_SSHFLG1       188      1
USELOF_ZAP_SSHLIMH       188           40
USELOF_ZAP_SSHMXSHA      188           10
USELOF_ZAP_SSHMXSHR      184      4
USELOF_ZAP_SSHNMSHA      188           20
USELOF_ZAP_SSHRELSH      17C      4
USELOF_ZIP_SSHABSSH      1B0      4
USELOF_ZIP_SSHFLG1       1B8      1
USELOF_ZIP_SSHLIMH       1B8           40
USELOF_ZIP_SSHMXSHA      1B8           10
USELOF_ZIP_SSHMXSHR      1B4      4
USELOF_ZIP_SSHNMSHA      1B8           20
USELOF_ZIP_SSHRELSH      1AC      4

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

Last updated on 07 Apr 2016 at 07:31:38.
Copyright IBM Corporation, 1990, 2016