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  352  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.      USEATE_VMDMASST        Collaborative Memory
                                                Management assist enabled.
          .... ...1      USEATE_VMDMAACT        Collaborative Memory
                                                Management assist is active,
                                                i.e. in use by this virtual
                                                machine. Note: This guest may
                                                be in a pending off state if
                                                either a global or per-user SET
                                                MEMASSIST OFF has been issued
                                                (SYSMASST or VMDMASST is off).
                                                This indicates that the system
                                                or user setting was turned off
                                                after the guest started using
                                                the assist. The assist will
                                                remain active
                                                (USEATE_VMDMAACT=1) and
                                                available to this guest until
                                                the next virtual machine reset
                                                or IPL.
189  BD  Bitstring    1  USEATE_VMDSTYPE        Storage type this virtual
                                                machine resides in. X'00' =>
                                                V=V. X'80' => Reserved and no
                                                longer available. X'40' => V=F.
190  BE  Bitstring    1  USEATE_CALSHARF        Set Share flags
          1... ....      USEATE_VMDMXSHA        Max share is Absolute if ON.
                                                Max share is Relative if OFF.
          .1.. ....      USEATE_VMDSTOP         This virtual CPU is in soft
                                                stop
          ..1. ....      USEATE_VMDSTOPD        This virtual CPU is stopped
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      USEATE_VMDLIMTH        Max share is Limithard if ON.
                                                Max share is Limitsoft if OFF.
          .... ...1      *                      
191  BF  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 virtual CPU's RELATIVE
                                                share of the system, as set in
                                                the user's directory or via the
                                                SET SHARE command. Set to zero
                                                when this VMDBK has an ABSOLUTE
                                                share value, or has a virtual
                                                processor dedicated to it, or
                                                is in the process of being
                                                logged off.
212  D4  Unsigned     4  USEATE_VMDABSSH        This virtual CPU's ABSOLUTE
                                                share of the system, as set in
                                                the user's directory or via the
                                                SET SHARE command. Unit of
                                                value is a hexadecimal factor
                                                scaled 16 bits. For example,
                                                X'00010000' = 1.00(100%),
                                                X'0000C000' = 0.75(75%),
                                                X'00008000' = 0.50(50%), etc.
                                                Set to zero when this VMDBK has
                                                a RELATIVE share value.
216  D8  Unsigned     4  USEATE_VMDSSIZE        Virtual machine size, in
                                                bytes. This field is kept for
                                                compatability reasons, but may
                                                not be accurate for z/Arch
                                                systems where larger virtual
                                                machines are valid. The
                                                preferred field is
                                                USEATE_ASCDEFSZ
220  DC  Unsigned     4  USEATE_VMDMXRVP        Number of pages reserved for
                                                the user
224  E0  Character    8  USEATE_VMDACTNO        User accounting number
232  E8  Character    8  USEATE_VMDGRPN         RACF ACI group name
240  F0  Character    8  USEATE_CALTODON        Time at which the user logged
                                                on for this session. In
                                                time-of-day (TOD) clock format.
                                                To get the user's connect time,
                                                subtract this time value from
                                                the time stamp in the record
                                                header's MRHDRTOD.
248  F8  Unsigned     4  USEATE_VMDVDISK        Count of virtual I/Os to a
                                                virtual disk in storage.
252  FC  Unsigned     4  USEATE_VMDMXSHR        The virtual CPU's Max share
                                                of the system, as set in the
                                                user's directory or via the SET
                                                SHARE command. This value is
                                                set to zero if no Max share
                                                exists. If the Max share is
                                                Absolute, then the unit of the
                                                value is a hexadecimal factor
                                                scaled 16 bits. For example,
                                                X'00010000' = 1.00(100%),
                                                X'0000C000' = 0.75(75%),
                                                X'00008000' = 0.50(50%), etc.
                                                Check USEATE_VMDMXSHA to
                                                determine if Max share is
                                                absolute or relative. This
                                                field should not be used if
                                                USEATE_VMDSTOP is on.
256 100  Character    8  USEATE_ASCDEFSZ        Defined storage size in
                                                addressable bytes, minus one.
                                                If DEF STOR CONFIG was used to
                                                define multiple discontiguous
                                                extents of addressable defined
                                                storage, this field contains
                                                the sum of the sizes in bytes
                                                of all of the individual
                                                extents (minus one). The minus
                                                one notation is used so that a
                                                total size of 16 Exabytes may
                                                be represented without
                                                ambiguity (as
                                                x'FFFFFFFF_FFFFFFFF').
256 100  Character    4  USEATE_CALDEFHI        high four bytes
260 104  Character    4  USEATE_CALDEFLO        low four bytes
264 108  Unsigned     4  USEATE_VMDCTPVG        Count of private address
                                                space resident pages in DPA
                                                owned by this virtual machine
                                                which are >= 2G. Valid only in
                                                base VMDBK.
