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

#### MRUSEATE

Prolog
Control Block Contents
Cross Reference

#### MRUSEATE Prolog

####

####

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

    MRUSEATE Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  316  USEATE                 Start of monitor record
      0   0  Character    0  USEATE_MRHDR           Record header. See MRRECHDR
                                                    for details.
      0   0  Character   20  MRHDR
      0   0  Unsigned     2  MRHDRLEN               record length in bytes
      2   2  Unsigned     2  MRHDRZER               field of zeros
      4   4  Unsigned     1  MRHDRDM                domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC                record identifier
      8   8  Character    8  MRHDRTOD               Time at which this record was
                                                    built. In time-of-day (TOD)
                                                    clock format. See IBM System
                                                    370 XA Principle of Operation
                                                    for explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END              End of header
     20  14  Character    8  USEATE_VMDUSER         Userid
     28  1C  Unsigned     2  USEATE_VMDCPUAD        Processor ID
     30  1E  Bitstring    1  USEATE_VMDMODE         Guest machine mode. This is
                                                    as set for internal use by CP.
                                                    See USEATE_CALMODE for the mode
                                                    'calculated' at.
     31  1F  Bitstring    1  USEATE_CALMODE         Architectural mode of the
                                                    virtual machine
              1... ....      *
              .1.. ....      USEATE_CALMESA         ESA architecture
              ..1. ....      USEATE_CALMXA          XA architecture
              ...1 ....      USEATE_CALM370         370 architecture
              .... 1...      USEATE_CALMXC          XC architecture
              .... .1..      USEATE_CALMESAM        ESA mode machine has entered
                                                    z/Arch mode
              .... ..1.      *
              .... ...1      *
     32  20  Character    8  USEATE_VMDTTIME        Total time which has been
                                                    expended on this VMDBK. This
                                                    includes time which the VMDBK
                                                    spent doing its own work and
                                                    also time which CP spent doing
                                                    work on behalf of the VMDBK. It
                                                    is in CPU timer format. The
                                                    complement of this field is the
                                                    elapsed time in TOD clock
                                                    units.
     40  28  Character    8  USEATE_VMDVTIME        Total time that this user was
                                                    running, doing productive work.
                                                    It does not include any time
                                                    that CP spends on behalf of
                                                    that user doing such things as
                                                    instruction simulation or page
                                                    translation. This is in CPU
                                                    timer FORMAT. The complement of
                                                    this field is the elapsed time
                                                    in TOD clock units.
     48  30  Character    8  *                      Reserved for IBM use Previous
                                                    field is no longer meaningful.
                                                    (USEATE_VMDVFVTM)
     56  38  Character    8  *                      Reserved for IBM use Previous
                                                    field is no longer meaningful.
                                                    (USEATE_VMDVFOTM)
     64  40  Unsigned     4  USEATE_VMDCTPVR        Cardinal count of resident
                                                    pages in private address spaces
                                                    belonging to this user. This
                                                    monitor field is actually the
                                                    sum of VMDCTPVR + VMDCTPVG. To
                                                    get the count of resident pages
                                                    below the 2GB line, subtract
                                                    USEATE_VMDCTPVG from
                                                    USEATE_VMDCTPVR.
     68  44  Unsigned     4  USEATE_VMDCTPVL        Cardinal count of locked
                                                    pages in private address spaces
                                                    <2G belonging to this user. See
                                                    USEATE_VMDCTPVLA for the >2G
                                                    value.
     72  48  Unsigned     4  USEATE_VMDWSSPR        This user's projected working
                                                    set size. This is the
                                                    scheduler's estimate of the
                                                    amount of storage this user
                                                    will require to be resident as
                                                    it runs during its next stay in
                                                    the dispatch list. It is based
                                                    upon the user's past behavior
                                                    and in some cases, on the
                                                    behavior of similar types of
                                                    users.
     76  4C  Unsigned     4  USEATE_VMDCTXBK        The number of expanded
                                                    storage blocks allocated to a
                                                    virtual machine by CP for
                                                    paging
     80  50  Unsigned     4  USEATE_VMDCTFLT        Count of host segment and
                                                    page faults on guest pages
                                                    which occurred while running
                                                    this virtual CPU. It does not
                                                    include faults on RCP pages.
     84  54  Unsigned     4  *                      Reserved for IBM use Previous
                                                    field is no longer meaningful.
                                                    (USEATE_VMDCTVFL)
     88  58  Unsigned     4  USEATE_VMDCTORF        Total number of referenced
                                                    frames resident when reset was
                                                    done for this virtual system's
                                                    private address spaces
     92  5C  Unsigned     4  USEATE_CALCTPGS        Cardinal count of
                                                    non-preferred paging slots for
                                                    private address spaces
                                                    belonging to this user.
     96  60  Unsigned     4  *                      Reserved for IBM use
    100  64  Unsigned     4  USEATE_VMDCTPWT        Count of outstanding paging
                                                    and spooling I/O's for this
                                                    user
    104  68  Unsigned     4  USEATE_CALCPPGR        Cumulative count of pages
                                                    read from DASD to main storage
                                                    for this user's address spaces
                                                    while they were private.
    108  6C  Unsigned     4  USEATE_CALCPPGW        Cumulative count of pages
                                                    written from main storage to
                                                    DASD for this user's address
                                                    spaces while they were private.
    112  70  Unsigned     4  USEATE_VMDCTSPR        Number of times I/O was
                                                    issued for a spool read request
    116  74  Unsigned     4  USEATE_VMDCTSPW        Number of times I/O was
                                                    issued for a spool write
                                                    request
    120  78  Unsigned     4  USEATE_VMDPGSPL        Number of pages spooled for
                                                    this user. This includes the
                                                    pages spooled for the virtual
                                                    reader, printer, punch,
                                                    console, dump, and trace files.
    124  7C  Unsigned     4  USEATE_VMDVCSCT        Number of start requests to
                                                    the virtual machine console
    128  80  Unsigned     4  USEATE_VMDVDSCT        Cumulative count of virtual
                                                    I/O requests the virtual
                                                    machine has issued to DASD
                                                    devices
    132  84  Unsigned     4  USEATE_VMDVUSCT        Count of Start requests to
                                                    virtual Unit Record devices
    136  88  Unsigned     4  USEATE_VMDVTSCT        Count of Start requests to
                                                    virtual channel-to-channel
                                                    adapters
    140  8C  Unsigned     4  USEATE_VMDVOSCT        Count of Start requests to
                                                    devices other than console,
                                                    DASDs, CTCAs, and unit records.
                                                    (see USEATE_VMDVCSCT,
                                                    USEATE_VMDVDSCT,
                                                    USEATE_VMDVUSCT, and
                                                    USEATE_VMDVTSCT.)
    144  90  Unsigned     4  USEATE_CALCPPST        Cumulative count of pages
                                                    stolen from this user's address
                                                    spaces while they were private.
    148  94  Unsigned     4  USEATE_VMDISEVM        Number of times IUCV/APPC
                                                    data was successfully
                                                    transferred from this virtual
                                                    complex. (SENDs and REPLYs with
                                                    RC=0 when this virtual machine
                                                    is the source). Not valid in
                                                    the SYSTEM VMDBK. Valid only in
                                                    base VMDBK.
    152  98  Unsigned     4  USEATE_VMDISTVM        Number of times IUCV/APPC
                                                    data was successfully
                                                    transferred to this virtual
                                                    complex. (SENDs and REPLYs with
                                                    RC=0 when this virtual machine
                                                    is the target). Not valid in
                                                    the SYSTEM VMDBK. Valid only in
                                                    base VMDBK.
    156  9C  Unsigned     4  USEATE_VMDISUVM        Number of times IUCV/APPC
                                                    data was not successfully
                                                    transferred from this virtual
                                                    complex. (SENDs and REPLYs with
                                                    RC=0 when this virtual machine
                                                    is the source). Not valid in
                                                    the SYSTEM VMDBK. Valid only in
                                                    base VMDBK.
    160  A0  Unsigned     4  USEATE_VMDVSEVM        Number of times VMCF data was
                                                    successfully transferred by
                                                    this virtual machine. (SENDs
                                                    SENDXs, SEND/RECEIVEs, and
                                                    REPLYs with RC=0 and this
                                                    virtual machine is source.)
    164  A4  Unsigned     4  USEATE_VMDVSTVM        Number of times VMCF data was
                                                    successfully transferred to
                                                    this virtual machine. (SENDs
                                                    SENDXs, SEND/RECEIVEs, and
                                                    REPLYs with RC=0 and this
                                                    virtual machine is target.)
    168  A8  Unsigned     4  USEATE_VMDVSUVM        Number of times VMCF data was
                                                    not successfully transferred by
                                                    this virtual machine. (SENDs
                                                    SENDXs, SEND/RECEIVEs, and
                                                    REPLYs with RC^=0 and this
                                                    virtual machine is source.)
    172  AC  Unsigned     4  USEATE_VMDX98CT        Cumulative number of times
                                                    Diagnose X'98' was issued by
                                                    this virtual machine
    176  B0  Unsigned     4  USEATE_CALCPMIG        Cumulative count of pages
                                                    migrated by CP from expanded
                                                    storage to DASD for this user's
                                                    address spaces while they were
                                                    private.
    180  B4  Unsigned     4  USEATE_CALCPXWT        Cumulative count of pages
                                                    written from main storage to
                                                    expanded storage for this
                                                    user's address spaces while
                                                    they were private.
    184  B8  Unsigned     4  USEATE_CALCPXRD        Cumulative count of pages
                                                    read from expanded storage to
                                                    main storage for this user's
                                                    address spaces while they were
                                                    private.
    188  BC  Bitstring    1  USEATE_CALFLAG1        Flag byte
              1... ....      USEATE_CALBASE         If on, this is the base
                                                    VMDBK. VMDBASE
              .1.. ....      USEATE_VMDQDSPU        This user has the QUICKDSP
                                                    designation, either by default
                                                    or as set by the SET QUICKDSP
                                                    command. When the user has work
                                                    to do, it will be added to the
                                                    dispatch list immediately
                                                    without waiting in the eligible
                                                    list.
              ..1. ....      USEATE_CALDIAL         This user is a dialed user
              ...1 ....      USEATE_CALSNA          This user is connected
                                                    through System Network
                                                    Architecture (SNA)
              .... 1...      USEATE_VMDNOINS        User is prevented from
                                                    inserting any tracks into the
                                                    minidisk cache. (set when SET
                                                    MDC INS OFF command is issued)
              .... .1..      USEATE_VMDNOFSL        No MDC fair share limit
                                                    applies. Set at LOGON if the
                                                    NOMDCFS option is specified on
                                                    the OPTIONS statement in the
                                                    user's directory.
              .... ..1.      *
              .... ...1      *
    189  BD  Bitstring    1  USEATE_VMDSTYPE        Storage type this virtual
                                                    machine resides in. X'00' =>
                                                    V=V. X'80' => Reserved and no
                                                    longer available. X'40' => V=F.
    190  BE  Bitstring    1  USEATE_CALSHARF        Set Share flags
              1... ....      USEATE_VMDMXSHA        Max share is Absolute if ON.
                                                    Max share is Relative if OFF.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      USEATE_VMDLIMTH        Max share is Limithard if ON.
                                                    Max share is Limitsoft if OFF.
              .... ...1      *
    191  BF  Unsigned     1  *                      Reserved and available for
                                                    IBM use.
    192  C0  Unsigned     4  USEATE_VMDBLKCT        Count of SSCH's issued by
                                                    BLOCKIO system service
                                                    (includes both read and write
                                                    requests)
    196  C4  Unsigned     4  USEATE_VMDMDCIA        Count of SSCH's avoided due
                                                    to Minidisk Cache read hit
    200  C8  Unsigned     4  USEATE_VMDCOPCT        Number of times this virtual
                                                    CPU had to be redispatched due
                                                    to a crypto operation exception
    204  CC  Unsigned     4  USEATE_VMDCTISO        Number of times ISOLATE
                                                    occurred for spaces owned by
                                                    this virtual system. Valid only
                                                    in base VMDBK
    208  D0  Unsigned     4  USEATE_VMDRELSH        This user's RELATIVE share of
                                                    the system, as set in the
                                                    user's directory or via the SET
                                                    SHARE command. Set to zero if
                                                    the user is an ABSOLUTE share
                                                    user, or if this VMDBK has a
                                                    virtual processor dedicated to
                                                    it, and the user is a virtual
                                                    MP user. Set to a negative
                                                    value if VMDBK has a virtual
                                                    processor dedicated to it, and
                                                    the user is a virtual UP user.
    212  D4  Unsigned     4  USEATE_VMDABSSH        This user's ABSOLUTE share of
                                                    the system, as set in the
                                                    user's directory or via the SET
                                                    SHARE command. Unit of value is
                                                    a hexadecimal factor scaled 16
                                                    bits. For example,
                                                    X'00010000'=1.00(100%),
                                                    X'0000C000'=0.75(75%),
                                                    X'00008000'=0.50(50%), etc. Set
                                                    to zero if user is a RELATIVE
                                                    share user.
    216  D8  Unsigned     4  USEATE_VMDSSIZE        Virtual machine size, in
                                                    bytes. This field is kept for
                                                    compatability reasons, but may
                                                    not be accurate for z/Arch
                                                    systems where larger virtual
                                                    machines are valid. The
                                                    preferred field is
                                                    USEATE_ASCDEFSZ
    220  DC  Unsigned     4  USEATE_VMDMXRVP        Number of pages reserved for
                                                    the user
    224  E0  Character    8  USEATE_VMDACTNO        User accounting number
    232  E8  Character    8  USEATE_VMDGRPN         RACF ACI group name
    240  F0  Character    8  USEATE_CALTODON        Time at which the user logged
                                                    on for this session. In
                                                    time-of-day (TOD) clock format.
                                                    To get the user's connect time,
                                                    subtract this time value from
                                                    the time stamp in the record
                                                    header's MRHDRTOD.
    248  F8  Unsigned     4  USEATE_VMDVDISK        Count of virtual I/Os to a
                                                    virtual disk in storage.
    252  FC  Unsigned     4  USEATE_VMDMXSHR        The user's Max share of the
                                                    system, as set in the user's
                                                    directory or via the SET SHARE
                                                    command. This value is set to
                                                    zero if no Max share exists. If
                                                    the Max share is Absolute, then
                                                    the unit of the value is a
                                                    hexadecimal factor scaled 16
                                                    bits. For example, X'00010000'
                                                    = 1.00(100%), X'0000C000' =
                                                    0.75(75%), X'00008000' =
                                                    0.50(50%), etc. Check
                                                    USEATE_VMDMXSHA to determine if
                                                    Max share is absolute or
                                                    relative.
    256 100  Character    8  USEATE_ASCDEFSZ        Defined storage size in
                                                    addressable bytes, minus one.
                                                    If DEF STOR CONFIG was used to
                                                    define multiple discontiguous
                                                    extents of addressable defined
                                                    storage, this field contains
                                                    the sum of the sizes in bytes
                                                    of all of the individual
                                                    extents (minus one). The minus
                                                    one notation is used so that a
                                                    total size of 16 Exabytes may
                                                    be represented without
                                                    ambiguity (as
                                                    x'FFFFFFFF_FFFFFFFF').
    256 100  Character    4  USEATE_CALDEFHI        high four bytes
    260 104  Character    4  USEATE_CALDEFLO        low four bytes
    264 108  Unsigned     4  USEATE_VMDCTPVG        Count of private address
                                                    space resident pages in DPA
                                                    owned by this virtual machine
                                                    which are >= 2G. Valid only in
                                                    base VMDBK.
    268 10C  Unsigned     4  USEATE_VMDMVB2G        Number of times page
                                                    translation moved a page on
                                                    behalf of this us user from a
                                                    frame with address >= 2GB to
                                                    one < 2GB. This field is only
                                                    valid in the base VMDBK.
    272 110  Unsigned     4  USEATE_VEBALERT        Number of alert interruptions
                                                    Collected only for base VMDBK.
    276 114  Unsigned     4  USEATE_VEBTVSCT        Number of interceptions for
                                                    guest TVS instructions
                                                    Collected only for base VMDBK.
    280 118  Unsigned     4  USEATE_VEBSVSCT        Number of interceptions for
                                                    guest SVS instructions
                                                    Collected only for base VMDBK.
    284 11C  Unsigned     4  USEATE_VEBTPIAI        Number of adapter
                                                    interruptions delivered via
                                                    guest TPI Collected only for
                                                    base VMDBK.
    288 120  Unsigned     4  USEATE_VEBVIRAI        Number of adapter
                                                    interruptions stacked for guest
                                                    by CP Collected only for base
                                                    VMDBK.
    292 124  Unsigned     4  USEATE_VEBHDWAI        Number of adapter
                                                    interruptions delivered to
                                                    guest inside SIE Collected only
                                                    for base VMDBK.
    296 128  Character    8  USEATE_VMDCTPVLA       Cardinal count of locked
                                                    pages in private address spaces
                                                    >2G belonging to this user. See
                                                    USEATE_VMDCTPVL for the <2G
                                                    value.
    304 130  Unsigned     4  USEATE_VMDCTSHL        Count of shared address space
                                                    resident pages <2G. Valid only
                                                    in the SYSTEM VMDBK.
    308 134  Character    8  USEATE_VMDCTSHLA       Count of shared address space
                                                    resident pages >2G. Valid only
                                                    in the SYSTEM VMDBK.
    316 13C  Character    0  USEATE_END

    MRUSEATE Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    MRHDR                      0     20
    MRHDR_END                 14      0
    MRHDRDM                    4      1
    MRHDRLEN                   0      2
    MRHDRRC                    6      2
    MRHDRTOD                   8      8
    MRHDRZER                   2      2
    USEATE                     0    316
    USEATE_ASCDEFSZ          100      8
    USEATE_CALBASE            BC           80
    USEATE_CALCPMIG           B0      4
    USEATE_CALCPPGR           68      4
    USEATE_CALCPPGW           6C      4
    USEATE_CALCPPST           90      4
    USEATE_CALCPXRD           B8      4
    USEATE_CALCPXWT           B4      4
    USEATE_CALCTPGS           5C      4
    USEATE_CALDEFHI          100      4
    USEATE_CALDEFLO          104      4
    USEATE_CALDIAL            BC           20
    USEATE_CALFLAG1           BC      1
    USEATE_CALMESA            1F           40
    USEATE_CALMESAM           1F           04
    USEATE_CALMODE            1F      1
    USEATE_CALMXA             1F           20
    USEATE_CALMXC             1F           08
    USEATE_CALM370            1F           10
    USEATE_CALSHARF           BE      1
    USEATE_CALSNA             BC           10
    USEATE_CALTODON           F0      8
    USEATE_END               13C      0
    USEATE_MRHDR               0      0
    USEATE_VEBALERT          110      4
    USEATE_VEBHDWAI          124      4
    USEATE_VEBSVSCT          118      4
    USEATE_VEBTPIAI          11C      4
    USEATE_VEBTVSCT          114      4
    USEATE_VEBVIRAI          120      4
    USEATE_VMDABSSH           D4      4
    USEATE_VMDACTNO           E0      8
    USEATE_VMDBLKCT           C0      4
    USEATE_VMDCOPCT           C8      4
    USEATE_VMDCPUAD           1C      2
    USEATE_VMDCTFLT           50      4
    USEATE_VMDCTISO           CC      4
    USEATE_VMDCTORF           58      4
    USEATE_VMDCTPVG          108      4
    USEATE_VMDCTPVL           44      4
    USEATE_VMDCTPVLA         128      8
    USEATE_VMDCTPVR           40      4
    USEATE_VMDCTPWT           64      4
    USEATE_VMDCTSHL          130      4
    USEATE_VMDCTSHLA         134      8
    USEATE_VMDCTSPR           70      4
    USEATE_VMDCTSPW           74      4
    USEATE_VMDCTXBK           4C      4
    USEATE_VMDGRPN            E8      8
    USEATE_VMDISEVM           94      4
    USEATE_VMDISTVM           98      4
    USEATE_VMDISUVM           9C      4
    USEATE_VMDLIMTH           BE           02
    USEATE_VMDMDCIA           C4      4
    USEATE_VMDMODE            1E      1
    USEATE_VMDMVB2G          10C      4
    USEATE_VMDMXRVP           DC      4
    USEATE_VMDMXSHA           BE           80
    USEATE_VMDMXSHR           FC      4
    USEATE_VMDNOFSL           BC           04
    USEATE_VMDNOINS           BC           08
    USEATE_VMDPGSPL           78      4
    USEATE_VMDQDSPU           BC           40
    USEATE_VMDRELSH           D0      4
    USEATE_VMDSSIZE           D8      4
    USEATE_VMDSTYPE           BD      1
    USEATE_VMDTTIME           20      8
    USEATE_VMDUSER            14      8
    USEATE_VMDVCSCT           7C      4
    USEATE_VMDVDISK           F8      4
    USEATE_VMDVDSCT           80      4
    USEATE_VMDVOSCT           8C      4
    USEATE_VMDVSEVM           A0      4
    USEATE_VMDVSTVM           A4      4
    USEATE_VMDVSUVM           A8      4
    USEATE_VMDVTIME           28      8
    USEATE_VMDVTSCT           88      4
    USEATE_VMDVUSCT           84      4
    USEATE_VMDWSSPR           48      4
    USEATE_VMDX98CT           AC      4

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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005