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

MRUSEACT

Prolog
Control Block Contents
Storage Layout
Cross Reference

MRUSEACT Prolog

 DSECT NAME - USEACT
 FUNCTION - Map a Monitor record.
 LOCATED BY -
      Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
      MRRECHDR    Monitor Record Header
 NAME - MRUSEACT
 DESCRIPTIVE NAME - Monitor Sample Record
                  Domain 4 - User Domain
                  Record 3 - User Activity Data
 DESCRIPTION - User activity data.  Generated for each virtual
             processor in a virtual configuration.


MRUSEACT Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)         Description
 
  0   0  Structure  308  USEACT              Start of monitor record
  0   0  Character    0  USEACT_MRHDR        Record header. See MRRECHDR for
                                             details.
  0   0  Character   20  MRHDR               
  0   0  Unsigned     2  MRHDRLEN            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  USEACT_VMDUSER      Userid
 28  1C  Unsigned     2  USEACT_VMDCPUAD     Processor ID/CPU address of
                                             virtual processor
 30  1E  Bitstring    1  USEACT_VMDMODE      Guest machine mode. This is as
                                             set for internal use by CP. See
                                             USEACT_CALMODE for the mode
                                             'calculated' at.
 31  1F  Bitstring    1  USEACT_CALMODE      Architectural mode of the
                                             virtual machine
          1... ....      *                   
          .1.. ....      USEACT_CALMESA      ESA architecture
          ..1. ....      USEACT_CALMXA       XA architecture
          ...1 ....      USEACT_CALM370      370 architecture
          .... 1...      USEACT_CALMXC       XC architecture
          .... .1..      USEACT_CALMESAM     ESA mode machine has entered
                                             64-bit mode.
          .... ..1.      *                   
          .... ...1      *                   
 32  20  Bitstring    1  USEACT_VMDSLIST     Scheduling list that the user is
                                             in: X'37' = Dispatch List. X'21' =
                                             Eligible List. X'0B' = Dormant
                                             List. X'00' = user is not in any
                                             list.
 33  21  Unsigned     1  USEACT_VMDELIST     Class number (0,1,2,or 3) of the
                                             scheduling list the user is in
 34  22  Bitstring    1  USEACT_CALFLAG1     Flag byte
          1... ....      USEACT_CALBASE      If on, this is the base VMDBK.
                                             VMDBASE
          .1.. ....      USEACT_VMDQDSPU     This user has the QUICKDSP
                                             designation, as set or defaulted
                                             by the SET QUICKDSP command. When
                                             the user has work to do, it will
                                             be added to the dispatch list
                                             immediately without waiting in the
                                             eligible list.
          ..1. ....      USEACT_CALDIAL      This user is a dialed user
          ...1 ....      USEACT_CALSNA       This user is connected through
                                             System Network Architecture (SNA)
          .... 1...      USEACT_VMDNOINS     User is prevented from inserting
                                             any tracks into the minidisk
                                             cache. (set when SET MDC INS OFF
                                             command is issued)
          .... .1..      USEACT_VMDNOFSL     No MDC fair share limit applies.
                                             Set at LOGON if the NOMDCFS option
                                             is specified on the OPTIONS
                                             statement in the user's directory.
          .... ..1.      *                   
          .... ...1      *                   
 35  23  Bitstring    1  USEACT_VMDSTYPE     Storage type this virtual
                                             machine resides in. X'00' => V=V.
                                             X'80' => V=R. X'40' => V=F.
 36  24  Character    8  USEACT_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.
 44  2C  Character    8  USEACT_VMDVTIME     Total time that this user was
                                             running and doing productive work.
                                             It does NOT include any time that
                                             CP spends on behalf of that user
                                             doing such things as instruction
                                             simulation or page translation.
                                             This is in CPU timer format. The
                                             complement of this field is the
                                             elapsed time in TOD clock units.
 52  34  Character    8  USEACT_VMDVFVTM     Amount of time, in TOD clock
                                             units, that is consumed by the
                                             guest using vector instructions
                                             while in SIE
 60  3C  Character    8  USEACT_VMDVFOTM     Amount of time, in TOD clock
                                             units, consumed by the system to
                                             support this guest's loading and
                                             unloading of its virtual vector
                                             facility.
 68  44  Unsigned     4  USEACT_VMDCTPVR     Cardinal count of resident pages
                                             in private address spaces
                                             belonging to this user. This
                                             monitor field is actually the sum
                                             of VMDCTPVR + VMDCTPVG. To get the
                                             count of resident pages below the
                                             2GB line, subtract USEACT_VMDCTPVG
                                             from USEACT_VMDCTPVR.
 72  48  Unsigned     4  USEACT_VMDCTPVL     Cardinal count of locked pages
                                             in private address spaces
                                             belonging to this user.
 76  4C  Unsigned     4  USEACT_VMDWSSPR     This user's projected working
                                             set size. This is the scheduler's
                                             estimate of the amount of storage
                                             this user will require to be
                                             resident as it runs during its
                                             next stay in the dispatch list. It
                                             is based upon the user's past
                                             behavior and in some cases, on the
                                             behavior of similar types of
                                             users.
 80  50  Unsigned     4  USEACT_VMDCTXBK     Number of expanded storage
                                             blocks allocated to a virtual
                                             machine by CP for paging.
 84  54  Unsigned     4  USEACT_CALXSTOR     Size, in megabytes, of expanded
                                             storage attached to the user. If
                                             zero, no expanded storage is
                                             attached. VMDXSTOR
 88  58  Unsigned     4  USEACT_VMDCTFLT     Count of host segment and page
                                             faults on guest pages which
                                             occurred while running this
                                             virtual CPU. It does not include
                                             faults on RCP pages.
 92  5C  Unsigned     4  USEACT_VMDCTVFL     Number of times this virtual
                                             system's vector facility was
                                             loaded into a real vector
                                             facility. If the virtual vector
                                             facility is currently loaded, this
                                             count would be approximately equal
                                             to the number of saves.
 96  60  Unsigned     4  USEACT_VMDFLREO     Total number of frame list
                                             reorders for this virtual system's
                                             private address spaces
