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

#### MRUSELOF

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRUSELOF Prolog

####

####

     DSECT NAME - USELOF
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRUSELOF
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 4 - User Domain
                        Record 2 - User Logoff Data
     DESCRIPTION - Records a user that has logged off.  Generated for
                   the base VMDBK only.
     NOTE - Alternate VMDBKs of the user that has logged off are
            recorded in MRUSEDTC (Domain 4, Record 6).

    MRUSELOF Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure  284  USELOF              Start of monitor record
      0   0  Character    0  USELOF_MRHDR        record header
      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  USELOF_VMDUSER      USERID
     28  1C  Unsigned     2  USELOF_VMDCPUAD     Processor ID
     30  1E  Bitstring    1  USELOF_VMDMODE      Guest machine mode. This is as
                                                 set for internal use by CP. See
                                                 USELOF_CALMODE for the mode
                                                 'calculated' at.
     31  1F  Bitstring    1  USELOF_CALMODE      Architectural mode of the
                                                 virtual machine
              1... ....      *
              .1.. ....      USELOF_CALMESA      ESA architecture
              ..1. ....      USELOF_CALMXA       XA architecture
              ...1 ....      USELOF_CALM370      370 architecture
              .... 1...      USELOF_CALMXC       XC architecture
              .... .1..      USELOF_CALMESAM     ESA mode machine has entered
                                                 64-bit mode.
              .... ..1.      *
              .... ...1      *
     32  20  Bitstring    1  USELOF_VMDSLIST     Scheduling list that the user is
                                                 in: X'37' = Dispatch List. X'21' =
                                                 Eligible List. X'0B' = Dormant
                                                 List. X'00' = user is not in any
                                                 list.
     33  21  Unsigned     1  USELOF_VMDELIST     Class number (0,1,2,or 3) of the
                                                 scheduling list the user is in
     34  22  Bitstring    1  USELOF_CALFLAG1     Flag byte
              1... ....      *
              .1.. ....      USELOF_VMDQDSPU     This user has the QUICKDSP
                                                 designation, as set or defaulted
                                                 by the SET QUICKDSP command. When
                                                 the user has work to do, it will
                                                 be added to the dispatch list
                                                 immediately without waiting in the
                                                 eligible list.
              ..1. ....      USELOF_CALDIAL      This user is a dialed user
              ...1 ....      USELOF_CALSNA       This user is connected through
                                                 System Network Architecture (SNA)
              .... 1...      USELOF_VMDNOINS     User is prevented from inserting
                                                 any tracks into the minidisk
                                                 cache. (set when SET MDC INS OFF
                                                 command is issued)
              .... .1..      USELOF_VMDNOFSL     No MDC fair share limit applies.
                                                 Set at LOGON if the NOMDCFS option
                                                 is specified on the OPTIONS
                                                 statement in the user's directory.
              .... ..1.      *
              .... ...1      *
     35  23  Bitstring    1  USELOF_VMDSTYPE     Storage type this virtual
                                                 machine resides in. X'00' => V=V.
                                                 X'80' => V=R. X'40' => V=F.
     36  24  Character    8  USELOF_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  USELOF_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  USELOF_VMDVFVTM     Amount of time, in TOD clock
                                                 units, that is consumed by the
                                                 guest using vector instructions
                                                 while in SIE
     60  3C  Character    8  USELOF_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  USELOF_VMDCTPVR     Cardinal count of private
                                                 resident pages in the virtual
                                                 machine. This monitor field is
                                                 actually the sum of VMDCTPVR +
                                                 VMDCTPVG, which includes pages
                                                 above and below the 2GB line. To
                                                 get the count of the resident
                                                 pages below the 2GB line, subtract
                                                 USELOF_VMDCTPVG from
                                                 USELOF_VMDCTPVR.
     72  48  Unsigned     4  USELOF_VMDCTPVL     Cardinal count of locked pages
                                                 in private address spaces
                                                 belonging to this user.
     76  4C  Unsigned     4  USELOF_VMDWSSPR     This user's projected working
                                                 set size. This is the scheduler's
                                                 estimate of the amount of storage
                                                 this user will require to be
                                                 resident as it runs during its
                                                 next stay in the dispatch list. It
                                                 is based upon the user's past
                                                 behavior and in some cases, on the
                                                 behavior of similar types of
                                                 users.
     80  50  Unsigned     4  USELOF_VMDCTXBK     Number of expanded storage
                                                 blocks allocated to a virtual
                                                 machine by CP for paging.
     84  54  Unsigned     4  USELOF_CALXSTOR     Size, in megabytes, of expanded
                                                 storage attached to the user. If
                                                 zero, no expanded storage is
                                                 attached. VMDXSTOR
     88  58  Unsigned     4  USELOF_VMDCTFLT     Count of host segment and page
                                                 faults on guest pages which
                                                 occurred while running this
                                                 virtual CPU. It does not include
                                                 faults on RCP pages.
     92  5C  Unsigned     4  USELOF_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  USELOF_VMDFLREO     Total number of frame list
                                                 reorders for this virtual system's
                                                 private address spaces
    100  64  Unsigned     4  USELOF_VMDCTORF     Total number of referenced
                                                 frames resident when reset was
                                                 done for this virtual system's
                                                 private address spaces
    104  68  Unsigned     4  USELOF_CALCTPGS     Cardinal count of non-preferred
                                                 paging slots for private address
                                                 spaces belonging to this user.
    108  6C  Unsigned     4  USELOF_VMDCTPWT     Count of outstanding paging and
                                                 spooling I/O's for this user
    112  70  Unsigned     4  USELOF_CALCPPGR     Cumulative count of pages read
                                                 from DASD to main storage for this
                                                 user's address spaces while they
                                                 were private.
    116  74  Unsigned     4  USELOF_CALCPPGW     Cumulative count of pages
                                                 written from main storage to DASD
                                                 for this user's address spaces
                                                 while they were private.
    120  78  Unsigned     4  USELOF_VMDCTSPR     Number of times I/O was issued
                                                 for a spool read request
    124  7C  Unsigned     4  USELOF_VMDCTSPW     Number of times I/O was issued
                                                 for a spool write request
    128  80  Unsigned     4  USELOF_VMDPGSPL     Number of pages spooled for this
                                                 user. This includes the pages
                                                 spooled for the virtual reader,
                                                 printer, punch, console, dump, and
                                                 trace files.
    132  84  Unsigned     4  USELOF_VMDVCSCT     Count of start requests to the
                                                 virtual machine console
    136  88  Unsigned     4  USELOF_VMDVDSCT     Cumulative count of virtual I/O
                                                 requests the virtual machine has
                                                 issued to DASD devices
    140  8C  Unsigned     4  USELOF_VMDVUSCT     Count of Start requests to
                                                 virtual Unit Record devices
    144  90  Unsigned     4  USELOF_VMDVTSCT     Count of Start requests to
                                                 virtual channel-to-channel
                                                 adapters
    148  94  Unsigned     4  USELOF_VMDVOSCT     Count of Start requests to
                                                 devices other than console, DASDs,
                                                 CTCAs, and unit records. (see
                                                 USELOF_VMDVCSCT, USELOF_VMDVDSCT,
                                                 USELOF_VMDVUSCT, and
                                                 USELOF_VMDVTSCT)
    152  98  Unsigned     4  USELOF_CALCPPST     Cumulative count of pages stolen
                                                 from this user's address spaces
                                                 while they were private.
    156  9C  Unsigned     4  USELOF_VMDISEVM     Number of times IUCV data was
                                                 successfully transferred by this
                                                 virtual machine. (SENDs and REPLYs
                                                 with RC=0 when this virtual
                                                 machine is the source). Valid only
                                                 in base VMDBK.
    160  A0  Unsigned     4  USELOF_VMDISTVM     Number of times IUCV data was
                                                 successfully transferred to this
                                                 virtual machine. (SENDs and REPLYs
                                                 with RC=0 when this virtual
                                                 machine is the target). Valid only
                                                 in base VMDBK.
    164  A4  Unsigned     4  USELOF_VMDISUVM     Number of times IUCV data was
                                                 NOT successfully transferred by
                                                 this virtual machine. (SENDs and
                                                 REPLYs with RC^=0 when this
                                                 virtual machine is the source).
                                                 Valid only in the base VMDBK.
    168  A8  Unsigned     4  USELOF_VMDVSEVM     Number of times VMCF data was
                                                 successfully transferred by this
                                                 virtual machine. (SENDs SENDXs,
                                                 SEND/RECEIVEs, and REPLYs with
                                                 RC=0 and this virtual machine is
                                                 source.)
    172  AC  Unsigned     4  USELOF_VMDVSTVM     Number of times VMCF data was
                                                 successfully transferred to this
                                                 virtual machine. (SENDs SENDXs,
                                                 SEND/RECEIVEs, and REPLYs with
                                                 RC=0 and this virtual machine is
                                                 target.)
    176  B0  Unsigned     4  USELOF_VMDVSUVM     Number of times VMCF data was
                                                 NOT successfully transferred by
                                                 this virtual machine. (SENDs
                                                 SENDXs, SEND/RECEIVEs, and REPLYs
                                                 with RC^=0 and this virtual
                                                 machine is source.)
    180  B4  Unsigned     4  USELOF_VMDX98CT     Cumulative number of times
                                                 Diagnose X'98' was issued by this
                                                 virtual machine
    184  B8  Unsigned     4  USELOF_CALCPMIG     Cumulative count of pages
                                                 migrated by CP from expanded
                                                 storage to DASD for this user's
                                                 address spaces while they were
                                                 private.
    188  BC  Unsigned     4  USELOF_CALCPXWT     Cumulative count of pages
                                                 written from main storage to
                                                 expanded storage for this user's
                                                 address spaces while they were
                                                 private.
    192  C0  Unsigned     4  USELOF_CALCPXRD     Cumulative count of pages read
                                                 from expanded storage to main
                                                 storage for this user's address
                                                 spaces while they were private.
    196  C4  Unsigned     2  USELOF_VMDASMCT     Cardinal number of non-base
                                                 address spaces owned by this user.
    198  C6  Bitstring    1  USELOF_CALSHARF     Set Share flags
              1... ....      USELOF_VMDMXSHA     Max share is Absolute if ON, Max
                                                 share is Relative if OFF.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      USELOF_VMDLIMTH     Max share is Limithard if ON Max
                                                 share is Limitsoft if OFF
              .... ...1      *
    199  C7  Bitstring    1  USELOF_CALOSTAT     Virtual machine operating status
              1... ....      USELOF_VMDSYSOP     User is primary system operator
              .1.. ....      USELOF_VMDUSRCT     User is counted as being logged
                                                 on
              ..1. ....      *
              ...1 ....      USELOF_VMDFORCE     User is to be logged off. This
                                                 may be requested by CP, a forced
                                                 logoff, or user's logoff command.
              .... 1...      USELOF_VMDUFORC     User is forced to logoff the
                                                 system
              .... .1..      USELOF_VMDDISC      User is running disconnected
              .... ..1.      USELOF_VMDAUTOL     AUTOLOG/XAUTOLOG in progress.
                                                 User has been automatically logged
                                                 on. This bit is set off when the
                                                 user's IPL statement is processed,
                                                 or (if there is no IPL to process)
                                                 when the user enters a LOGON
                                                 command from a terminal to
                                                 RECONNECT.
              .... ...1      USELOF_VMDXAUTO     The original command was
                                                 XAUTOLOG. Valid for the base VMDBK
                                                 only (see USEINT_CALBASE).
    200  C8  Unsigned     4  USELOF_VMDBLKCT     Count of SSCH's issued by
                                                 BLOCKIO system service (includes
                                                 both read and write requests)
    204  CC  Unsigned     4  USELOF_VMDMDCIA     Count of SSCH's avoided due to
                                                 Minidisk Cache read hit
    208  D0  Unsigned     4  USELOF_VMDCOPCT     Number of times this virtual CPU
                                                 had to be redispatched due to a
                                                 crypto operation exception
    212  D4  Unsigned     4  USELOF_VMDCTISO     Number of times ISOLATE occurred
                                                 for spaces owned by this virtual
                                                 system. Valid only in base VMDBK
    216  D8  Unsigned     4  USELOF_VMDRELSH     This 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.
    220  DC  Unsigned     4  USELOF_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.
    224  E0  Unsigned     4  USELOF_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
                                                 USELOF_ASCDEFSZ
    228  E4  Unsigned     4  USELOF_VMDMXRVP     Number of pages reserved for the
                                                 user
    232  E8  Character    8  USELOF_VMDACTNO     User accounting number
    240  F0  Character    8  USELOF_VMDGRPN      RACF ACI group name
    248  F8  Character    8  USELOF_CALTODON     Time at which the user logged on
                                                 for this session. In time-of-day
                                                 (TOD) clock format. To get the
                                                 user's connect time, subtract this
                                                 time value from the time stamp in
                                                 the record header's MRHDRTOD.
    256 100  Unsigned     4  USELOF_VMDVDISK     Count of virtual I/Os to a
                                                 virtual disk in storage.
    260 104  Unsigned     4  USELOF_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 USELOF_VMDMXSHA to determine
                                                 if Max share is absolute or
                                                 relative.
    264 108  Unsigned     4  USELOF_VMDTHRCT     Total number of times this user
                                                 was delayed doing I/O to a
                                                 throttled device
    268 10C  Character    8  USELOF_ASCDEFSZ     Defined storage size in
                                                 addressable bytes, minus one. If
                                                 DEF STOR CONFIG was used to define
                                                 multiple discontiguous extents of
                                                 addressable defined storage, this
                                                 field contains the sum of the
                                                 sizes in bytes of all of the
                                                 individual extents (minus one).
                                                 The minus one notation is used so
                                                 that a total size of 16 Exabytes
                                                 may be represented without
                                                 ambiguity (as
                                                 x'FFFFFFFF_FFFFFFFF').
    268 10C  Character    4  USELOF_CALDEFHI     high four bytes
    272 110  Character    4  USELOF_CALDEFLO     low four bytes
    276 114  Unsigned     4  USELOF_VMDCTPVG     Count of private address space
                                                 resident pages in DPA owned by
                                                 this virtual machine which are >=
                                                 2G. Valid only in base VMDBK.
    280 118  Unsigned     4  USELOF_VMDMVB2G     Number of times page translation
                                                 moved a page on behalf of this us
                                                 user from a frame with address >=
                                                 2GB to one < 2GB. This field is
                                                 only valid in the base VMDBK.
    284 11C  Character    0  USELOF_END

    MRUSELOF Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    MRHDR                   0     20
    MRHDR_END              14      0
    MRHDRDM                 4      1
    MRHDRLEN                0      2
    MRHDRRC                 6      2
    MRHDRTOD                8      8
    MRHDRZER                2      2
    USELOF                  0    284
    USELOF_ASCDEFSZ       10C      8
    USELOF_CALCPMIG        B8      4
    USELOF_CALCPPGR        70      4
    USELOF_CALCPPGW        74      4
    USELOF_CALCPPST        98      4
    USELOF_CALCPXRD        C0      4
    USELOF_CALCPXWT        BC      4
    USELOF_CALCTPGS        68      4
    USELOF_CALDEFHI       10C      4
    USELOF_CALDEFLO       110      4
    USELOF_CALDIAL         22           20
    USELOF_CALFLAG1        22      1
    USELOF_CALMESA         1F           40
    USELOF_CALMESAM        1F           04
    USELOF_CALMODE         1F      1
    USELOF_CALMXA          1F           20
    USELOF_CALMXC          1F           08
    USELOF_CALM370         1F           10
    USELOF_CALOSTAT        C7      1
    USELOF_CALSHARF        C6      1
    USELOF_CALSNA          22           10
    USELOF_CALTODON        F8      8
    USELOF_CALXSTOR        54      4
    USELOF_END            11C      0
    USELOF_MRHDR            0      0
    USELOF_VMDABSSH        DC      4
    USELOF_VMDACTNO        E8      8
    USELOF_VMDASMCT        C4      2
    USELOF_VMDAUTOL        C7           02
    USELOF_VMDBLKCT        C8      4
    USELOF_VMDCOPCT        D0      4
    USELOF_VMDCPUAD        1C      2
    USELOF_VMDCTFLT        58      4
    USELOF_VMDCTISO        D4      4
    USELOF_VMDCTORF        64      4
    USELOF_VMDCTPVG       114      4
    USELOF_VMDCTPVL        48      4
    USELOF_VMDCTPVR        44      4
    USELOF_VMDCTPWT        6C      4
    USELOF_VMDCTSPR        78      4
    USELOF_VMDCTSPW        7C      4
    USELOF_VMDCTVFL        5C      4
    USELOF_VMDCTXBK        50      4
    USELOF_VMDDISC         C7           04
    USELOF_VMDELIST        21      1
    USELOF_VMDFLREO        60      4
    USELOF_VMDFORCE        C7           10
    USELOF_VMDGRPN         F0      8
    USELOF_VMDISEVM        9C      4
    USELOF_VMDISTVM        A0      4
    USELOF_VMDISUVM        A4      4
    USELOF_VMDLIMTH        C6           02
    USELOF_VMDMDCIA        CC      4
    USELOF_VMDMODE         1E      1
    USELOF_VMDMVB2G       118      4
    USELOF_VMDMXRVP        E4      4
    USELOF_VMDMXSHA        C6           80
    USELOF_VMDMXSHR       104      4
    USELOF_VMDNOFSL        22           04
    USELOF_VMDNOINS        22           08
    USELOF_VMDPGSPL        80      4
    USELOF_VMDQDSPU        22           40
    USELOF_VMDRELSH        D8      4
    USELOF_VMDSLIST        20      1
    USELOF_VMDSSIZE        E0      4
    USELOF_VMDSTYPE        23      1
    USELOF_VMDSYSOP        C7           80
    USELOF_VMDTHRCT       108      4
    USELOF_VMDTTIME        24      8
    USELOF_VMDUFORC        C7           08
    USELOF_VMDUSER         14      8
    USELOF_VMDUSRCT        C7           40
    USELOF_VMDVCSCT        84      4
    USELOF_VMDVDISK       100      4
    USELOF_VMDVDSCT        88      4
    USELOF_VMDVFOTM        3C      8
    USELOF_VMDVFVTM        34      8
    USELOF_VMDVOSCT        94      4
    USELOF_VMDVSEVM        A8      4
    USELOF_VMDVSTVM        AC      4
    USELOF_VMDVSUVM        B0      4
    USELOF_VMDVTIME        2C      8
    USELOF_VMDVTSCT        90      4
    USELOF_VMDVUSCT        8C      4
    USELOF_VMDWSSPR        4C      4
    USELOF_VMDXAUTO        C7           01
    USELOF_VMDX98CT        B4      4

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

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002