268 10C  Unsigned     4  USEATE_VMDMVB2G        Number of times page
                                                translation moved a page on
                                                behalf of this us user from a
                                                frame with address >= 2GB to
                                                one < 2GB. This field is only
                                                valid in the base VMDBK.
272 110  Unsigned     4  USEATE_VEBALERT        Number of alert interruptions
                                                Collected only for base VMDBK.
276 114  Unsigned     4  USEATE_VEBTVSCT        Number of interceptions for
                                                guest TVS instructions
                                                Collected only for base VMDBK.
280 118  Unsigned     4  USEATE_VEBSVSCT        Number of interceptions for
                                                guest SVS instructions
                                                Collected only for base VMDBK.
284 11C  Unsigned     4  USEATE_VEBTPIAI        Number of adapter
                                                interruptions delivered via
                                                guest TPI Collected only for
                                                base VMDBK.
288 120  Unsigned     4  USEATE_VEBVIRAI        Number of adapter
                                                interruptions stacked for guest
                                                by CP Collected only for base
                                                VMDBK.
292 124  Unsigned     4  USEATE_VEBHDWAI        Number of adapter
                                                interruptions delivered to
                                                guest inside SIE Collected only
                                                for base VMDBK.
296 128  Character    8  USEATE_VMDCTPVLA       Cardinal count of locked
                                                pages in private address spaces
                                                >2G belonging to this user. See
                                                USEATE_VMDCTPVL for the <2G
                                                value.
304 130  Unsigned     4  USEATE_VMDCTSHL        Count of shared address space
                                                resident pages <2G. Valid only
                                                in the SYSTEM VMDBK.
308 134  Character    8  USEATE_VMDCTSHLA       Count of shared address space
                                                resident pages >2G. Valid only
                                                in the SYSTEM VMDBK.
316 13C  Unsigned     1  USEATE_VMDPUTYP        CPU Type. Valid values: X'00'
                                                - General Purpose (CP) X'02' -
                                                zSeries Application Assist
                                                (zAAP) X'03' - Integrated
                                                Facility for Linux (IFL) X'04'
                                                - Internal Coupling Facility
                                                (ICF) X'05' - zSeries
                                                Integrated Information (zIIP)
317 13D  Bitstring    1  USEATE_VMDCFGEM        Virtual configuration
                                                indicators. Valid in base VMDBK
                                                only
          1... ....      *                      
          .1.. ....      USEATE_VMDCPUAF        User requested CPU Affinity
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
318 13E  Bitstring    1  USEATE_VMDPUST         CPU Status flag
          1... ....      USEATE_VMDAFSUP        CPU Affinity suppressed
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
319 13F  Character    1  *                      Reserved for IBM use
320 140  Character    8  USEATE_VMDVTMP         Total virtual time for user
                                                on primary processor
328 148  Character    8  USEATE_VMDTTMP         Total virtual and simulation
                                                time for the user on primary
                                                processor
336 150  Character    8  USEATE_VMDVTMS         Total virtual time for user
                                                on secondary processor
344 158  Character    8  USEATE_VMDTTMS         Total virtual and simulation
                                                time for the user on secondary
                                                processor
352 160  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    352
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               160      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_VMDAFSUP          13E           80
USEATE_VMDBLKCT           C0      4
USEATE_VMDCFGEM          13D      1
USEATE_VMDCOPCT           C8      4
USEATE_VMDCPUAD           1C      2
USEATE_VMDCPUAF          13D           40
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_VMDMAACT           BC           01
USEATE_VMDMASST           BC           02
USEATE_VMDMDCIA           C4      4
USEATE_VMDMODE            1E      1
USEATE_VMDMVB2G          10C      4
USEATE_VMDMXRVP           DC      4
USEATE_VMDMXSHA           BE           80
USEATE_VMDMXSHR           FC      4
USEATE_VMDNOFSL           BC           04
USEATE_VMDNOINS           BC           08
USEATE_VMDPGSPL           78      4
USEATE_VMDPUST           13E      1
USEATE_VMDPUTYP          13C      1
USEATE_VMDQDSPU           BC           40
USEATE_VMDRELSH           D0      4
USEATE_VMDSSIZE           D8      4
USEATE_VMDSTOP            BE           40
USEATE_VMDSTOPD           BE           20
USEATE_VMDSTYPE           BD      1
USEATE_VMDTTIME           20      8
USEATE_VMDTTMP           148      8
USEATE_VMDTTMS           158      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_VMDVTMP           140      8
USEATE_VMDVTMS           150      8
USEATE_VMDVTSCT           88      4
USEATE_VMDVUSCT           84      4
USEATE_VMDWSSPR           48      4
USEATE_VMDX98CT           AC      4

This information is based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008