100  64  Unsigned     4  USEACT_VMDCTORF     Total number of referenced
                                             frames resident when reset was
                                             done for this virtual system's
                                             private address spaces
104  68  Unsigned     4  USEACT_CALCTPGS     Cardinal count of non-preferred
                                             paging slots for private address
                                             spaces belonging to this user.
108  6C  Unsigned     4  *                   Reserved for IBM use
112  70  Unsigned     4  USEACT_VMDCTPWT     Count of outstanding paging and
                                             spooling I/O's for this user
116  74  Unsigned     4  USEACT_CALCPPGR     Cumulative count of pages read
                                             from DASD to main storage for this
                                             user's address spaces while they
                                             were private.
120  78  Unsigned     4  USEACT_CALCPPGW     Cumulative count of pages
                                             written from main storage to DASD
                                             for this user's address spaces
                                             while they were private.
124  7C  Unsigned     4  USEACT_VMDCTSPR     Number of times I/O was issued
                                             for a spool read request
128  80  Unsigned     4  USEACT_VMDCTSPW     Number of times I/O was issued
                                             for a spool write request
132  84  Unsigned     4  USEACT_VMDPGSPL     Number of pages spooled for this
                                             user. This includes the pages
                                             spooled for the virtual reader,
                                             printer, punch, console, dump, and
                                             trace files.
136  88  Unsigned     4  USEACT_VMDVCSCT     Count of start requests to the
                                             virtual machine console
140  8C  Unsigned     4  USEACT_VMDVDSCT     Cumulative count of virtual I/O
                                             requests the virtual machine has
                                             issued to DASD devices
144  90  Unsigned     4  USEACT_VMDVUSCT     Count of Start requests to
                                             virtual Unit Record devices
148  94  Unsigned     4  USEACT_VMDVTSCT     Count of Start requests to
                                             virtual channel-to-channel
                                             adapters
152  98  Unsigned     4  USEACT_VMDVOSCT     Count of Start requests to
                                             devices other than console, DASDs,
                                             CTCAs, and unit records. (see
                                             USEACT_VMDVCSCT, USEACT_VMDVDSCT,
                                             USEACT_VMDVUSCT, and
                                             USEACT_VMDVTSCT)
156  9C  Unsigned     4  USEACT_CALCPPST     Cumulative count of pages stolen
                                             from this user's address spaces
                                             while they were private.
160  A0  Unsigned     4  USEACT_VMDISEVM     Number of times IUCV data was
                                             successfully transferred by this
                                             virtual complex. (SENDs and REPLYs
                                             with RC=0 when this virtual
                                             machine is the source). Not valid
                                             in the SYSTEM VMDBK. Valid only in
                                             base VMDBK.
164  A4  Unsigned     4  USEACT_VMDISTVM     Number of times IUCV data was
                                             successfully transferred to this
                                             virtual complex. (SENDs and REPLYs
                                             with RC=0 when this virtual
                                             machine is the target). Not valid
                                             in the SYSTEM VMDBK. Valid only in
                                             base VMDBK.
168  A8  Unsigned     4  USEACT_VMDISUVM     Number of times IUCV data was
                                             NOT successfully transferred by
                                             this virtual complex. (SENDs and
                                             REPLYs with RC^=0 when this
                                             virtual machine is the source).
                                             Not valid in the SYSTEM VMDBK.
                                             Valid only in base VMDBK.
172  AC  Unsigned     4  USEACT_VMDVSEVM     Number of times VMCF data was
                                             successfully transferred by this
                                             virtual machine. (SENDs SENDXs,
                                             SEND/RECEIVEs, and REPLYs with
                                             RC=0 and this virtual machine is
                                             source.)
176  B0  Unsigned     4  USEACT_VMDVSTVM     Number of times VMCF data was
                                             successfully transferred to this
                                             virtual machine. (SENDs SENDXs,
                                             SEND/RECEIVEs, and REPLYs with
                                             RC=0 and this virtual machine is
                                             target.)
180  B4  Unsigned     4  USEACT_VMDVSUVM     Number of times VMCF data was
                                             NOT successfully transferred by
                                             this virtual machine. (SENDs
                                             SENDXs, SEND/RECEIVEs, and REPLYs
                                             with RC^=0 and this virtual
                                             machine is source.)
184  B8  Signed       4  USEACT_CALIUCVS     Cardinal count of messages on
                                             the IUCV SEND queue. The SEND
                                             queue consists of messages sent to
                                             this user either by another user
                                             or by a CP System Service. Note: A
                                             zero value may mean that the data
                                             could not be obtained as well as
                                             that there weren't any messages.
188  BC  Signed       4  USEACT_CALIUCVR     Cardinal count of messages on
                                             the IUCV RECEIVE queue which
                                             consists of messages this user has
                                             received from other users or CP
                                             System Services, but has not yet
                                             replied to. Note: A zero value may
                                             mean that the data could not be
                                             obtained as well as that there
                                             were not any messages.
192  C0  Signed       4  USEACT_CALIUCVY     Cardinal count of messages on
                                             the IUCV REPLY queue which
                                             consists of replies to messages
                                             this user sent either to other
                                             users or to CP System Services.
                                             Note: A zero value may mean that
                                             the data could not be obtained as
                                             well as that there were not any
                                             messages.
196  C4  Signed       4  USEACT_CALVMCF      Cardinal count of messages on
                                             the VMCF queue. Note: A zero value
                                             may mean that the data could not
                                             be obtained as well as that there
                                             were not any messages.
200  C8  Unsigned     4  USEACT_VMDX98CT     Cumulative number of times
                                             Diagnose X'98' was issued by this
                                             virtual machine
204  CC  Unsigned     4  USEACT_CALCPMIG     Cumulative count of pages
                                             migrated by CP from expanded
                                             storage to DASD for this user's
                                             address spaces while they were
                                             private.
208  D0  Unsigned     4  USEACT_CALCPXWT     Cumulative count of pages
                                             written from main storage to
                                             expanded storage for this user's
                                             address spaces while they were
                                             private.
212  D4  Unsigned     4  USEACT_CALCPXRD     Cumulative count of pages read
                                             from expanded storage to main
                                             storage for this user's address
                                             spaces while they were private.
216  D8  Unsigned     2  USEACT_VMDASMCT     Cardinal number of non-base
                                             address spaces owned by this user.
218  DA  Bitstring    1  USEACT_CALSHARF     Set Share flags
          1... ....      USEACT_VMDMXSHA     Max share is Absolute if ON. Max
                                             share is Relative if OFF.
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      USEACT_VMDLIMTH     Max Share is Limithard if ON.
                                             Max Share is Limitsoft if OFF.
          .... ...1      *                   
219  DB  Unsigned     1  *                   Reserved and available for IBM
                                             use.
220  DC  Unsigned     4  USEACT_VMDBLKCT     Count of SSCH's issued by
                                             BLOCKIO system service (includes
                                             both read and write requests)
224  E0  Unsigned     4  USEACT_VMDMDCIA     Count of SSCH's avoided due to
                                             Minidisk Cache read hit
228  E4  Unsigned     4  USEACT_VMDCOPCT     Number of times this virtual CPU
                                             had to be redispatched due to a
                                             crypto operation exception
232  E8  Unsigned     4  USEACT_VMDCTISO     Number of times ISOLATE occurred
                                             for spaces owned by this virtual
                                             system. Valid only in base VMDBK
236  EC  Unsigned     4  USEACT_VMDRELSH     This 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.
240  F0  Unsigned     4  USEACT_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.
244  F4  Unsigned     4  USEACT_VMDSSIZE     Virtual machine size, in bytes.
                                             This field is kept for
                                             compatability reasons, but may not
                                             be accurate for 64-bit systems
                                             where larger virtual machines are
                                             valid. The preferred field is
                                             USEACT_ASCDEFSZ
248  F8  Unsigned     4  USEACT_VMDMXRVP     Number of pages reserved for the
                                             user
252  FC  Character    8  USEACT_VMDACTNO     User accounting number
260 104  Character    8  USEACT_VMDGRPN      RACF ACI group name
268 10C  Character    8  USEACT_CALTODON     Time at which the user logged on
                                             for this session. In time-of-day
                                             (TOD) clock format. To get the
                                             user's connect time, subtract this
                                             time value from the time stamp in
                                             the record header's MRHDRTOD.
276 114  Unsigned     4  USEACT_VMDVDISK     Count of virtual I/Os to a
                                             virtual disk in storage.
280 118  Unsigned     4  USEACT_VMDMXSHR     The 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 USEACT_VMDMXSHA to determine
                                             if Max share is absolute or
                                             relative.
284 11C  Unsigned     4  USEACT_VMDTHRCT     Total number of times this user
                                             was delayed doing I/O to a
                                             throttled device
288 120  Unsigned     2  USEACT_IUCTOTCN     Total number of connections for
                                             IUCV. Valid only for base VMDKBK
290 122  Unsigned     2  USEACT_IUCMXCN      Maximum number of connections
                                             from the MAXCONN directory option
                                             or the system default.
292 124  Unsigned     4  USEACT_VMDCTPVG     Count of private address space
                                             resident pages in DPA owned by
                                             this virtual machine which are >=
                                             2G. Valid only in base VMDBK.
296 128  Character    8  USEACT_ASCDEFSZ     Defined storage size in
                                             addressable bytes, minus one. If
                                             DEF STOR CONFIG was used to define
                                             multiple discontiguous extents of
                                             addressable defined storage, this
                                             field contains the sum of the
                                             sizes in bytes of all of the
                                             individual extents (minus one).
                                             The minus one notation is used so
                                             that a total size of 16 Exabytes
                                             may be represented without
                                             ambiguity (as
                                             x'FFFFFFFF_FFFFFFFF').
296 128  Character    4  USEACT_CALDEFHI     high four bytes
300 12C  Character    4  USEACT_CALDEFLO     low four bytes
304 130  Unsigned     4  USEACT_VMDMVB2G     Number of times page translation
                                             moved a page on behalf of this us
                                             user from a frame with address >=
                                             2GB to one < 2GB. This field is
                                             only valid in the base VMDBK.
308 134  Character    0  USEACT_END          

MRUSEACT Cross Reference

                      Hex           Hex
Name                 Offset Length Value
 
MRHDR                   0     20
MRHDR_END              14      0
MRHDRDM                 4      1
MRHDRLEN                0      2
MRHDRRC                 6      2
MRHDRTOD                8      8
MRHDRZER                2      2
USEACT                  0    308
USEACT_ASCDEFSZ       128      8
USEACT_CALBASE         22           80
USEACT_CALCPMIG        CC      4
USEACT_CALCPPGR        74      4
USEACT_CALCPPGW        78      4
USEACT_CALCPPST        9C      4
USEACT_CALCPXRD        D4      4
USEACT_CALCPXWT        D0      4
USEACT_CALCTPGS        68      4
USEACT_CALDEFHI       128      4
USEACT_CALDEFLO       12C      4
USEACT_CALDIAL         22           20
USEACT_CALFLAG1        22      1
USEACT_CALIUCVR        BC      4
USEACT_CALIUCVS        B8      4
USEACT_CALIUCVY        C0      4
USEACT_CALMESA         1F           40
USEACT_CALMESAM        1F           04
USEACT_CALMODE         1F      1
USEACT_CALMXA          1F           20
USEACT_CALMXC          1F           08
USEACT_CALM370         1F           10
USEACT_CALSHARF        DA      1
USEACT_CALSNA          22           10
USEACT_CALTODON       10C      8
USEACT_CALVMCF         C4      4
USEACT_CALXSTOR        54      4
USEACT_END            134      0
USEACT_IUCMXCN        122      2
USEACT_IUCTOTCN       120      2
USEACT_MRHDR            0      0
USEACT_VMDABSSH        F0      4
USEACT_VMDACTNO        FC      8
USEACT_VMDASMCT        D8      2
USEACT_VMDBLKCT        DC      4
USEACT_VMDCOPCT        E4      4
USEACT_VMDCPUAD        1C      2
USEACT_VMDCTFLT        58      4
USEACT_VMDCTISO        E8      4
USEACT_VMDCTORF        64      4
USEACT_VMDCTPVG       124      4
USEACT_VMDCTPVL        48      4
USEACT_VMDCTPVR        44      4
USEACT_VMDCTPWT        70      4
USEACT_VMDCTSPR        7C      4
USEACT_VMDCTSPW        80      4
USEACT_VMDCTVFL        5C      4
USEACT_VMDCTXBK        50      4
USEACT_VMDELIST        21      1
USEACT_VMDFLREO        60      4
USEACT_VMDGRPN        104      8
USEACT_VMDISEVM        A0      4
USEACT_VMDISTVM        A4      4
USEACT_VMDISUVM        A8      4
USEACT_VMDLIMTH        DA           02
USEACT_VMDMDCIA        E0      4
USEACT_VMDMODE         1E      1
USEACT_VMDMVB2G       130      4
USEACT_VMDMXRVP        F8      4
USEACT_VMDMXSHA        DA           80
USEACT_VMDMXSHR       118      4
USEACT_VMDNOFSL        22           04
USEACT_VMDNOINS        22           08
USEACT_VMDPGSPL        84      4
USEACT_VMDQDSPU        22           40
USEACT_VMDRELSH        EC      4
USEACT_VMDSLIST        20      1
USEACT_VMDSSIZE        F4      4
USEACT_VMDSTYPE        23      1
USEACT_VMDTHRCT       11C      4
USEACT_VMDTTIME        24      8
USEACT_VMDUSER         14      8
USEACT_VMDVCSCT        88      4
USEACT_VMDVDISK       114      4
USEACT_VMDVDSCT        8C      4
USEACT_VMDVFOTM        3C      8
USEACT_VMDVFVTM        34      8
USEACT_VMDVOSCT        98      4
USEACT_VMDVSEVM        AC      4
USEACT_VMDVSTVM        B0      4
USEACT_VMDVSUVM        B4      4
USEACT_VMDVTIME        2C      8
USEACT_VMDVTSCT        94      4
USEACT_VMDVUSCT        90      4
USEACT_VMDWSSPR        4C      4
USEACT_VMDX98CT        C8      4

This information is based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001